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

@[instance_reducible]

instance Std.Time.instReprPlainDate : Repr PlainDate

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

@[instance_reducible]

instance Std.Time.instDecidableEqPlainDate : DecidableEq PlainDate

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

@[instance_reducible]

instance Std.Time.instInhabitedPlainDate : Inhabited PlainDate

@[instance_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.

@[instance_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.ofEpochDay (day : Day.Offset) : PlainDate

Creates a PlainDate from the number of days since January 1st, 1970.

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

Returns the aligned week of the month for a PlainDate. Weeks are fixed 7-day slots starting from day 1: days 1–7 are week 1, days 8–14 are week 2, etc.

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.toEpochDay (date : PlainDate) : Day.Offset

Converts a PlainDate to the number of days since 1970-01-01T00:00:00.

@[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.weekOfMonth (date : PlainDate) (firstDay : Weekday := Weekday.monday) : Week.Ordinal

Returns the week of the month for the given PlainDate, where weeks start on firstDay. The first partial week containing day 1 is week 1, so weeks may span fewer than 7 days.

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.startOfWeekBasedYear (year : Year.Offset) (firstDay : Weekday) (minimalDays : Internal.Bounded.LE 0 6) : PlainDate

Returns the first day of the week-based year for the given year, where weeks start on firstDay and the first week must contain at least minimalDays days of the new year.

def Std.Time.PlainDate.weekOfYear (date : PlainDate) (firstDay : Weekday := Weekday.monday) (minDaysBounded : Internal.Bounded.LE 0 6 := Internal.Bounded.LE.mk 4 weekOfYear._proof_1) : Week.OfYear.Ordinal

Returns the week number within the week-based year for the given PlainDate, using firstDay as the start of the week and minDays as the minimum number of days required in the first week of the year (default 4 for ISO 8601). Dates before the first week of the calendar year are counted as part of the last week of the previous year.

def Std.Time.PlainDate.weekYear (date : PlainDate) (firstDay : Weekday := Weekday.monday) (minDays : Internal.Bounded.LE 0 6 := Internal.Bounded.LE.mk 4 weekOfYear._proof_1) : Year.Offset

Returns the week-based year for the given PlainDate, using firstDay as the start of the week and minDays as the minimum number of days in the first week of the year (default 4 for ISO 8601).

@[instance_reducible]

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

@[instance_reducible]

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

@[instance_reducible]

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

@[instance_reducible]

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