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

filter_none

edit
close

play_arrow

link
brightness_4
code

# 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)

chevron_right


Output:

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

filter_none

edit
close

play_arrow

link
brightness_4
code

# 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 beacause
# fractions in 950000000.81956
# i.e .81956 will be ignored

chevron_right


Output:

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




My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.


Article Tags :

Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.