Home » Python » Python Reference » Python date Class

Python date timetuple() Method with Example

Python date.timetuple() Method: In this tutorial, we will learn about the timetuple() method of date class in Python with its usage, syntax, and examples. By Hritika Rajput Last updated : April 22, 2023

Python date.timetuple() Method

The date.timetuple() method returns a time.struct_time which is an object with a named tuple interface containing nine elements.

The time.struct_time Object Values

Following values are present in time.struct_time object:

Index	Attribute	Value
0	tm_year	(for example, 1993)
1	tm_mon	range [1, 12]
2	tm_mday	range [1, 31]
3	tm_hour	range [0, 23]
4	tm_min	range [0, 59]
5	tm_sec	range [0, 61]
6	tm_wday	range [0, 6], Monday is 0
7	tm_yday	range [1, 366]
8	tm_isdst	0, 1 or -1; see below
N/A	tm_zone	abbreviation of timezone name
N/A	tm_gmtoff	offset east of UTC in seconds

A date timetuple is equivalent to,

time.struct_time((d.year, d.month, d.day, 0, 0, 0, d.weekday(), yday, -1))

Since it is a date object, time values are missing because of which those attributes are set to zero(index- 3,4,5). As date object is naive, the timezone information are also missing.

Module

The following module is required to use timetuple() method:

import datetime

Class

The following class is required to use timetuple() method:

from datetime import date

Syntax

The following is the syntax of timetuple() method:

timetuple()

Parameter(s)

The following are the parameter(s):

• None

Return Value

The return type of this method is a time.struct_time object which contains date information.

Example of date timetuple() Method in Python

## Python program explaining the 
## use of date class instance methods

from datetime import date

## Creating an instance
x = date(2020, 4, 29)
print("Current date is:", x)
print()

d = x.timetuple()
print("The tuple of the date object", d)
print()

print("We can also access individual elements of this tuple")
for i in d:
    print(i)

Output

Current date is: 2020-04-29

The tuple of the date object time.struct_time(tm_year=2020, tm_mon=4, tm_mday=29, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=2, tm_yday=120, tm_isdst=-1)

We can also access individual elements of this tuple
2020
4
29
0
0
0
2
120
-1

---