使用.NET8構建一個高效的時間日期幫助類

更新時間：2025年01月28日 10:23:08 作者：黃同學real

在現(xiàn)代Web應用程序中,處理日期和時間是一個常見的需求,本文將為大家介紹如何使用ASP.NET?Core和C#構建一個高效的時間日期幫助類,有需要的可以參考下

在現(xiàn)代Web應用程序中，處理日期和時間是一個常見的需求。無論是記錄日志、生成報告還是進行數(shù)據(jù)分析，正確處理日期和時間對于確保數(shù)據(jù)的準確性和一致性至關重要。本文將詳細介紹如何使用ASP.NET Core和C#構建一個高效的時間日期幫助類，并展示其使用方法。

技術棧

.NET 8: 提供強大的API開發(fā)框架。

C#: 用于編寫高效的業(yè)務邏輯。

代碼實現(xiàn)

DateTimeHelper 類

我們創(chuàng)建了一個名為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方法根據(jù)提供的開始時間和結束時間調整查詢范圍，以確保查詢結果在合理的范圍內。

        /// <summary>
        /// 根據(jù)提供的開始時間和結束時間調整查詢范圍
        /// </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}");