SPB Git

Repository Public

CalendarMath.swift 4.7 KB 90 lines swift

1import Foundation23/// One cell of a calendar grid.4public struct CalendarDay: Identifiable, Hashable, Sendable {5    public var date: Date            // start of the day in the calendar's time zone6    public var inDisplayedMonth: Bool7    public var isToday: Bool8    public var id: Date { date }9}1011/// Date arithmetic for the maintenance calendar (month grid, week, overlap, agenda). Pure and testable.12public enum CalendarMath {13    public static func calendar(language: AppLanguage = Localization.shared.language, timeZone: TimeZone = .current) -> Calendar {14        var c = Calendar(identifier: .gregorian)15        c.locale = language.locale16        c.timeZone = timeZone17        c.firstWeekday = language == .fr ? 2 : 1   // Monday in French Canada's work calendars, Sunday in English18        return c19    }2021    public static func startOfMonth(_ date: Date, calendar: Calendar) -> Date {22        calendar.date(from: calendar.dateComponents([.year, .month], from: date)) ?? date23    }2425    public static func startOfWeek(_ date: Date, calendar: Calendar) -> Date {26        let day = calendar.startOfDay(for: date)27        let weekday = calendar.component(.weekday, from: day)28        let offset = (weekday - calendar.firstWeekday + 7) % 729        return calendar.date(byAdding: .day, value: -offset, to: day) ?? day30    }3132    /// Six full weeks covering the month of `date`.33    public static func monthGrid(containing date: Date, calendar: Calendar, today: Date = Date()) -> [CalendarDay] {34        let first = startOfMonth(date, calendar: calendar)35        let gridStart = startOfWeek(first, calendar: calendar)36        let month = calendar.component(.month, from: first)37        return (0..<42).compactMap { i in38            guard let d = calendar.date(byAdding: .day, value: i, to: gridStart) else { return nil }39            return CalendarDay(date: d, inDisplayedMonth: calendar.component(.month, from: d) == month, isToday: calendar.isDate(d, inSameDayAs: today))40        }41    }4243    public static func week(containing date: Date, calendar: Calendar, today: Date = Date()) -> [CalendarDay] {44        let start = startOfWeek(date, calendar: calendar)45        return (0..<7).compactMap { i in46            guard let d = calendar.date(byAdding: .day, value: i, to: start) else { return nil }47            return CalendarDay(date: d, inDisplayedMonth: true, isToday: calendar.isDate(d, inSameDayAs: today))48        }49    }5051    /// The interval to request from the server for a list of days.52    public static func window(for days: [CalendarDay], calendar: Calendar, nodeID: String? = nil) -> DateWindow? {53        guard let first = days.first?.date, let last = days.last?.date, let end = calendar.date(byAdding: .day, value: 1, to: last) else { return nil }54        return DateWindow(from: first, to: end, nodeID: nodeID)55    }5657    /// Weekday symbols starting at the calendar's first weekday.58    public static func weekdaySymbols(calendar: Calendar, short: Bool = true) -> [String] {59        let symbols = short ? calendar.shortStandaloneWeekdaySymbols : calendar.standaloneWeekdaySymbols60        return (0..<7).map { symbols[(calendar.firstWeekday - 1 + $0) % 7] }61    }6263    /// Occurrences that overlap `day` (an occurrence spanning midnight appears on both days).64    public static func occurrences(on day: Date, in list: [API.MaintenanceOccurrence], calendar: Calendar) -> [API.MaintenanceOccurrence] {65        let start = calendar.startOfDay(for: day)66        guard let end = calendar.date(byAdding: .day, value: 1, to: start) else { return [] }67        return list.filter { $0.occurrenceStart < end && $0.occurrenceEnd > start }.sorted { $0.occurrenceStart < $1.occurrenceStart }68    }6970    /// Agenda: occurrences grouped by their starting day, in chronological order.71    public static func agenda(_ list: [API.MaintenanceOccurrence], calendar: Calendar) -> [(day: Date, items: [API.MaintenanceOccurrence])] {72        Dictionary(grouping: list) { calendar.startOfDay(for: $0.occurrenceStart) }73            .map { (day: $0.key, items: $0.value.sorted { $0.occurrenceStart < $1.occurrenceStart }) }74            .sorted { $0.day < $1.day }75    }7677    /// Fraction of the day (0...1) at which `date` falls, clamped to `day` — for week timelines.78    public static func dayFraction(of date: Date, in day: Date, calendar: Calendar) -> Double {79        let start = calendar.startOfDay(for: day)80        guard let end = calendar.date(byAdding: .day, value: 1, to: start) else { return 0 }81        let total = end.timeIntervalSince(start)82        return min(1, max(0, date.timeIntervalSince(start) / total))83    }84}8586public extension API.MaintenanceOccurrence {87    /// Stable identity of an occurrence: a recurring window has many.88    var occurrenceID: String { "\(window.id)@\(Int(occurrenceStart.timeIntervalSince1970))" }89}90
Files main
Menu

Theme