= Python Datetime Date =

A '''`datetime.date`''' object represents a date.

<<TableOfContents>>

----



== Usage ==

A `datetime.date` object is constructed as:

{{{
d1 = datetime.date(2020,12,25)
}}}

The components can be accessed like:

{{{
d1.year   # 2020
d1.month  # 12
d1.day    # 25
}}}

----



== Class Functions ==



=== FromIsoCalendar ===

Construct a `datetime.date` from the year, week, and weekday.

----



=== FromIsoFormat ===

To construct a `datetime.date` from any valid ISO 8601 string, try:

{{{
import datetime

datetime.date.fromisoformat('2019-12-04')  #datetime.date(2019, 12, 4)
datetime.date.fromisoformat('20191204')    #datetime.date(2019, 12, 4)
datetime.date.fromisoformat('2021-W01-1')  #datetime.date(2021, 1, 4)
}}}

Note that ordinal dates are not supported by this function.

----



=== FromOrdinal ===

Construct a `datetime.date` from a string like `YYYY-DDD`.

----



=== FromTimeStamp ===

Construct a `datetime.date` from a string representing a POSIX timestamp.

May raise an `OverflowError` or `OSError` depending on the local `libc` (specifically the `localtime()` implementation).

----



=== Today ===

A `datetime.date` representing the current date can be constructed like:

{{{
d1 = datetime.date.today()
}}}

----



== Methods ==

=== CTime ===

Return a string like `Wed Dec  4 00:00:00 2002`.

Equivalent to `time.ctime(time.mktime(d1.timetuple()))`.

----



=== IsoCalendar ===

Return a named tuple like `datetime.IsoCalendarDate(year, week, weekday)`.

----



=== IsoFormat ===

Return a string like `YYYY-MM-DD`.

----



=== IsoWeekDay ===

Return the weekday as an integer between 1 (Monday) and 7 (Sunday).

----



=== StrFTime ===

Return a formatted string timestamp.

See [[Python/Datetime#StrFTime_and_StrPTime|here]] for an explanation of the directives.

----



=== Replace ===

Return a copy of the `datetime.date` with the specified components replaced.

{{{
import datetime
d1 = datetime.date(2020, 12, 25)
d2 = d1.replace(year=2021)
d3 = d2.replace(month=1)
d4 = d3.replace(day=31)
}}}

----



=== TimeTuple ===

Return a time tuple like `time.localtime()`.

Equivalent to `time.struct_time((d1.year, d1.month, d1.day, 0, 0, 0, d1.weekday(), d1.toordinal() - datetime.date(d1.year, 1, 1).toordinal() + 1, -1))`.

----



=== ToOrdinal ===

Return the proleptic Gregorian ordinal.

----



=== WeekDay ===

Return the weekday as an integer between 0 (Monday) and 6 (Sunday).



----
CategoryRicottone