Python DateTime – Date Class

The object of the Date class represents the naive date containing year, month, and date according to the current Gregorian calendar. This date can be extended indefinitely in both directions. The January 1 of year 1 is called day 1 and January 2 or year 2 is called day 2 and so on.

Syntax:

class datetime.date(year, month, day)

The arguments must be in the following range –

• MINYEAR(1) <= year <= MAXYEAR(9999)
• 1 <= month <= 12
• 1 <= day <= number of days in the given month and year

Note: If the argument is not an integer it will raise a TypeError and if it is outside the range a ValueError will be raised. 

Example:

Date passed as argument is 2020-12-11

Class Attributes

Let’s see the attributes provided by this class – 

Example 1: Getting min and max representable date 

Min Date supported 0001-01-01
Max Date supported 9999-12-31

Example 2: Accessing the year, month, and date attribute from the date class

Year: 2020
Month: 12
Day: 11

Class Functions

 Date class provides various functions to work with date object, like we can get the today’s date, date from the current timestamp, date from the proleptic Gregorian ordinal, where January 1 of year 1 has ordinal 1, etc. Let’s see the list of all the functions provided by this class – 

List of all Date Class functions

Let’s see certain examples of the above functions

Example 1: Getting the current date and also change the date to string

Today's date is 2021-07-23
String Representation 2021-07-23
<class 'str'>

Example 2: Getting the weekday from the day and proleptic Gregorian ordinal

Weekday using weekday(): 4
Weekday using isoweekday(): 5
proleptic Gregorian ordinal: 737994
Date from ordinal 2018-11-02

Note: For more information on Python Datetime, refer to Python Datetime Tutorial