Thursday, September 4, 2025
HomeLanguagesPython | time.gmtime() method

Python | time.gmtime() method

Time module in Python provides various time-related functions. This module comes under Python’s standard utility modules.

time.gmtime() method of Time module is used to convert a time expressed in seconds since the epoch to a time.struct_time object in UTC in which tm_isdst attribute is always 0.
To convert the given time in seconds since the epoch to a time.struct_time object in local time, time.localtime() method is used.

This method returns a time.struct_time object with a named tuple interface. Following are the values present in time.struct_time object:

Index Attribute Values
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
N/A tm_zone abbreviation of timezone name
N/A tm_gmtoff offset east of UTC in seconds

Syntax: time.gmtime([secs])

Parameter:
secs (optional): An integer or float value representing time in seconds. Fractions of specified seconds will be ignored. If the secs parameter is not provided or None then the current time as returned by time.time() method is used.

Return type: This method returns an object of class ‘time.struct_time’.

Code #1: Use of time.gmtime() method

Python3




# Python program to explain time.gmtime() method
  
# importing time module
import time
  
  
# If secs parameter
# is not given then
# the current time  
# as returned by time.time() method
# is used
  
# Convert the current time in seconds
# since the epoch to a
# time.struct_time object in UTC
obj = time.gmtime()
  
# Print the time.struct.time object
print(obj)


Output:

time.struct_time(tm_year=2019, tm_mon=8, tm_mday=22, tm_hour=3, tm_min=53,
tm_sec=32, tm_wday=3, tm_yday=234, tm_isdst=0)

Code #2: Use of time.gmtime() method

Python3




# Python program to explain time.gmtime() method
  
# importing time module
import time
  
  
# Time in seconds
# since the epoch
secs = 40000
  
# Convert the given time in seconds
# since the epoch to a
# time.struct_time object in UTC
# using time.gmtime() method
obj = time.gmtime(secs)
  
# Print the time.struct_time object
print("time.struct_time object for seconds =", secs)
print(obj)
  
  
# Time in seconds
# since the epoch
secs = 40000.7856
  
# Convert the given time in seconds
# since the epoch to a
# time.struct_time object in UTC
# using time.gmtime() method
obj = time.gmtime(secs)
  
# Print the time.struct_time object
print("\ntime.struct_time object for seconds =", secs)
print(obj)
  
  
# Output for sec = 40000 
# and secs = 40000.7856
# will be same because
# fractions in 40000.7856
# i.e .7856 will be ignored


Output:

time.struct_time object for seconds = 40000
time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=11, tm_min=6,
tm_sec=40, tm_wday=3, tm_yday=1, tm_isdst=0)

time.struct_time object for seconds = 40000.7856
time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=11, tm_min=6,
tm_sec=40, tm_wday=3, tm_yday=1, tm_isdst=0)

Reference: https://docs.python.org/3/library/time.html#time.gmtime

RELATED ARTICLES

Most Popular

Dominic
32261 POSTS0 COMMENTS
Milvus
81 POSTS0 COMMENTS
Nango Kala
6626 POSTS0 COMMENTS
Nicole Veronica
11795 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11855 POSTS0 COMMENTS
Shaida Kate Naidoo
6747 POSTS0 COMMENTS
Ted Musemwa
7023 POSTS0 COMMENTS
Thapelo Manthata
6695 POSTS0 COMMENTS
Umr Jansen
6714 POSTS0 COMMENTS