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

在现代web应用程序中，处理日期和时间是一个常见的需求。无论是记录日志、生成报告还是进行数据分析，正确处理日期和时间对于确保数据的准确性和一致性至关重要。本文将详细介绍如何使用asp.net core和c#构建一个高效的时间日期帮助类，并展示其使用方法。

技术栈

.net 8: 提供强大的api开发框架。

c#: 用于编写高效的业务逻辑。

代码实现

datetimehelper 类

我们创建了一个名为datetimehelper的帮助类，它提供了多种日期时间相关的功能，包括格式化日期时间和调整查询时间范围。

1. 常量定义

首先，我们定义了一些常用的常量，用于表示不同的时间跨度，例如1天、7天、30天等。

namespace mes.core.helpers
{
    /// <summary>
    /// 日期时间帮助类，提供日期时间格式化及查询范围调整功能
    /// </summary>
    public class datetimehelper
    {
        /// <summary>
        /// 日期时间格式：yyyy-mm-dd hh:mm:ss
        /// </summary>
        public const string datetimeformat = @"yyyy-mm-dd hh:mm:ss";

        /// <summary>
        /// 1天的时间跨度
        /// </summary>
        public const int day1 = 1;

        /// <summary>
        /// 7天的时间跨度
        /// </summary>
        public const int day7 = 7;

        /// <summary>
        /// 15天的时间跨度
        /// </summary>
        public const int day15 = 15;

        /// <summary>
        /// 30天的时间跨度
        /// </summary>
        public const int day30 = 30;

        /// <summary>
        /// 60天的时间跨度
        /// </summary>
        public const int day60 = 60;

        /// <summary>
        /// 90天的时间跨度
        /// </summary>
        public const int day90 = 90;

2. 获取当前时间

getthisdatetime方法用于获取当前时间并将其格式化为指定的格式。

        /// <summary>
        /// 获取当前时间并格式化为指定格式
        /// </summary>
        /// <returns>格式化后的当前时间</returns>
        public static datetime getthisdatetime()
        {
            return convert.todatetime(datetime.now.tostring(datetimeformat));
        }

3. 调整查询时间范围

adjustqueryrange方法根据提供的开始时间和结束时间调整查询范围，以确保查询结果在合理的范围内。

        /// <summary>
        /// 根据提供的开始时间和结束时间调整查询范围
        /// </summary>
        /// <param name="start_time">开始时间</param>
        /// <param name="end_time">结束时间</param>
        /// <param name="timehorizon">时间范围，默认30天</param>
        /// <returns>包含调整后的开始和结束时间的元组</returns>
        public static tuple<datetime, datetime> 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);
        }
    }
}

调用示例

以下是如何调用adjustqueryrange方法的示例：

// 定义开始时间和结束时间
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}");