structure Std.Time.PlainDate : Type

PlainDate represents a date in the Year-Month-Day (YMD) format. It encapsulates the year, month, and day components, with validation to ensure the date is valid.

• year : Year.Offset

  The year component of the date. It is represented as an Offset type from Year.

• month : Month.Ordinal

  The month component of the date. It is represented as an Ordinal type from Month.

• day : Day.Ordinal

  The day component of the date. It is represented as an Ordinal type from Day.

• valid : self.year.Valid self.month self.day

  Validates the date by ensuring that the year, month, and day form a correct and valid date.

theorem Std.Time.PlainDate.ext {x y : PlainDate} (year : x.year = y.year) (month : x.month = y.month) (day : x.day = y.day) : x = y

theorem Std.Time.PlainDate.ext_iff {x y : PlainDate} : x = y ↔ x.year = y.year ∧ x.month = y.month ∧ x.day = y.day

@[implicit_reducible]

instance Std.Time.instReprPlainDate : Repr PlainDate

def Std.Time.instReprPlainDate.repr : PlainDate → Nat → Std.Format

@[implicit_reducible]

instance Std.Time.instDecidableEqPlainDate : DecidableEq PlainDate

def Std.Time.instDecidableEqPlainDate.decEq (x✝ x✝¹ : PlainDate) : Decidable (x✝ = x✝¹)

@[implicit_reducible]

instance Std.Time.instInhabitedPlainDate : Inhabited PlainDate

@[implicit_reducible]

instance Std.Time.instOrdPlainDate : Ord PlainDate

theorem Std.Time.PlainDate.compare_def : compare = compareLex (compareOn fun (x : PlainDate) => x.year) (compareLex (compareOn fun (x : PlainDate) => x.month) (compareOn fun (x : PlainDate) => x.day))

instance Std.Time.instTransOrdPlainDate : TransOrd PlainDate

instance Std.Time.instLawfulEqOrdPlainDate : LawfulEqOrd PlainDate

@[inline]

def Std.Time.PlainDate.ofYearMonthDayClip (year : Year.Offset) (month : Month.Ordinal) (day : Day.Ordinal) : PlainDate

Creates a PlainDate by clipping the day to ensure validity. This function forces the date to be valid by adjusting the day to fit within the valid range to fit the given month and year.

@[implicit_reducible]

instance Std.Time.PlainDate.instInhabited : Inhabited PlainDate

@[inline]

def Std.Time.PlainDate.ofYearMonthDay? (year : Year.Offset) (month : Month.Ordinal) (day : Day.Ordinal) : Option PlainDate

Creates a new PlainDate from year, month, and day components.

@[inline]

def Std.Time.PlainDate.ofYearOrdinal (year : Year.Offset) (ordinal : Day.Ordinal.OfYear year.isLeap) : PlainDate

Creates a PlainDate from a year and a day ordinal within that year.

def Std.Time.PlainDate.ofDaysSinceUNIXEpoch (day : Day.Offset) : PlainDate

Creates a PlainDate from the number of days since the UNIX epoch (January 1st, 1970).

def Std.Time.PlainDate.weekOfMonth (date : PlainDate) : Internal.Bounded.LE 1 5

Returns the unaligned week of the month for a PlainDate (day divided by 7, plus 1).

def Std.Time.PlainDate.quarter (date : PlainDate) : Internal.Bounded.LE 1 4

Determines the quarter of the year for the given PlainDate.

def Std.Time.PlainDate.dayOfYear (date : PlainDate) : Day.Ordinal.OfYear date.year.isLeap

Transforms a PlainDate into a Day.Ordinal.OfYear.

@[inline]

def Std.Time.PlainDate.era (date : PlainDate) : Year.Era

Determines the era of the given PlainDate based on its year.

@[inline]

def Std.Time.PlainDate.inLeapYear (date : PlainDate) : Bool

Checks if the PlainDate is in a leap year.

def Std.Time.PlainDate.toDaysSinceUNIXEpoch (date : PlainDate) : Day.Offset

Converts a PlainDate to the number of days since the UNIX epoch.

@[inline]

def Std.Time.PlainDate.addDays (date : PlainDate) (days : Day.Offset) : PlainDate

Adds a given number of days to a PlainDate.

@[inline]

def Std.Time.PlainDate.subDays (date : PlainDate) (days : Day.Offset) : PlainDate

Subtracts a given number of days from a PlainDate.

@[inline]

def Std.Time.PlainDate.addWeeks (date : PlainDate) (weeks : Week.Offset) : PlainDate

Adds a given number of weeks to a PlainDate.

@[inline]

def Std.Time.PlainDate.subWeeks (date : PlainDate) (weeks : Week.Offset) : PlainDate

Subtracts a given number of weeks from a PlainDate.

def Std.Time.PlainDate.addMonthsClip (date : PlainDate) (months : Month.Offset) : PlainDate

Adds a given number of months to a PlainDate, clipping the day to the last valid day of the month.

@[inline]

def Std.Time.PlainDate.subMonthsClip (date : PlainDate) (months : Month.Offset) : PlainDate

Subtracts Month.Offset from a PlainDate, it clips the day to the last valid day of that month.

def Std.Time.PlainDate.rollOver (year : Year.Offset) (month : Month.Ordinal) (day : Day.Ordinal) : PlainDate

Creates a PlainDate by rolling over the extra days to the next month.

@[inline]

def Std.Time.PlainDate.withYearClip (dt : PlainDate) (year : Year.Offset) : PlainDate

Creates a new PlainDate by adjusting the year to the given year value. The month and day remain unchanged, and any invalid days for the new year will be handled according to the clip behavior.

@[inline]

def Std.Time.PlainDate.withYearRollOver (dt : PlainDate) (year : Year.Offset) : PlainDate

Creates a new PlainDate by adjusting the year to the given year value. The month and day are rolled over to the next valid month and day if necessary.

def Std.Time.PlainDate.addMonthsRollOver (date : PlainDate) (months : Month.Offset) : PlainDate

Adds a given number of months to a PlainDate, rolling over any excess days into the following month.

@[inline]

def Std.Time.PlainDate.subMonthsRollOver (date : PlainDate) (months : Month.Offset) : PlainDate

Subtracts Month.Offset from a PlainDate, rolling over excess days as needed.

@[inline]

def Std.Time.PlainDate.addYearsRollOver (date : PlainDate) (years : Year.Offset) : PlainDate

Adds Year.Offset to a PlainDate, rolling over excess days to the next month, or next year.

@[inline]

def Std.Time.PlainDate.subYearsRollOver (date : PlainDate) (years : Year.Offset) : PlainDate

Subtracts Year.Offset from a PlainDate, rolling over excess days to the next month.

@[inline]

def Std.Time.PlainDate.addYearsClip (date : PlainDate) (years : Year.Offset) : PlainDate

Adds Year.Offset to a PlainDate, clipping the day to the last valid day of the month.

@[inline]

def Std.Time.PlainDate.subYearsClip (date : PlainDate) (years : Year.Offset) : PlainDate

Subtracts Year.Offset from a PlainDate, clipping the day to the last valid day of the month.

@[inline]

def Std.Time.PlainDate.withDaysClip (dt : PlainDate) (days : Day.Ordinal) : PlainDate

Creates a new PlainDate by adjusting the day of the month to the given days value, with any out-of-range days clipped to the nearest valid date.

@[inline]

def Std.Time.PlainDate.withDaysRollOver (dt : PlainDate) (days : Day.Ordinal) : PlainDate

Creates a new PlainDate by adjusting the day of the month to the given days value, with any out-of-range days rolled over to the next month or year as needed.

@[inline]

def Std.Time.PlainDate.withMonthClip (dt : PlainDate) (month : Month.Ordinal) : PlainDate

Creates a new PlainDate by adjusting the month to the given month value. The day remains unchanged, and any invalid days for the new month will be handled according to the clip behavior.

@[inline]

def Std.Time.PlainDate.withMonthRollOver (dt : PlainDate) (month : Month.Ordinal) : PlainDate

Creates a new PlainDate by adjusting the month to the given month value. The day is rolled over to the next valid month if necessary.

def Std.Time.PlainDate.weekday (date : PlainDate) : Weekday

Calculates the Weekday of a given PlainDate using Zeller's Congruence for the Gregorian calendar.

def Std.Time.PlainDate.alignedWeekOfMonth (date : PlainDate) : Week.Ordinal.OfMonth

Determines the week of the month for the given PlainDate. The week of the month is calculated based on the day of the month and the weekday. Each week starts on Monday because the entire library is based on the Gregorian Calendar.

def Std.Time.PlainDate.withWeekday (date : PlainDate) (desiredWeekday : Weekday) : PlainDate

Sets the date to the specified desiredWeekday. If the desiredWeekday is the same as the current weekday, the original date is returned without modification. If the desiredWeekday is in the future, the function adjusts the date forward to the next occurrence of that weekday.

def Std.Time.PlainDate.weekOfYear (date : PlainDate) : Week.Ordinal

Calculates the week of the year starting Monday for a given year.

@[implicit_reducible]

instance Std.Time.PlainDate.instHAddOffset : HAdd PlainDate Day.Offset PlainDate

@[implicit_reducible]

instance Std.Time.PlainDate.instHSubOffset : HSub PlainDate Day.Offset PlainDate

@[implicit_reducible]

instance Std.Time.PlainDate.instHAddOffset_1 : HAdd PlainDate Week.Offset PlainDate

@[implicit_reducible]

instance Std.Time.PlainDate.instHSubOffset_1 : HSub PlainDate Week.Offset PlainDate