开源 - Ideal库 - 常用时间转换扩展方法（一）

IT规划师2024-11-07 0:36

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

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

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

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

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

csharp 复制代码 
/// <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位时间戳，即毫秒级时间戳，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，代码如下：

csharp 复制代码 
/// <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，转换失败则返回空，具体代码如下：

csharp 复制代码 
/// <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，转换失败则返回默认日期时间，具体代码如下：

csharp 复制代码 
/// <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，转换失败则返回空，具体代码如下：

csharp 复制代码 
/// <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，转换失败则返回默日期，具体代码如下：

csharp 复制代码 
/// <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，转换失败则返回空，具体代码如下：

csharp 复制代码 
/// <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，转换失败则返回默认时间，具体代码如下：

csharp 复制代码 
/// <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

相关推荐
专业软件系统开发2 小时前
52DH Pro网址导航系统开源版
开源·导航系统源码
说私域3 小时前
“互联网 +”时代商业生态变革：以开源 AI 智能名片链动 2+1 模式 S2B2C 商城小程序为例
人工智能·小程序·开源
love530love7 小时前
【保姆级教程】阿里 Wan2.1-T2V-14B 模型本地部署全流程：从环境配置到视频生成（附避坑指南）
人工智能·windows·python·开源·大模型·github·音视频
HashData酷克数据9 小时前
官宣：Apache Cloudberry (Incubating) 2.0.0 发布！
数据库·开源·apache·cloudberry
心一信息10 小时前
开源网络流量分析利器：tproxy
开源
群联云防护小杜12 小时前
服务器异常磁盘写排查手册 · 已删除文件句柄篇
运维·服务器·nginx·开源·lua
Clownseven13 小时前
Mattermost教程：用Docker搭建自己的开源Slack替代品 (团队聊天)
docker·容器·开源
Rysxt_13 小时前
开源定时器教程：Quartz与XXL-JOB全面对比与实践
开源·定时器
❀͜͡傀儡师13 小时前
Docker部署Drawnix开源白板工具
docker·容器·开源·drawnix
❀͜͡傀儡师13 小时前
Docker部署Lunalytics开源监控工具
docker·容器·开源·lunalytics
热门推荐
012025 年高教社杯全国大学生数学建模竞赛C 题 NIPT 的时点选择与胎儿的异常判定 完整成品思路模型代码分享，全网首发高质量！！！022025年数学建模国赛C题超详细解题思路032025全国大学生数学建模C题保姆级思路模型（持续更新）：NIPT 的时点选择与胎儿的异常判定042025高教社杯国赛数学建模选题建议+初步分析052025国赛B题保姆级教程思路分析 碳化硅外延层厚度的确定06UV安装并设置国内源07奈飞工厂官网，国内Netflix影视在线看|中文网页电脑版入口08KGG转MP3工具|非KGM文件|解密音频09（E题｜AI 辅助智能体测）2025年高教杯全国大学生数学建模国赛解题思路|完整代码论文集合10不再让Windows更新！&Edge游戏助手卸载及关闭自动更新