当前位置:

首页 > 编程开发 > 使用.NET8构建一个高效的时间日期帮助类

使用.NET8构建一个高效的时间日期帮助类

在如今的Web开发中,处理日期和时间几乎无处不在——日志记录、报表生成、数据分析,哪一样都离不开它。要是搞不对时区、格式或者查询范围,数据就很容易出岔子。所以,一个靠谱的日期时间帮助类,能省去不少重复劳动,也让代码更清爽。下面我们就基于.NET 8和C#,手把手构建一个这样的工具类,并看看怎么用起来

本文目录

    在如今的Web开发中,处理日期和时间几乎无处不在——日志记录、报表生成、数据分析,哪一样都离不开它。要是搞不对时区、格式或者查询范围,数据就很容易出岔子。所以,一个靠谱的日期时间帮助类,能省去不少重复劳动,也让代码更清爽。下面我们就基于.NET 8和C#,手把手构建一个这样的工具类,并看看怎么用起来。

    技术栈

    整个实现依赖两个核心组件:

    • .NET 8:提供现代化的API开发框架,性能与稳定性都有保障。
    • C#:用来编写简洁且高效的业务逻辑,语言本身对日期时间操作支持很完善。

    代码实现

    DateTimeHelper 类

    我们封装了一个名为 DateTimeHelper 的帮助类,集中处理日期时间的格式化、当前时间获取,以及查询时间范围的自动调整。下面是具体实现。

    1. 常量定义

    先把常用的时间跨度定义成常量,这样后续用起来更直观,也方便维护。比如1天、7天、30天、60天、90天,都是业务中很常见的查询范围。

    namespace MES.Core.Helpers
    {
        /// 
        /// 日期时间帮助类,提供日期时间格式化及查询范围调整功能
        /// 
        public class DateTimeHelper
        {
            /// 
            /// 日期时间格式:yyyy-MM-dd HH:mm:ss
            /// 
            public const string DateTimeFormat = @"yyyy-MM-dd HH:mm:ss";
    
            /// 
            /// 1天的时间跨度
            /// 
            public const int Day1 = 1;
    
            /// 
            /// 7天的时间跨度
            /// 
            public const int Day7 = 7;
    
            /// 
            /// 15天的时间跨度
            /// 
            public const int Day15 = 15;
    
            /// 
            /// 30天的时间跨度
            /// 
            public const int Day30 = 30;
    
            /// 
            /// 60天的时间跨度
            /// 
            public const int Day60 = 60;
    
            /// 
            /// 90天的时间跨度
            /// 
            public const int Day90 = 90;
    

    2. 获取当前时间

    GetThisDateTime 方法做的事情很简单:拿到当前系统时间,然后按我们定义的 DateTimeFormat 格式(yyyy-MM-dd HH:mm:ss)做一次格式化后再转回 DateTime 类型。这样就能保证返回的时间字符串精度统一,避免出现毫秒或时区不一致的问题。

            /// 
            /// 获取当前时间并格式化为指定格式
            /// 
            /// 格式化后的当前时间
            public static DateTime GetThisDateTime()
            {
                return Convert.ToDateTime(DateTime.Now.ToString(DateTimeFormat));
            }
    

    3. 调整查询时间范围

    AdjustQueryRange 方法是最核心的部分。它接收可选的开始时间和结束时间,以及一个时间跨度参数(默认30天),然后自动调整,让查询区间既合理又不越界。逻辑分几种情况:

    • 如果只传了开始时间,就把结束时间设为开始时间加上指定跨度,同时确保不超过当前时间加1天。
    • 如果只传了结束时间,就把开始时间设为结束时间减去指定跨度。
    • 如果两个都传了,就按传入的值,但保证结束时间不超过开始时间加上跨度。
    • 如果两个都没传,就用默认值:开始时间为当前时间减去跨度,结束时间为当前时间加1天。

    最后返回一个 Tuple,方便解构使用。

            /// 
            /// 根据提供的开始时间和结束时间调整查询范围
            /// 
            /// 开始时间
            /// 结束时间
            /// 时间范围,默认30天
            /// 包含调整后的开始和结束时间的元组
            public static Tuple AdjustQueryRange(DateTime? start_time, DateTime? end_time, int timeHorizon = Day30)
            {
                // 默认设置开始时间为当前时间减去指定时间范围(默认30天)
                DateTime startTime = DateTime.Now.AddDays(-(timeHorizon - 1));
                // 默认设置结束时间为当前时间加1天
                DateTime endTime = DateTime.Now.AddDays(1);
    
                // 如果仅提供了开始时间
                if (start_time != null && end_time == null)
                {
                    startTime = (DateTime)start_time;
                    // 确保结束时间在开始时间之后且不超过指定时间范围
                    if (startTime.AddDays(timeHorizon) < endTime) endTime = startTime.AddDays(timeHorizon);
                }
                // 如果仅提供了结束时间
                if (start_time == null && end_time != null)
                {
                    endTime = (DateTime)end_time;
                    // 确保开始时间在结束时间之前且不超过指定时间范围
                    if (endTime.AddDays(-timeHorizon) < startTime) startTime = endTime.AddDays(-timeHorizon);
                }
                // 如果提供了开始和结束时间
                if (start_time != null && end_time != null)
                {
                    startTime = (DateTime)start_time;
                    endTime = (DateTime)end_time;
                    // 确保结束时间在开始时间之后且不超过指定时间范围
                    if (startTime.AddDays(timeHorizon) < endTime) endTime = startTime.AddDays(timeHorizon);
                }
    
                // 返回调整后的开始和结束时间
                return Tuple.Create(startTime, endTime);
            }
        }
    }
    

    调用示例

    来看看实际怎么用。假设我们想查2023年10月1日之后30天内的数据,但没给结束时间,那么调用 AdjustQueryRange 就会自动把结束时间推到10月31日(2023-10-01 + 30天)。代码写起来很简洁:

    // 定义开始时间和结束时间
    DateTime? startTime = new DateTime(2023, 10, 1);
    DateTime? endTime = null;
    
    // 调用方法调整时间范围
    var (adjustStartTime, adjustEndTime) = DateTimeHelper.AdjustQueryRange(startTime, endTime, DateTimeHelper.Day30);
    Console.WriteLine($"Adjusted Start Time: {adjustStartTime}");
    Console.WriteLine($"Adjusted End Time: {adjustEndTime}");
    

    输出结果会显示 Adjusted Start Time: 2023-10-01 00:00:00 和 Adjusted End Time: 2023-10-31 00:00:00,完全符合预期。

    总结

    通过这个 DateTimeHelper,我们实现了两个关键功能:统一的时间格式化和灵活的查询范围自动调整。它把常见的日期时间操作收拢到一个类里,不仅让业务代码更干净,也避免了各处分散处理带来的格式不一致和边界条件遗漏。对于需要频繁处理时间区间的查询场景(比如报表、日志搜索),这个工具类能显著提升开发效率和代码可维护性。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    rust-analyzer v0.3.3121 稳定版修复怎样影响常量与条件属性?
    rust-analyzer v0.3.3121 稳定版修复怎样影响常量与条件属性?

    rust-analyzer v0.3.3121 稳定版修复大 u128 转为负浮点数的问题,并为 target_os 与 target_env 补齐 macOS、iOS、Android 和 musl 相关候选。

    llama.cpp b12464 的 Q8_0 优化对应哪条 OpenCL 路径?
    llama.cpp b12464 的 Q8_0 优化对应哪条 OpenCL 路径?

    llama.cpp b12464 为 OpenCL A7 增加 Q8_0 非 MoE 二进制内核,解释 Adreno X1、矩阵乘法和适用条件。

    llama.cpp b12463 的视觉位置嵌入修复影响哪些输入?
    llama.cpp b12463 的视觉位置嵌入修复影响哪些输入?

    llama.cpp b12463 修正 Muse Glimmer 视觉编码器缩放位置嵌入时的坐标顺序,使其与训练一致,解释非方形图像为何更能体现差异。

    llama.cpp b12458的YuE2-3B支持有哪些使用边界
    llama.cpp b12458的YuE2-3B支持有哪些使用边界

    llama.cpp b12458加入YuE2-3B,修正流式生成,并按序列保存采样分数。

    Ducter 0.0.67 如何理解任务消息时机与代理记录读取
    Ducter 0.0.67 如何理解任务消息时机与代理记录读取

    Ducter 0.0.67 区分运行中引导与当前一轮后的补充消息,同时把其他代理记录的读取交给用户主动触发。两项变化分别影响任务执行时机和背景信息来源。

    llama.cpp b12441/b12442/b12448/b12449/b12451/b12452/b12453/b12455/b12456 对比?
    llama.cpp b12441/b12442/b12448/b12449/b12451/b12452/b12453/b12455/b12456 对比?

    llama.cpp b12441、b12442、b12448、b12449、b12451、b12452、b12453、b12455、b12456 均为预发布,涉及后端、聊天模板、设备参数、界面与音频,按场景对应各构建。

    ChatGPT for Academic Researchers如何看待下一轮名额和试点研究结果
    ChatGPT for Academic Researchers如何看待下一轮名额和试点研究结果

    ChatGPT for Academic Researchers 的五万份资助面向下一轮合格申请,全计划二十万人是长期覆盖目标。试点调查另有独立样本与证据口径。

    llama.cpp b12457 的 OpenCL A7 内核有哪些适用条件?
    llama.cpp b12457 的 OpenCL A7 内核有哪些适用条件?

    llama.cpp b12457 为 OpenCL 的 A7 路径增加 Q4_K 非 MoE 二进制内核,说明后端、量化及模型执行路径的适用范围。

    ChatGPT for Healthcare的软件权限与提供范围怎样判断
    ChatGPT for Healthcare的软件权限与提供范围怎样判断

    ChatGPT for Healthcare 将代理、搜索和医疗插件放在同一产品体系中。开通资格与组织设置决定成员能看到哪些工具。

    GitHub MCP Server v2.2.0 的技能、自动化与告警分别改变了什么?
    GitHub MCP Server v2.2.0 的技能、自动化与告警分别改变了什么?

    GitHub MCP Server v2.2.0 提供可选的过滤技能目录、代理自动化工具和秘密扫描告警隐藏参数。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。