class date – Represent a date
A representation of a date, according to the Gregorian calendar.
date objects support equality and comparison operators.
- class datetime.date(year, month, day)
Construct a date object representing the given
year,monthandday.Arguments must be integers in the following ranges:
- classmethod today()
Construct a date object representing today’s year, month and day.
- classmethod fromtimestamp(timestamp)
Construct a date object representing the year, month and day specified by the provided
timestamp.A
timestampin this case is a floating point number representing the number of seconds since the epoch (January 1, 1970, 00:00:00 UTC).
- classmethod fromordinal(ordinal)
Construct a date object representing the year, month and day specified by the provided
ordinal.An
ordinalis an integer representing the number of days since January 1st of year 1.
- classmethod fromisoformat(date_string)
Construct a date object from a string in ISO 8601 format:
from datetime import date d = date.fromisoformat('2012-12-21')
- min
The earliest representable date,
date(datetime.MINYEAR, 1, 1).
- max
The latest representable date,
date(datetime.MAXYEAR, 12, 31).
- resolution
The smallest possible difference between non-equal date objects,
timedelta(days=1).
- month
The month of the date, an integer in the range
1to12.
- day
The day of the date, an integer in the range
1to the number of days in the month represented bymonth.
- replace(year=self.year, month=self.month, day=self.day)
Return a new
dateobject with the same values as the existing date object, but with the specified parameters updated.
- tuple()
Return the date as a 3-tuple
(year, month, day).
- timetuple()
Return the date as a 9-tuple
(year, month, day, hour, minute, second, weekday, yearday, dst), as described indatetime.datetime.timetuple().In this case:
hour,minuteandsecondare all0, as the date object does not contain time information.weekdayis the day of the week as an integer, where Monday is0and Sunday is6.yeardayis the day of the year as an integer, where January 1st is1.dstis-1, as the date object does not contain daylight savings information.
- toordinal()
Return an integer representing the ordinal of the date, where January 1st of year 1 has ordinal
1.
- isoformat()
Return a string representing the date in ISO 8601 format,
YYYY-MM-DD:from datetime import date date(2002, 12, 4).isoformat() # outputs '2002-12-04'
- isoweekday()
Return the day of the week as an integer, where Monday is
1and Sunday is7.
- weekday()
Return the day of the week as an integer, where Monday is
0and Sunday is6.