feat: add datetime calculator methods

Author: ikesnowy

src/Cnblogs.Architecture.Ddd.Domain.Abstractions/DateTimeOffsetCalculator.cs

@@ -0,0 +1,72 @@
+namespace Cnblogs.Architecture.Ddd.Domain.Abstractions;
+
+/// <summary>
+/// Handy calculator for DateTime
+/// </summary>
+public static class DateTimeOffsetCalculator
+{
+    /// <summary>
+    /// Get a new <see cref="DateTimeOffset"/> with time set to 0:00:00
+    /// </summary>
+    /// <param name="dateTime">Input <see cref="DateTimeOffset"/>.</param>
+    /// <returns></returns>
+    public static DateTimeOffset StartOfTheDay(this DateTimeOffset dateTime)
+    {
+        return new DateTimeOffset(dateTime.Date, dateTime.Offset);
+    }
+
+    /// <summary>
+    /// Get a new <see cref="DateTimeOffset"/> with time set to 23:59:59.999.
+    /// </summary>
+    /// <param name="dateTime"></param>
+    /// <returns></returns>
+    public static DateTimeOffset EndOfTheDay(this DateTimeOffset dateTime)
+    {
+        return StartOfTheDay(dateTime).AddDays(1).AddMilliseconds(-1);
+    }
+
+    /// <summary>
+    /// Get a new <see cref="DateTimeOffset"/> that set the start of a week for the given date.
+    /// </summary>
+    /// <param name="dateTime"></param>
+    /// <returns></returns>
+    public static DateTimeOffset StartOfTheWeek(this DateTimeOffset dateTime)
+    {
+        var monday = dateTime.DayOfWeek switch
+        {
+            DayOfWeek.Monday => dateTime,
+            DayOfWeek.Sunday => dateTime.AddDays(-6),
+            _ => dateTime.AddDays(-(int)(dateTime.DayOfWeek - 1))
+        };
+
+        return monday.StartOfTheDay();
+    }
+
+    /// <summary>
+    /// Get a new <see cref="DateTimeOffset"/> that set to the end of a week for the given date.
+    /// </summary>
+    /// <param name="dateTime"></param>
+    /// <returns></returns>
+    public static DateTimeOffset EndOfTheWeek(this DateTimeOffset dateTime)
+    {
+        var sunday = dateTime.DayOfWeek switch
+        {
+            DayOfWeek.Sunday => dateTime,
+            DayOfWeek.Monday => dateTime.AddDays(6),
+            _ => dateTime.AddDays((int)(7 - dateTime.DayOfWeek))
+        };
+
+        return sunday.EndOfTheDay();
+    }
+
+    /// <summary>
+    /// Check whether two <see cref="DateTimeOffset"/> is in same date.
+    /// </summary>
+    /// <param name="left">First <see cref="DateTimeOffset"/> to check.</param>
+    /// <param name="right">Second <see cref="DateTimeOffset"/> to check.</param>
+    /// <returns></returns>
+    public static bool IsInSameDate(this DateTimeOffset left, DateTimeOffset right)
+    {
+        return left.Year == right.Year && left.DayOfYear == right.DayOfYear;
+    }
+}

src/Cnblogs.Architecture.Ddd.Domain.Abstractions/DefaultDateTimeProvider.cs

@@ -11,16 +11,52 @@ public DateTimeOffset Now()
         return DateTimeOffset.Now;
     }
 
+    /// <inheritdoc />
+    public DateTimeOffset Yesterday()
+    {
+        return Today().AddDays(-1);
+    }
+
+    /// <inheritdoc />
+    public DateTimeOffset EndOfYesterday()
+    {
+        return Today().AddDays(-1).EndOfTheDay();
+    }
+
     /// <inheritdoc />
     public DateTimeOffset Today()
     {
         var now = Now();
         return new DateTimeOffset(now.Year, now.Month, now.Day, 0, 0, 0, now.Offset);
     }
 
+    /// <inheritdoc />
+    public DateTimeOffset EndOfToday()
+    {
+        return Today().EndOfTheDay();
+    }
+
+    /// <inheritdoc />
+    public DateTimeOffset Tomorrow()
+    {
+        return Today().AddDays(1);
+    }
+
+    /// <inheritdoc />
+    public DateTimeOffset EndOfTomorrow()
+    {
+        return Today().AddDays(1).EndOfTheDay();
+    }
+
     /// <inheritdoc />
     public long UnixSeconds()
     {
         return Now().ToUnixTimeSeconds();
     }
+
+    /// <inheritdoc />
+    public long UnixMilliseconds()
+    {
+        return Now().ToUnixTimeMilliseconds();
+    }
 }

src/Cnblogs.Architecture.Ddd.Domain.Abstractions/IDateTimeProvider.cs

@@ -12,14 +12,50 @@ public interface IDateTimeProvider
     DateTimeOffset Now();
 
     /// <summary>
-    ///     Get <see cref="DateTimeOffset"/> today's date.
+    ///     Get <see cref="DateTimeOffset"/> of yesterday's date.
+    /// </summary>
+    /// <returns></returns>
+    DateTimeOffset Yesterday();
+
+    /// <summary>
+    ///     Get <see cref="DateTimeOffset"/> of yesterday's date with time set to 23:59:59.999.
+    /// </summary>
+    /// <returns></returns>
+    DateTimeOffset EndOfYesterday();
+
+    /// <summary>
+    ///     Get <see cref="DateTimeOffset"/> of today's date.
     /// </summary>
     /// <returns>Today's date.</returns>
     DateTimeOffset Today();
 
+    /// <summary>
+    ///     Get <see cref="DateTimeOffset"/> of today's date with time set to 23:59:59.999.
+    /// </summary>
+    /// <returns></returns>
+    DateTimeOffset EndOfToday();
+
+    /// <summary>
+    ///     Get <see cref="DateTimeOffset"/> of tomorrow's date with time set to 0:00:00.000.
+    /// </summary>
+    /// <returns></returns>
+    DateTimeOffset Tomorrow();
+
+    /// <summary>
+    ///     Get <see cref="DateTimeOffset"/> of tomorrow's date with time set to 23:59:59.000.
+    /// </summary>
+    /// <returns></returns>
+    DateTimeOffset EndOfTomorrow();
+
     /// <summary>
     ///     Get number of seconds that have elapsed since 1970-01-01T00:00:00Z.
     /// </summary>
     /// <returns>The number of seconds that have elapsed since 1970-01-01T00:00:00Z.</returns>
     long UnixSeconds();
+
+    /// <summary>
+    ///     Get number of milliseconds that have elapsed since 1970-01-01T00:00:00Z.
+    /// </summary>
+    /// <returns></returns>
+    long UnixMilliseconds();
 }