69 lines
2.7 KiB
C#
69 lines
2.7 KiB
C#
|
using JiShe.CollectBus.Common.Enums;
|
|||
|
|
using System;
|
|||
|
|
using System.Collections.Generic;
|
|||
|
|
using System.Linq;
|
|||
|
|
using System.Text;
|
|||
|
|
using System.Threading.Tasks;
|
|||
|
|
|
|||
|
|
namespace JiShe.CollectBus.Common.Helpers
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 时间戳帮助类
|
|||
|
|
/// </summary>
|
|||
|
|
public static class TimestampHelper
|
|||
|
|
{
|
|||
|
|
private static readonly long UnixEpochTicks = new DateTimeOffset(1970, 1, 1, 0, 0, 0, TimeSpan.Zero).Ticks;
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取当前 DateTimeOffset 距离 Unix 纪元（1970-01-01）的微秒数
|
|||
|
|
/// </summary>
|
|||
|
|
public static long ToUnixTimeMicroseconds(this DateTimeOffset dateTimeOffset)
|
|||
|
|
{
|
|||
|
|
// Ticks 单位是 100 纳秒，转换为微秒需除以 10
|
|||
|
|
long elapsedTicks = dateTimeOffset.Ticks - UnixEpochTicks;
|
|||
|
|
return elapsedTicks / 10; // 1 微秒 = 1000 纳秒 = 10 Ticks
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取当前 DateTimeOffset 距离 Unix 纪元（1970-01-01）的纳秒数
|
|||
|
|
/// </summary>
|
|||
|
|
public static long ToUnixTimeNanoseconds(this DateTimeOffset dateTimeOffset)
|
|||
|
|
{
|
|||
|
|
long nanoseconds = (dateTimeOffset.Ticks - UnixEpochTicks) * 100;
|
|||
|
|
return nanoseconds;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 将 long 类型时间戳转换为 DateTime（UTC）
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="timestamp">时间戳数值</param>
|
|||
|
|
/// <param name="unit">时间戳单位</param>
|
|||
|
|
public static DateTime ConvertToDateTime(long timestamp, TimestampUnit unit = TimestampUnit.Milliseconds)
|
|||
|
|
{
|
|||
|
|
long ticks = unit switch
|
|||
|
|
{
|
|||
|
|
TimestampUnit.Seconds => checked(timestamp * TimeSpan.TicksPerSecond),
|
|||
|
|
TimestampUnit.Milliseconds => checked(timestamp * TimeSpan.TicksPerMillisecond),
|
|||
|
|
TimestampUnit.Microseconds => checked(timestamp * 10), // 1微秒 = 10 Ticks（100纳秒）
|
|||
|
|
TimestampUnit.Nanoseconds => checked(timestamp / 100),// 1 Tick = 100纳秒
|
|||
|
|
_ => throw new ArgumentException("无效的时间单位", nameof(unit))
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
try
|
|||
|
|
{
|
|||
|
|
DateTime result = new DateTime(UnixEpochTicks + ticks, DateTimeKind.Utc);
|
|||
|
|
// 校验结果是否在 DateTime 合法范围内（0001-01-01 至 9999-12-31）
|
|||
|
|
if (result < DateTime.MinValue || result > DateTime.MaxValue)
|
|||
|
|
{
|
|||
|
|
throw new ArgumentOutOfRangeException(nameof(timestamp), "时间戳超出 DateTime 范围");
|
|||
|
|
}
|
|||
|
|
return result;
|
|||
|
|
}
|
|||
|
|
catch (ArgumentOutOfRangeException ex)
|
|||
|
|
{
|
|||
|
|
throw new ArgumentOutOfRangeException("时间戳无效", ex);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|