Python | time.localtime() method
Time module in Python provides various time-related functions. This module comes under Python’s standard utility modules.
time.localtime() method of Time module is used to convert a time expressed in seconds since the epoch to a time.struct_time object in local time.
To convert the given time in seconds since the epoch to a time.struct_time object in UTC, time.gmtime() 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.localtime([secs])
Parameter:
secs (optional): An integer or float value representing time in seconds. Fractions of specified seconds will be ignored. If 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.localtime() method
Python3
# Python program to explain time.localtime() 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 Local time obj = time.localtime() # Print the time.struct.time object print (obj) # We can change it to # Day Mon date Hour:Min:Sec year # format using time.asctime() method t = time.asctime(obj) print (t) |
time.struct_time(tm_year=2019, tm_mon=8, tm_mday=22, tm_hour=10, tm_min=3, tm_sec=15, tm_wday=3, tm_yday=234, tm_isdst=0) Thu Aug 22 10:03:15 2019
Code #2: Use of time.localtime() method
Python3
# Python program to explain time.localtime() method # importing time module import time # Time in seconds # since the epoch secs = 950000000 # Convert the given time in seconds # since the epoch to a # time.struct_time object in local time # using time.localtime() method obj = time.localtime(secs) # Print the time.struct_time object print ( "time.struct_time object for seconds =" , secs) print (obj) # Time in seconds # since the epoch secs = 950000000.81956 # Convert the given time in seconds # since the epoch to a # time.struct_time object in local time # using time.localtime() method obj = time.localtime(secs) # Print the time.struct_time object print ( "\ntime.struct_time object for seconds =" , secs) print (obj) # Output for secs = 950000000 # and secs = 950000000.81956 # will be same because # fractions in 950000000.81956 # i.e .81956 will be ignored |
time.struct_time object for seconds = 950000000 time.struct_time(tm_year=2000, tm_mon=2, tm_mday=8, tm_hour=14, tm_min=23, tm_sec=20, tm_wday=1, tm_yday=39, tm_isdst=0) time.struct_time object for seconds = 950000000.81956 time.struct_time(tm_year=2000, tm_mon=2, tm_mday=8, tm_hour=14, tm_min=23, tm_sec=20, tm_wday=1, tm_yday=39, tm_isdst=0)
Reference: https://docs.python.org/3/library/time.html#time.localtime