// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。 // // 本项目主要遵循 MIT 许可证和 Apache 许可证(版本 2.0)进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。 // // 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动!任何基于本项目二次开发而产生的一切法律纠纷和责任,我们不承担任何责任! namespace Admin.NET.Core; /// /// 时间帮助类 /// public class DateTimeUtil { public readonly DateTime Date; private DateTimeUtil(TimeSpan timeSpan = default) { Date = DateTime.Now.AddTicks(timeSpan.Ticks); } private DateTimeUtil(DateTime time) { Date = time; } /// /// 实例化类 /// /// /// public static DateTimeUtil Init(TimeSpan timeSpan = default) { return new DateTimeUtil(timeSpan); } /// /// 实例化类 /// /// /// public static DateTimeUtil Init(DateTime time) { return new DateTimeUtil(time); } /// /// 根据unix时间戳的长度自动判断是秒还是以毫秒为单位 /// /// /// public static DateTime ConvertUnixTime(long unixTime) { // 判断时间戳长度 bool isMilliseconds = unixTime > 9999999999; if (isMilliseconds) { return DateTimeOffset.FromUnixTimeMilliseconds(unixTime).ToLocalTime().DateTime; } else { return DateTimeOffset.FromUnixTimeSeconds(unixTime).ToLocalTime().DateTime; } } /// /// 获取开始时间 /// /// /// /// public static DateTime GetBeginTime(DateTime? dateTime, int days = 0) { return dateTime == DateTime.MinValue || dateTime == null ? DateTime.Now.AddDays(days) : (DateTime)dateTime; } /// /// 时间戳转本地时间-时间戳精确到秒 /// public static DateTime ToLocalTimeDateBySeconds(long unix) { return DateTimeOffset.FromUnixTimeSeconds(unix).ToLocalTime().DateTime; } /// /// 时间转时间戳Unix-时间戳精确到秒 /// public static long ToUnixTimestampBySeconds(DateTime dt) { return new DateTimeOffset(dt).ToUnixTimeSeconds(); } /// /// 时间戳转本地时间-时间戳精确到毫秒 /// public static DateTime ToLocalTimeDateByMilliseconds(long unix) { return DateTimeOffset.FromUnixTimeMilliseconds(unix).ToLocalTime().DateTime; } /// /// 时间转时间戳Unix-时间戳精确到毫秒 /// public static long ToUnixTimestampByMilliseconds(DateTime dt) { return new DateTimeOffset(dt).ToUnixTimeMilliseconds(); } /// /// 毫秒转天时分秒 /// /// TotalMilliseconds /// 是否简化显示 /// public static string FormatTime(long ms, bool isSimplify = false) { int ss = 1000; int mi = ss * 60; int hh = mi * 60; int dd = hh * 24; long day = ms / dd; long hour = (ms - day * dd) / hh; long minute = (ms - day * dd - hour * hh) / mi; long second = (ms - day * dd - hour * hh - minute * mi) / ss; //long milliSecond = ms - day * dd - hour * hh - minute * mi - second * ss; string sDay = day < 10 ? "0" + day : "" + day; //天 string sHour = hour < 10 ? "0" + hour : "" + hour;//小时 string sMinute = minute < 10 ? "0" + minute : "" + minute;//分钟 string sSecond = second < 10 ? "0" + second : "" + second;//秒 //string sMilliSecond = milliSecond < 10 ? "0" + milliSecond : "" + milliSecond;//毫秒 //sMilliSecond = milliSecond < 100 ? "0" + sMilliSecond : "" + sMilliSecond; if (!isSimplify) return $"{sDay} 天 {sHour} 小时 {sMinute} 分 {sSecond} 秒"; else { string result = string.Empty; if (day > 0) result = $"{sDay}天"; if (hour > 0) result = $"{result}{sHour}小时"; if (minute > 0) result = $"{result}{sMinute}分"; if (!result.IsNullOrEmpty()) result = $"{result}{sSecond}秒"; else result = $"{sSecond}秒"; return result; } } /// /// 获取unix时间戳 /// /// /// public static long GetUnixTimeStamp(DateTime dt) { return ((DateTimeOffset)dt).ToUnixTimeMilliseconds(); } /// /// 获取日期天的最小时间 /// /// /// public static DateTime GetDayMinDate(DateTime dt) { return new DateTime(dt.Year, dt.Month, dt.Day, 0, 0, 0); } /// /// 获取日期天的最大时间 /// /// /// public static DateTime GetDayMaxDate(DateTime dt) { return new DateTime(dt.Year, dt.Month, dt.Day, 23, 59, 59); } /// /// 根据日期是否在当前年份来格式化日期 /// /// /// public static string FormatDateTime(DateTime? dt) { return dt == null ? string.Empty : dt.Value.ToString(dt.Value.Year == DateTime.Now.Year ? "MM-dd HH:mm" : "yyyy-MM-dd HH:mm"); } /// /// 获取日期范围00:00:00 - 23:59:59 /// /// public static List GetTodayTimeList(DateTime time) { return new List { Convert.ToDateTime(time.ToString("D")), Convert.ToDateTime(time.AddDays(1).ToString("D")).AddSeconds(-1) }; } /// /// 获取星期几 /// /// /// public static string GetWeekByDate(DateTime dt) { var day = new[] { "星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六" }; return day[Convert.ToInt32(dt.DayOfWeek.ToString("d"))]; } /// /// 获取这个月的第几周 /// /// /// public static int GetWeekNumInMonth(DateTime daytime) { int dayInMonth = daytime.Day; // 本月第一天 DateTime firstDay = daytime.AddDays(1 - daytime.Day); // 本月第一天是周几 int weekday = (int)firstDay.DayOfWeek == 0 ? 7 : (int)firstDay.DayOfWeek; // 本月第一周有几天 int firstWeekEndDay = 7 - (weekday - 1); // 当前日期和第一周之差 int diffday = dayInMonth - firstWeekEndDay; diffday = diffday > 0 ? diffday : 1; // 当前是第几周,若整除7就减一天 return ((diffday % 7) == 0 ? (diffday / 7 - 1) : (diffday / 7)) + 1 + (dayInMonth > firstWeekEndDay ? 1 : 0); } /// /// 获取今天的时间范围 /// /// 返回包含开始时间和结束时间的元组 public (DateTime Start, DateTime End) GetTodayRange() { var start = Date.Date; // 当天开始时间 var end = start.AddDays(1).AddSeconds(-1); // 当天结束时间 return (start, end); } /// /// 获取本月的时间范围 /// /// 返回包含开始时间和结束时间的元组 public (DateTime Start, DateTime End) GetMonthRange() { return (GetFirstDayOfMonth(), GetLastDayOfMonth()); } /// /// 获取本月的第一天开始时间 /// /// 返回当月的第一天 public DateTime GetFirstDayOfMonth() { return new DateTime(Date.Year, Date.Month, 1); } /// /// 获取本月的最后一天截至时间 /// /// 返回当月的最后一天 public DateTime GetLastDayOfMonth() { var firstDayOfNextMonth = new DateTime(Date.Year, Date.Month, 1).AddMonths(1); return firstDayOfNextMonth.AddSeconds(-1); } /// /// 获取今年的时间范围 /// public (DateTime Start, DateTime End) GetYearRange() { return (GetFirstDayOfYear(), GetLastDayOfYear()); } /// /// 获取今年的第一天时间范围 /// public DateTime GetFirstDayOfYear() { return new DateTime(Date.Year, 1, 1); } /// /// 获取今年的最后一天时间范围 /// public DateTime GetLastDayOfYear() { return new DateTime(Date.Year, 12, 31, 23, 59, 59); } /// /// 获取前天时间范围 /// public (DateTime Start, DateTime End) GetDayBeforeYesterdayRange() { var start = Date.Date.AddDays(-2); // 前天开始时间 var end = start.AddDays(1).AddSeconds(-1); // 前天结束时间 return (start, end); } /// /// 获取昨天时间范围 /// public (DateTime Start, DateTime End) GetYesterdayRange() { var start = Date.Date.AddDays(-1); // 昨天开始时间 var end = start.AddDays(1).AddSeconds(-1); // 昨天结束时间 return (start, end); } /// /// 获取上一周时间范围 /// public (DateTime Start, DateTime End) GetLastWeekRange() { // 计算上周的天数差 var daysToSubtract = (int)Date.DayOfWeek + 7; // 确保周日也能正确计算 var start = Date.Date.AddDays(-daysToSubtract); // 上周第一天 var end = start.AddDays(7).AddSeconds(-1); // 上周最后一天 return (start, end); } /// /// 获取本周时间范围 /// public (DateTime Start, DateTime End) GetThisWeekRange() { // 计算本周的天数差 var daysToSubtract = (int)Date.DayOfWeek; var start = Date.Date.AddDays(-daysToSubtract); // 本周第一天 var end = start.AddDays(7).AddSeconds(-1); // 本周最后一天 return (start, end); } /// /// 获取上月时间范围 /// public (DateTime Start, DateTime End) GetLastMonthRange() { var firstDayOfLastMonth = new DateTime(Date.Year, Date.Month, 1).AddMonths(-1); // 上月第一天 var lastDayOfLastMonth = firstDayOfLastMonth.AddMonths(1).AddSeconds(-1); // 上月最后一天 return (firstDayOfLastMonth, lastDayOfLastMonth); } /// /// 获取近3天的时间范围 /// public (DateTime Start, DateTime End) GetLast3DaysRange() { var start = Date.Date.AddDays(-2); // 3天前的开始时间 var end = Date.Date.AddDays(1).AddSeconds(-1); // 当前日期的结束时间 return (start, end); } /// /// 获取近7天的时间范围 /// public (DateTime Start, DateTime End) GetLast7DaysRange() { var start = Date.Date.AddDays(-6); // 7天前的开始时间 var end = Date.Date.AddDays(1).AddSeconds(-1); // 当前日期的结束时间 return (start, end); } /// /// 获取近15天的时间范围 /// public (DateTime Start, DateTime End) GetLast15DaysRange() { var start = Date.Date.AddDays(-14); // 15天前的开始时间 var end = Date.Date.AddDays(1).AddSeconds(-1); // 当前日期的结束时间 return (start, end); } /// /// 获取近3个月的时间范围 /// public (DateTime Start, DateTime End) GetLast3MonthsRange() { var start = Date.Date.AddMonths(-3); // 3个月前的开始时间 var end = Date.Date.AddDays(1).AddSeconds(-1); // 当前日期的结束时间 return (start, end); } /// /// 获取上半年的时间范围 /// public (DateTime Start, DateTime End) GetFirstHalfYearRange() { var start = new DateTime(Date.Year, 1, 1); // 上半年开始时间 var end = new DateTime(Date.Year, 6, 30, 23, 59, 59); // 上半年结束时间 return (start, end); } /// /// 获取下半年的时间范围 /// public (DateTime Start, DateTime End) GetSecondHalfYearRange() { var start = new DateTime(Date.Year, 7, 1); // 下半年开始时间 var end = new DateTime(Date.Year, 12, 31, 23, 59, 59); // 下半年结束时间 return (start, end); } }