//******************************************************************************************************
// DateTimeRounding.cs - Gbtc
//
// Copyright © 2016, Grid Protection Alliance. All Rights Reserved.
//
// Licensed to the Grid Protection Alliance (GPA) under one or more contributor license agreements. See
// the NOTICE file distributed with this work for additional information regarding copyright ownership.
// The GPA licenses this file to you under the MIT License (MIT), the "License"; you may
// not use this file except in compliance with the License. You may obtain a copy of the License at:
//
// http://www.opensource.org/licenses/MIT
//
// Unless agreed to in writing, the subject software distributed under the License is distributed on an
// "AS-IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Refer to the
// License for the specific language governing permissions and limitations.
//
// Code Modification History:
// ----------------------------------------------------------------------------------------------------
// 11/17/2016 - Steven E. Chisholm
// Generated original version of source code.
//
//******************************************************************************************************
using System;
using System.Collections.Generic;
namespace GSF
{
///
/// Responsible for rounding measurements to their nearest time bucket.
/// For example: a 30 sample per second value of 5.1666766 would round to 5.1666667
///
public class DateTimeRounding
{
private readonly int m_ticksPerInterval;
private readonly int m_ticksPerHalfInterval;
private readonly int[] m_distribution;
private DateTimeRounding(int samplesPerSecond)
{
m_distribution = new int[samplesPerSecond + 1];
double ticksPerInterval = (TimeSpan.TicksPerSecond / (double)samplesPerSecond);
for (int i = 0; i < samplesPerSecond; i++)
m_distribution[i] = (int)(Math.Round(i * ticksPerInterval));
m_distribution[samplesPerSecond] = (int)TimeSpan.TicksPerSecond;
m_ticksPerInterval = (int)(ticksPerInterval);
m_ticksPerHalfInterval = m_ticksPerInterval / 2;
}
///
/// Rounds the specified timestamp
///
///
///
public DateTime Round(DateTime time)
{
long ticks = time.Ticks;
//Time rounded down to nearest second
long ticksTruncatedToSeconds = ticks - ticks % TimeSpan.TicksPerSecond;
//Compute the frame by taking the ticks after a second, adding 1/2 the interval value, then integer rounding
int frame = (int)(ticks - ticksTruncatedToSeconds + m_ticksPerHalfInterval) / m_ticksPerInterval;
return new DateTime(ticksTruncatedToSeconds + m_distribution[frame]);
}
///
/// Rounds the specified timestamp
///
///
///
public long Round(long time)
{
long baseTicks = time - time % TimeSpan.TicksPerSecond;
int frame = (int)(time - baseTicks + m_ticksPerHalfInterval) / m_ticksPerInterval;
return baseTicks + m_distribution[frame];
}
private static Dictionary s_cache = new Dictionary();
///
/// Creates a
///
/// the samples per second for the rounding algorithm
///
public static DateTimeRounding Create(int samplesPerSecond)
{
lock (s_cache)
{
DateTimeRounding rv;
if (!s_cache.TryGetValue(samplesPerSecond, out rv))
{
rv = new DateTimeRounding(samplesPerSecond);
s_cache.Add(samplesPerSecond, rv);
}
return rv;
}
}
}
}