Masuit.Tools/Masuit.Tools.Abstractions/DateTimeExt/DateTimeHelper.cs

using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Globalization;
using System.Linq;
using System.Runtime.InteropServices;
using Masuit.Tools.Models;

namespace Masuit.Tools.DateTimeExt
{
    /// <summary>
    /// 日期操作工具类
    /// </summary>
    public static class DateTimeHelper
    {
        /// <summary>
        /// 获取某一年有多少周
        /// </summary>
        /// <param name="now"></param>
        /// <returns>该年周数</returns>
        public static int GetWeekAmount(this in DateTime now)
        {
            var end = new DateTime(now.Year, 12, 31); //该年最后一天
            var gc = new GregorianCalendar();
            return gc.GetWeekOfYear(end, CalendarWeekRule.FirstDay, DayOfWeek.Monday); //该年星期数
        }

        /// <summary>
        /// 返回年度第几个星期   默认星期日是第一天
        /// </summary>
        /// <param name="date">时间</param>
        /// <returns>第几周</returns>
        public static int WeekOfYear(this in DateTime date)
        {
            var gc = new GregorianCalendar();
            return gc.GetWeekOfYear(date, CalendarWeekRule.FirstDay, DayOfWeek.Sunday);
        }

        /// <summary>
        /// 返回年度第几个星期
        /// </summary>
        /// <param name="date">时间</param>
        /// <param name="week">一周的开始日期</param>
        /// <returns>第几周</returns>
        public static int WeekOfYear(this in DateTime date, DayOfWeek week)
        {
            var gc = new GregorianCalendar();
            return gc.GetWeekOfYear(date, CalendarWeekRule.FirstDay, week);
        }

        /// <summary>
        /// 得到一年中的某周的起始日和截止日
        /// 周数 nNumWeek
        /// </summary>
        /// <param name="now"></param>
        /// <param name="nNumWeek">第几周</param>
        public static DateTimeRange GetWeekTime(this DateTime now, int nNumWeek)
        {
            var dt = new DateTime(now.Year, 1, 1);
            dt += new TimeSpan((nNumWeek - 1) * 7, 0, 0, 0);
            return GetCurrentWeek(dt);
        }

        /// <summary>
        /// 得到当前周的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentWeek(this DateTime dt)
        {
            CultureInfo culture = CultureInfo.CurrentCulture;
            DayOfWeek firstDayOfWeek = culture.DateTimeFormat.FirstDayOfWeek;

            // 计算星期的起始日期（第一天）
            DateTime startOfWeek = dt.Date;
            while (startOfWeek.DayOfWeek != firstDayOfWeek)
            {
                startOfWeek = startOfWeek.AddDays(-1);
            }

            // 计算星期的结束日期（最后一天）
            DateTime endOfWeek = startOfWeek.AddDays(6).AddSeconds(86399);
            return new DateTimeRange(startOfWeek, endOfWeek);
        }

        /// <summary>
        /// 得到当前月的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentMonth(this DateTime dt)
        {
            return new DateTimeRange(new DateTime(dt.Year, dt.Month, 1), new DateTime(dt.Year, dt.Month, GetDaysOfMonth(dt), 23, 59, 59));
        }

        /// <summary>
        /// 得到当前农历月的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentLunarMonth(this DateTime dt)
        {
            var calendar = new ChineseCalendar(dt);
            return new DateTimeRange(new ChineseCalendar(calendar.ChineseYear, calendar.ChineseMonth, 1).Date, new ChineseCalendar(calendar.ChineseYear, calendar.ChineseMonth, calendar.GetChineseMonthDays()).Date.AddSeconds(86399));
        }

        /// <summary>
        /// 得到当前年的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentYear(this DateTime dt)
        {
            return new DateTimeRange(new DateTime(dt.Year, 1, 1), new DateTime(dt.Year, 12, 31, 23, 59, 59));
        }

        /// <summary>
        /// 得到当前农历年的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentLunarYear(this DateTime dt)
        {
            var calendar = new ChineseCalendar(dt);
            return new DateTimeRange(new ChineseCalendar(calendar.ChineseYear, 1, 1).Date, new ChineseCalendar(calendar.ChineseYear, 12, calendar.GetChineseMonthDays(calendar.ChineseYear, 12)).Date.AddSeconds(86399));
        }

        /// <summary>
        /// 得到当前季度的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentQuarter(this DateTime dt)
        {
            return dt.Month switch
            {
                >= 1 and <= 3 => new DateTimeRange(new DateTime(dt.Year, 1, 1), new DateTime(dt.Year, 3, 31, 23, 59, 59)),
                >= 4 and <= 6 => new DateTimeRange(new DateTime(dt.Year, 4, 1), new DateTime(dt.Year, 6, 30, 23, 59, 59)),
                >= 7 and <= 9 => new DateTimeRange(new DateTime(dt.Year, 7, 1), new DateTime(dt.Year, 9, 30, 23, 59, 59)),
                >= 10 and <= 12 => new DateTimeRange(new DateTime(dt.Year, 10, 1), new DateTime(dt.Year, 12, 31, 23, 59, 59)),
                _ => throw new ArgumentOutOfRangeException()
            };
        }

        /// <summary>
        /// 得到当前农历季度的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentLunarQuarter(this DateTime dt)
        {
            var calendar = new ChineseCalendar(dt);
            return dt.Month switch
            {
                >= 1 and <= 3 => new DateTimeRange(new ChineseCalendar(calendar.ChineseYear, 1, 1).Date, new ChineseCalendar(calendar.ChineseYear, 3, calendar.GetChineseMonthDays(calendar.ChineseYear, 3)).Date.AddSeconds(86399)),
                >= 4 and <= 6 => new DateTimeRange(new ChineseCalendar(calendar.ChineseYear, 4, 1).Date, new ChineseCalendar(calendar.ChineseYear, 6, calendar.GetChineseMonthDays(calendar.ChineseYear, 6)).Date.AddSeconds(86399)),
                >= 7 and <= 9 => new DateTimeRange(new ChineseCalendar(calendar.ChineseYear, 7, 1).Date, new ChineseCalendar(calendar.ChineseYear, 9, calendar.GetChineseMonthDays(calendar.ChineseYear, 9)).Date.AddSeconds(86399)),
                >= 10 and <= 12 => new DateTimeRange(new ChineseCalendar(calendar.ChineseYear, 10, 1).Date, new ChineseCalendar(calendar.ChineseYear, 12, calendar.GetChineseMonthDays(calendar.ChineseYear, 12)).Date.AddSeconds(86399)),
                _ => throw new ArgumentOutOfRangeException()
            };
        }

        /// <summary>
        /// 得到当前农历季度的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        public static DateTimeRange GetCurrentSolar(this DateTime dt)
        {
            var calendar = new ChineseCalendar(dt);
            ChineseCalendar[] quarters =
            [
                calendar.ChineseTwentyFourPrevDay.ChineseTwentyFourPrevDay.ChineseTwentyFourPrevDay,
                calendar.ChineseTwentyFourPrevDay.ChineseTwentyFourPrevDay,
                calendar.ChineseTwentyFourPrevDay,
                calendar,
                calendar.ChineseTwentyFourNextDay,
                calendar.ChineseTwentyFourNextDay.ChineseTwentyFourNextDay,
                calendar.ChineseTwentyFourNextDay.ChineseTwentyFourNextDay.ChineseTwentyFourNextDay
            ];
            var solar = quarters.LastOrDefault(c => new[] { "春分", "夏至", "秋分", "冬至" }.Contains(c.ChineseTwentyFourDay));
            var start = solar.ChineseTwentyFourPrevDay.ChineseTwentyFourPrevDay.ChineseTwentyFourPrevDay;
            var end = solar.ChineseTwentyFourNextDay.ChineseTwentyFourNextDay.ChineseTwentyFourNextDay;
            return new DateTimeRange(start.Date, end.Date.AddSeconds(-1));
        }

        /// <summary>
        /// 得到当前范围的起始日和截止日
        /// </summary>
        /// <param name="dt"></param>
        /// <param name="type"></param>
        public static DateTimeRange GetCurrentRange(this DateTime dt, DateRangeType type)
        {
            return type switch
            {
                DateRangeType.Week => GetCurrentWeek(dt),
                DateRangeType.Month => GetCurrentMonth(dt),
                DateRangeType.Quarter => GetCurrentQuarter(dt),
                DateRangeType.Year => GetCurrentYear(dt),
                DateRangeType.LunarMonth => GetCurrentLunarMonth(dt),
                DateRangeType.LunarQuarter => GetCurrentLunarQuarter(dt),
                DateRangeType.Solar => GetCurrentSolar(dt),
                DateRangeType.LunarYear => GetCurrentLunarYear(dt),
                _ => throw new ArgumentOutOfRangeException(nameof(type), type, null)
            };
        }

        #region P/Invoke 设置本地时间

        [DllImport("kernel32.dll")]
        private static extern bool SetLocalTime(ref SystemTime time);

        [StructLayout(LayoutKind.Sequential)]
        private record struct SystemTime
        {
            public short year;
            public short month;
            public short dayOfWeek;
            public short day;
            public short hour;
            public short minute;
            public short second;
            public short milliseconds;
        }

        /// <summary>
        /// 设置本地计算机系统时间，仅支持Windows系统
        /// </summary>
        /// <param name="dt">DateTime对象</param>
        public static void SetLocalTime(this in DateTime dt)
        {
            SystemTime st;
            st.year = (short)dt.Year;
            st.month = (short)dt.Month;
            st.dayOfWeek = (short)dt.DayOfWeek;
            st.day = (short)dt.Day;
            st.hour = (short)dt.Hour;
            st.minute = (short)dt.Minute;
            st.second = (short)dt.Second;
            st.milliseconds = (short)dt.Millisecond;
            SetLocalTime(ref st);
        }

        #endregion P/Invoke 设置本地时间

        /// <summary>
        /// 返回相对于当前时间的相对天数
        /// </summary>
        /// <param name="dt"></param>
        /// <param name="relativeday">相对天数</param>
        public static string GetDateTime(this in DateTime dt, int relativeday)
        {
            return dt.AddDays(relativeday).ToString("yyyy-MM-dd HH:mm:ss");
        }

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的秒数
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalSeconds(this in DateTime dt) => new DateTimeOffset(dt).UtcDateTime.Ticks / 10_000_000L - 62135596800L;

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的毫秒数
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalMilliseconds(this in DateTime dt) => new DateTimeOffset(dt).UtcDateTime.Ticks / 10000L - 62135596800000L;

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的微秒时间戳
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalMicroseconds(this in DateTime dt) => (new DateTimeOffset(dt).UtcTicks - 621355968000000000) / 10;

        [DllImport("Kernel32.dll")]
        private static extern bool QueryPerformanceCounter(out long lpPerformanceCount);

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的纳秒时间戳
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalNanoseconds(this in DateTime dt)
        {
            var ticks = (new DateTimeOffset(dt).UtcTicks - 621355968000000000) * 100;
            if (Environment.OSVersion.Platform == PlatformID.Win32NT)
            {
                QueryPerformanceCounter(out var timestamp);
                return ticks + timestamp % 100;
            }

            return ticks + Stopwatch.GetTimestamp() % 100;
        }

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的分钟数
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalMinutes(this in DateTime dt) => GetTotalSeconds(dt) / 60;

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的小时数
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalHours(this in DateTime dt) => GetTotalSeconds(dt) / 3600;

        /// <summary>
        /// 获取该时间相对于1970-01-01T00:00:00Z的天数
        /// </summary>
        /// <param name="dt"></param>
        /// <returns></returns>
        public static long GetTotalDays(this in DateTime dt) => GetTotalSeconds(dt) / 86400;

        /// <summary>本年有多少天</summary>
        /// <param name="dt">日期</param>
        /// <returns>本天在当年的天数</returns>
        public static int GetDaysOfYear(this in DateTime dt)
        {
            //取得传入参数的年份部分，用来判断是否是闰年
            int n = dt.Year;
            return DateTime.IsLeapYear(n) ? 366 : 365;
        }

        /// <summary>本月有多少天</summary>
        /// <param name="now"></param>
        /// <returns>天数</returns>
        public static int GetDaysOfMonth(this DateTime now)
        {
            return now.Month switch
            {
                1 => 31,
                2 => DateTime.IsLeapYear(now.Year) ? 29 : 28,
                3 => 31,
                4 => 30,
                5 => 31,
                6 => 30,
                7 => 31,
                8 => 31,
                9 => 30,
                10 => 31,
                11 => 30,
                12 => 31,
                _ => 0
            };
        }

        /// <summary>返回当前日期的星期名称</summary>
        /// <param name="now">日期</param>
        /// <returns>星期名称</returns>
        public static string GetWeekNameOfDay(this in DateTime now)
        {
            return now.DayOfWeek switch
            {
                DayOfWeek.Monday => "星期一",
                DayOfWeek.Tuesday => "星期二",
                DayOfWeek.Wednesday => "星期三",
                DayOfWeek.Thursday => "星期四",
                DayOfWeek.Friday => "星期五",
                DayOfWeek.Saturday => "星期六",
                DayOfWeek.Sunday => "星期日",
                _ => ""
            };
        }

        /// <summary>
        /// 判断时间是否在区间内
        /// </summary>
        /// <param name="this"></param>
        /// <param name="start">开始</param>
        /// <param name="end">结束</param>
        /// <param name="mode">模式</param>
        /// <returns></returns>
        public static bool In(this in DateTime @this, DateTime? start, DateTime? end, RangeMode mode = RangeMode.Close)
        {
            start ??= DateTime.MinValue;
            end ??= DateTime.MaxValue;
            return mode switch
            {
                RangeMode.Open => start < @this && end > @this,
                RangeMode.Close => start <= @this && end >= @this,
                RangeMode.OpenClose => start < @this && end >= @this,
                RangeMode.CloseOpen => start <= @this && end > @this,
                _ => throw new ArgumentOutOfRangeException(nameof(mode), mode, null)
            };
        }

        /// <summary>
        /// 返回某年某月最后一天
        /// </summary>
        /// <param name="now"></param>
        /// <returns>日</returns>
        public static int GetMonthLastDate(this DateTime now)
        {
            DateTime lastDay = new DateTime(now.Year, now.Month, new GregorianCalendar().GetDaysInMonth(now.Year, now.Month));
            return lastDay.Day;
        }

        /// <summary>
        /// 获得一段时间内有多少小时
        /// </summary>
        /// <param name="start">起始时间</param>
        /// <param name="end">终止时间</param>
        /// <returns>小时差</returns>
        public static string GetTimeDelay(this in DateTime start, DateTime end)
        {
            return (end - start).ToString("c");
        }

        /// <summary>
        /// 返回时间差
        /// </summary>
        /// <param name="dateTime1">时间1</param>
        /// <param name="dateTime2">时间2</param>
        /// <returns>时间差</returns>
        public static string DateDiff(this in DateTime dateTime1, in DateTime dateTime2)
        {
            string dateDiff;
            var ts = dateTime2 - dateTime1;
            if (ts.TotalDays >= 1)
            {
                dateDiff = ts.TotalDays >= 30 ? (ts.TotalDays / 30) + "个月前" : ts.TotalDays + "天前";
            }
            else
            {
                dateDiff = ts.Hours > 1 ? ts.Hours + "小时前" : ts.Minutes + "分钟前";
            }

            return dateDiff;
        }

        /// <summary>
        /// 计算2个时间差
        /// </summary>
        /// <param name="beginTime">开始时间</param>
        /// <param name="endTime">结束时间</param>
        /// <returns>时间差</returns>
        public static string GetDiffTime(this in DateTime beginTime, in DateTime endTime)
        {
            string strResout = string.Empty;

            //获得2时间的时间间隔秒计算
            TimeSpan span = endTime.Subtract(beginTime);
            if (span.Days >= 365)
            {
                strResout += span.Days / 365 + "年";
            }
            if (span.Days >= 30)
            {
                strResout += span.Days % 365 / 30 + "个月";
            }
            if (span.Days >= 1)
            {
                strResout += (int)(span.TotalDays % 30.42) + "天";
            }
            if (span.Hours >= 1)
            {
                strResout += span.Hours + "小时";
            }
            if (span.Minutes >= 1)
            {
                strResout += span.Minutes + "分钟";
            }
            if (span.Seconds >= 1)
            {
                strResout += span.Seconds + "秒";
            }
            return strResout;
        }

        /// <summary>
        /// 根据某个时间段查找在某批时间段中的最大并集
        /// </summary>
        /// <param name="destination"></param>
        /// <param name="sources"></param>
        /// <typeparam name="T"></typeparam>
        /// <returns></returns>
        public static ICollection<T> GetUnionSet<T>(this T destination, List<T> sources) where T : ITimePeriod, new()
        {
            var result = true;
            ICollection<T> frames = new List<T>();

            var timeFrames = sources.Where(frame =>
                !(destination.Start > frame.End || destination.End < frame.Start)).ToList();
            if (timeFrames.Any())
                foreach (var frame in timeFrames)
                {
                    frames.Add(frame);
                    sources.Remove(frame);
                }

            if (!frames.Any()) return frames;
            var timePeriod = new T()
            {
                End = frames.OrderBy(frame => frame.End).Max(frame => frame.End),
                Start = frames.OrderBy(frame => frame.Start).Min(frame => frame.Start)
            };

            while (result)
            {
                var maxTimeFrame = GetUnionSet<T>(timePeriod, sources);
                if (!maxTimeFrame.Any())
                    result = false;
                else
                    foreach (var frame in maxTimeFrame)
                        frames.Add(frame);
            }

            return frames;
        }

        /// <summary>
        /// 获取一批时间段内存在相互重叠的最大时间段
        /// </summary>
        /// <param name="destination">基础时间段</param>
        /// <param name="sources">一批时间段</param>
        /// <typeparam name="T"></typeparam>
        /// <returns></returns>
        /// <remarks>源数据sources 会受到影响</remarks>
        public static T GetMaxTimePeriod<T>(this T destination, List<T> sources) where T : ITimePeriod, new()
        {
            var list = sources.Select(period => new T()
            {
                End = period.End,
                Start = period.Start,
            }).ToList();

            var timePeriods = GetUnionSet(destination, list);
            return new T()
            {
                End = timePeriods.OrderBy(period => period.End).Max(period => period.End),
                Start = timePeriods.OrderBy(period => period.Start).Min(period => period.Start)
            };
        }
    }

    /// <summary>
    ///
    /// </summary>
    public interface ITimePeriod
    {
        /// <summary>
        /// 起始时间
        /// </summary>
        public DateTime? Start { get; set; }

        /// <summary>
        /// 终止时间
        /// </summary>
        public DateTime? End { get; set; }
    }

    /// <summary>
    /// 区间模式
    /// </summary>
    public enum RangeMode
    {
        /// <summary>
        /// 开区间
        /// </summary>
        Open,

        /// <summary>
        /// 闭区间
        /// </summary>
        Close,

        /// <summary>
        /// 左开右闭区间
        /// </summary>
        OpenClose,

        /// <summary>
        /// 左闭右开区间
        /// </summary>
        CloseOpen
    }

    public enum DateRangeType
    {
        Week,
        Month,
        Quarter,
        Year,
        LunarMonth,
        LunarQuarter,
        Solar,
        LunarYear,
    }
}