Add new date utilities

Author: danielsaidi

RELEASE_NOTES.md

@@ -8,8 +8,13 @@ SwiftUIKit makes its best effort to honor semver, but breaking changes can occur
 
 This version deprecates progress types, since a native `Gauge` can be used instead.
 
+### ✨ Features
+
+* `Date` has a new calendar-based comparison extensions.
+
 ### 🗑️ Deprecations
 
+* `Calendar` extensions have been deprecated.
 * `CircularProgressBar` has been deprecated.
 * `LinearProgressBar` has been deprecated.
 * `Pasteboard` has been deprecated.

Sources/SwiftUIKit/Date/Date+Compare.swift

@@ -11,18 +11,37 @@ import Foundation
 /// This extension provides more readable date comparisons.
 public extension Date {
 
-    /// Whether or not the date occurs after another date.
+    /// Whether the date occurs after another date.
     func isAfter(_ date: Date) -> Bool {
         self > date
     }
 
-    /// Whether or not the date occurs before another date.
+    /// Whether the date occurs before another date.
     func isBefore(_ date: Date) -> Bool {
         self < date
     }
 
-    /// Whether or not the date is the same as another date.
+    /// Whether the date is the same as another date.
     func isSame(as date: Date) -> Bool {
         self == date
     }
+
+    /// Whether the date is the same as another date, for an
+    /// explicity granularity, like `.day`.
+    func isSame(
+        _ granularity: Calendar.Component,
+        as date: Date,
+        for calendar: Calendar = .current
+    ) -> Bool {
+        calendar.isDate(self, equalTo: date, toGranularity: granularity)
+    }
+
+    /// Whether the date is the same as another date, for an
+    /// explicity granularity, like `.day`.
+    func isThis(
+        _ granularity: Calendar.Component,
+        for calendar: Calendar = .current
+    ) -> Bool {
+        isSame(granularity, as: Date(), for: calendar)
+    }
 }

Sources/SwiftUIKit/Date/Calendar+Date.swift renamed to Sources/SwiftUIKit/_Deprecated/Calendar+Date.swift

@@ -8,45 +8,35 @@
 
 import Foundation
 
+@available(*, deprecated, message: "Use Date extensions instead.")
 public extension Calendar {
 
-    /**
-     Whether or not this calendar thinks that a certain date
-     is the same day as another date.
-     */
+    /// Whether the date is the same day as another date.
     func isDate(
         _ date1: Date,
         sameDayAs date2: Date
     ) -> Bool {
         isDate(date1, equalTo: date2, toGranularity: .day)
     }
-    
-    /**
-     Whether or not this calendar thinks that a certain date
-     is the same month as another date.
-     */
+
+    /// Whether the date is the same month as another date.
     func isDate(
         _ date1: Date,
         sameMonthAs date2: Date
     ) -> Bool {
         isDate(date1, equalTo: date2, toGranularity: .month)
     }
-    
-    /**
-     Whether or not this calendar thinks that a certain date
-     is the same week as another date.
-     */
+
+    /// Whether the date is the same week as another date.
     func isDate(
         _ date1: Date,
         sameWeekAs date2: Date
     ) -> Bool {
         isDate(date1, equalTo: date2, toGranularity: .weekOfYear)
     }
-    
-    /**
-     Whether or not this calendar thinks that a certain date
-     is the same year as another date.
-     */
+
+
+    /// Whether the date is the same year as another date.
     func isDate(
         _ date1: Date,
         sameYearAs date2: Date