función timetuple() de la clase Datetime.date en Python

El método timetuple() devuelve un objeto de tiempo time.struct que es una tupla con nombre. Un objeto de tupla con nombre tiene atributos a los que se puede acceder mediante un índice o un nombre. El objeto struct time tiene propiedades para los campos de fecha y hora, así como un indicador que especifica si el horario de verano está en vigor o no. Los campos de año, mes y día de la tupla con nombre proporcionada por el método timetuple() se establecerán de acuerdo con el objeto de fecha, pero los valores de hora, minutos y segundos se establecerán en cero. El indicador DST en el objeto devuelto se establecerá en -1. Se puede acceder a las características del objeto de tiempo time.struct por índice o nombre de atributo. El objeto struct time contiene atributos para expresar campos de fecha y hora, que se mantienen en tuplas:

Ejemplo 1: timetuple() con fecha actual.

Aquí vamos a demostrar timetuple() de la fecha actual. La fecha actual se asigna al objeto DateTime y la función timetuple() se usa para recuperar las propiedades del objeto en tuplas, que luego se muestran. También se puede usar un bucle para mostrar las características del objeto.

import datetime
  
# creating current date object
currentDate = datetime.datetime.today()
    
# datetime instance's attributes
# are returned as a tuple.
currentDateTimeTuple = currentDate.timetuple()
    
# showing the object's tuples
print(currentDateTimeTuple)
print()
print("Using a for loop, output the tuple values :")
  
for value in currentDateTimeTuple:
    print(value)

Producción:

time.struct_time(tm_year=2021, tm_mon=8, tm_mday=2, tm_hour=18, tm_min=32, tm_sec=56, tm_wday=0, tm_yday=214, tm_isdst=-1)

Usando un bucle for, genera los valores de tupla:

2021

8

2

18

32

56

0

214

-1

Ejemplo 2: timetuple() con una fecha específica.

Considere otro escenario en el que utilizamos una fecha de Navidad. Se crea el objeto DateTime Christmas y luego el índice de la tupla muestra cada propiedad de ese objeto.

import datetime
  
# creating xmas date object
xmas = datetime.datetime(2021, 12, 25)
    
# datetime instance's attributes
# are returned as a tuple.
xmasTimeTuple = xmas.timetuple()
    
# showing the object's tuples
print(xmasTimeTuple)

Producción:

time.struct_time(tm_year=2021, tm_mon=12, tm_mday=25, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=359, tm_isdst=-1)