// 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);
}
}