摘要

从事软件开发这么多年，平时也积累了一些方便自己快速开发的帮助类，一直在想着以什么方式分享出来，因此有了这个系列文章，后面我将以《开源-Ideal库》系列文章分享一些我认为比较成熟、比较方便、比较好的代码，如果感觉有借鉴的地方可以集成到自己的公共代码库中，同时我也会以Nuget包的方式发布出来，以供直接下载使用。

从事软件开发这么多年，平时也积累了一些方便自己快速开发的帮助类，一直在想着以什么方式分享出来，因此有了这个系列文章，后面我将以《开源-Ideal库》系列文章分享一些我认为比较成熟、比较方便、比较好的代码，如果感觉有借鉴的地方可以集成到自己的公共代码库中，同时我也会以Nuget包的方式发布出来，以供直接下载使用。

主要包括：公共、文档、ORM、SqlSugar、定时任务、Redis、Mqtt、SignalR等库封装，后面可能还会适当删减。

今天我们将分享公共库中关于时间转换的相关封装，主要是关于本地与UTC的日期、时间与时间戳和字符串之间的相互转换。

01、日期时间转时间戳（秒）

该方法是把日期时间DateTime转成10位时间戳，即秒级时间戳，代码如下：

/// <summary> /// 日期时间转时间戳（秒） /// </summary> /// <param name="dateTime">日期时间</param> /// <returns>时间戳（秒）</returns> public static long ToUnixTimestampBySeconds(this DateTime dateTime) {     var dto = new DateTimeOffset(dateTime);     return dto.ToUnixTimeSeconds(); } 

02、日期时间转时间戳（毫秒）

该方法是把日期时间DateTime转为13位时间戳，即毫秒级时间戳，代码如下：

/// <summary> /// 日期时间转时间戳（毫秒） /// </summary>  /// <param name="dateTime">日期时间</param> /// <returns>时间戳（毫秒）</returns> public static long ToUnixTimestampByMilliseconds(this DateTime dateTime) {     var dto = new DateTimeOffset(dateTime);     return dto.ToUnixTimeMilliseconds(); } 

03、时间戳（秒）转本地日期时间

该方法是把10位秒级时间戳转为本地日期时间DateTime，代码如下：

/// <summary> /// 时间戳（秒）转本地日期时间 /// </summary> /// <param name="timestamp">时间戳（秒）</param> /// <returns>本地日期时间</returns> public static DateTime ToLocalTimeDateTimeBySeconds(this long timestamp) {     var dto = DateTimeOffset.FromUnixTimeSeconds(timestamp);     return dto.ToLocalTime().DateTime; } 

04、时间戳（毫秒）转本地日期时间

该方法是把13位毫秒级时间戳转为本地日期时间DateTime，代码如下：

/// <summary> /// 时间戳（毫秒）转本地日期时间 /// </summary>  /// <param name="timestamp">时间戳（毫秒）</param> /// <returns>本地日期时间</returns> public static DateTime ToLocalTimeDateTimeByMilliseconds(this long timestamp) {     var dto = DateTimeOffset.FromUnixTimeMilliseconds(timestamp);     return dto.ToLocalTime().DateTime; } 

05、时间戳（秒）转UTC日期时间

该方法是把10位秒级时间戳转为UTC日期时间DateTime，代码如下：

/// <summary> /// 时间戳（秒）转UTC日期时间 /// </summary>  /// <param name="timestamp">时间戳（秒）</param> /// <returns>UTC日期时间</returns> public static DateTime ToUniversalTimeDateTimeBySeconds(this long timestamp) {     var dto = DateTimeOffset.FromUnixTimeSeconds(timestamp);     return dto.ToUniversalTime().DateTime; } 

06、时间戳（毫秒）转UTC日期时间

该方法是把13位毫秒级时间戳转为UTC日期时间DateTime，代码如下：

/// <summary> /// 时间戳（毫秒）转UTC日期时间 /// </summary>  /// <param name="timestamp">时间戳（毫秒）</param> /// <returns>UTC日期时间</returns> public static DateTime ToUniversalTimeDateTimeByMilliseconds(this long timestamp) {     var dto = DateTimeOffset.FromUnixTimeMilliseconds(timestamp);     return dto.ToUniversalTime().DateTime; } 

07、时间戳（秒）转本地日期

该方法是把10位秒级时间戳转为本地日期DateOnly，代码如下：

/// <summary> /// 时间戳（秒）转本地日期 /// </summary>  /// <param name="timestamp">时间戳（秒）</param> /// <returns>本地日期</returns> public static DateOnly ToLocalTimeDateBySeconds(this long timestamp) {     var dt = timestamp.ToLocalTimeDateTimeBySeconds();     return DateOnly.FromDateTime(dt); } 

08、时间戳（毫秒）转本地日期

该方法是把13位毫秒级时间戳转为本地日期DateOnly，代码如下：

/// <summary> /// 时间戳（毫秒）转本地日期 /// </summary>  /// <param name="timestamp">时间戳（毫秒）</param> /// <returns>本地日期</returns> public static DateOnly ToLocalTimeDateByMilliseconds(this long timestamp) {     var dt = timestamp.ToLocalTimeDateTimeByMilliseconds();     return DateOnly.FromDateTime(dt); } 

09、时间戳（秒）转UTC日期

该方法是把10位秒级时间戳转为UTC日期DateOnly，代码如下：

/// <summary> /// 时间戳（秒）转UTC日期 /// </summary>  /// <param name="timestamp">时间戳（秒）</param> /// <returns>UTC日期</returns> public static DateOnly ToUniversalTimeDateBySeconds(this long timestamp) {     var dt = timestamp.ToUniversalTimeDateTimeBySeconds();     return DateOnly.FromDateTime(dt); } 

10、时间戳（毫秒）转UTC日期

该方法是把13位毫秒级时间戳转为UTC日期DateOnly，代码如下：

/// <summary> /// 时间戳（毫秒）转UTC日期 /// </summary>  /// <param name="timestamp">时间戳（毫秒）</param> /// <returns>UTC日期</returns> public static DateOnly ToUniversalTimeDateByMilliseconds(this long timestamp) {     var dt = timestamp.ToUniversalTimeDateTimeByMilliseconds();     return DateOnly.FromDateTime(dt); } 

11、时间戳（秒）转本地时间

该方法是把10位秒级时间戳转为本地时间TimeOnly，代码如下：

/// <summary> /// 时间戳（秒）转本地时间 /// </summary>  /// <param name="timestamp">时间戳（秒）</param> /// <returns>本地时间</returns> public static TimeOnly ToLocalTimeTimeBySeconds(this long timestamp) {     var dt = timestamp.ToLocalTimeDateTimeBySeconds();     return TimeOnly.FromDateTime(dt); } 

12、时间戳（毫秒）转本地时间

该方法是把13位毫秒级时间戳转为本地时间TimeOnly，代码如下：

/// <summary> /// 时间戳（毫秒）转本地时间 /// </summary>  /// <param name="timestamp">时间戳（毫秒）</param> /// <returns>本地时间</returns> public static TimeOnly ToLocalTimeTimeByMilliseconds(this long timestamp) {     var dt = timestamp.ToLocalTimeDateTimeByMilliseconds();     return TimeOnly.FromDateTime(dt); } 

13、时间戳（秒）转UTC时间

该方法是把10位秒级时间戳转为UTC时间TimeOnly，代码如下：

/// <summary> /// 时间戳（秒）转UTC时间 /// </summary>  /// <param name="timestamp">时间戳（秒）</param> /// <returns>UTC时间</returns> public static TimeOnly ToUniversalTimeTimeBySeconds(this long timestamp) {     var dt = timestamp.ToUniversalTimeDateTimeBySeconds();     return TimeOnly.FromDateTime(dt); } 

14、时间戳（毫秒）转UTC时间

该方法是把13位毫秒级时间戳转为UTC时间TimeOnly，代码如下：

/// <summary> /// 时间戳（毫秒）转UTC时间 /// </summary>  /// <param name="timestamp">时间戳（毫秒）</param> /// <returns>UTC时间</returns> public static TimeOnly ToUniversalTimeTimeByMilliseconds(this long timestamp) {     var dt = timestamp.ToUniversalTimeDateTimeByMilliseconds();     return TimeOnly.FromDateTime(dt); } 

15、字符串转日期时间，转换失败则返回空

该方法是把字符串转为日期时间DateTime，转换失败则返回空，具体代码如下：

/// <summary> /// 字符串转日期时间，转换失败则返回空 /// </summary> /// <param name="source">需转换的字符串</param> /// <returns>日期时间</returns> public static DateTime? ToDateTime(this string source) {     if (DateTime.TryParse(source, CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))     {         return date;     }     return default; } 

16、字符串转日期时间，转换失败则返回默认日期时间

该方法是把字符串转为日期时间DateTime，转换失败则返回默认日期时间，具体代码如下：

/// <summary> /// 字符串转日期时间，转换失败则返回默认值 /// </summary> /// <param name="source">需转换的字符串</param> /// <param name="dateTime">默认日期时间</param> /// <returns>日期时间</returns> public static DateTime ToDateTimeOrDefault(this string source, DateTime dateTime) {     if (DateTime.TryParse(source, CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))     {         return date;     }     return dateTime; } 

17、字符串转日期，转换失败则返回空

该方法是把字符串转为日期DateOnly，转换失败则返回空，具体代码如下：

/// <summary> /// 字符串转日期，转换失败则返回空 /// </summary> /// <param name="source">需转换的字符串</param> /// <returns>日期</returns> public static DateOnly? ToDateOnly(this string source) {     if (DateOnly.TryParse(source, CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))     {         return date;     }     return default; } 

18、字符串转日期，转换失败则返回默认日期

该方法是把字符串转为日期DateOnly，转换失败则返回默日期，具体代码如下：

/// <summary> /// 字符串转日期，转换失败则返回默认日期 /// </summary> /// <param name="source">需转换的字符串</param> /// <param name="dateOnly">默认日期</param> /// <returns>日期</returns> public static DateOnly ToDateOnlyOrDefault(this string source, DateOnly dateOnly) {     if (DateOnly.TryParse(source, CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))     {         return date;     }     return dateOnly; } 

19、字符串转时间，转换失败则返回空

该方法是把字符串转为日期TimeOnly，转换失败则返回空，具体代码如下：

/// <summary> /// 字符串转时间，转换失败则返回空 /// </summary> /// <param name="source">需转换的字符串</param> /// <returns>时间</returns> public static TimeOnly? ToTimeOnly(this string source) {     if (TimeOnly.TryParse(source, CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))     {         return date;     }     return default; } 

20、字符串转时间，转换失败则返回默认时间

该方法是把字符串转为日期TimeOnly，转换失败则返回默认时间，具体代码如下：

/// <summary> /// 字符串转时间，转换失败则返回默认时间 /// </summary> /// <param name="source">需转换的字符串</param> /// <param name="timeOnly">默认时间</param> /// <returns>时间</returns> public static TimeOnly ToTimeOnlyOrDefault(this string source, TimeOnly timeOnly) {     if (TimeOnly.TryParse(source, CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))     {         return date;     }     return timeOnly; } 

稍晚些时候我会把库上传至Nuget上，大家可以搜索Ideal.Core.Common直接使用。

注：测试方法代码以及示例源码都已经上传至代码库，有兴趣的可以看看。https://gitee.com/hugogoos/Ideal