Home » Python » Python Reference » Python datetime Class

Python datetime timetuple() Method with Example

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

Python datetime.timetuple() Method

The datetime.timetuple() method works on an instance of the class, and it returns a time.struct_time which is an object with a named tuple interface containing nine elements.

time.struct_time 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 datetime timetuple is equivalent to,

time.struct_time((d.year, d.month, d.day, d.hour, d.minute, d.second, d.weekday(), yday, dst))

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 datetime

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 and time information.

Example of datetime timetuple() Method in Python

## Python program explaining the 
## use of datetime timetuple() method

from datetime import datetime

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

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

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

x = datetime.now()
print("The tuple of the datetime object:", x.timetuple())

Output

Current date is: 2020-04-29 10:50:40
The tuple of the datetime object time.struct_time(tm_year=2020, tm_mon=4, tm_mday=29, tm_hour=10, tm_min=50, tm_sec=40, tm_wday=2, tm_yday=120, tm_isdst=-1)

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

The tuple of the datetime object: time.struct_time(tm_year=2020, tm_mon=5, tm_mday=2, tm_hour=6, tm_min=22, tm_sec=38, tm_wday=5, tm_yday=123, tm_isdst=-1)

---