Método Python DateTime astimezone()

La función astimezone() se usa para devolver una instancia de DateTime según el parámetro de zona horaria especificado tz. 

Nota: La instancia de DateTime devuelta tiene el nuevo valor de desplazamiento UTC según el parámetro tz. Y si esta función no toma el parámetro tz, entonces el objeto DateTime devuelto tendrá la fecha, la hora y la zona horaria locales.

Sintaxis: astimezone(tz=Ninguno)

Parámetros: Esta función acepta un parámetro opcional que se ilustra a continuación:

• tz: Esta es la zona horaria especificada.

Valores devueltos: esta función devuelve una instancia de fecha y hora de acuerdo con el parámetro de zona horaria especificado tz. Si no se especifica el parámetro tz, esta función devuelve la fecha, la hora y la zona horaria locales.

Ejemplo 1: En el siguiente ejemplo, la función astimezone() toma el objeto de zona horaria de Singapur como su parámetro. La función timedelta() de Singapur toma 5 horas como parámetro y su valor devuelto se toma como parámetro de la función timezone(). De esta forma, se inicializa un objeto DateTime junto con la zona horaria de Singapur para que la función astimezone() devuelva su correspondiente instancia de fecha y hora.

# Python3 code for getting
# a datetime instance according
# to the specified time zone parameter tz
 
# Importing datetime module
import datetime
 
# Specifying Singapore timedelta and timezone
# object
sgtTimeDelta = datetime.timedelta(hours=5)
sgtTZObject = datetime.timezone(sgtTimeDelta,
                                name="SGT")
 
# Specifying a datetime along with Singapore
# timezone object
d1 = datetime.datetime(2021, 8, 4, 10,
                       00, 00, 00, sgtTZObject)
 
# Calling the astimezone() function over the above
# specified Singapore timezone
d2 = d1.astimezone(sgtTZObject)
 
# Printing a datetime instance as per the above
# specified Singapore timezone
print("Singapore time from a datetime instance:{}".format(d2))

Producción:

Hora de Singapur de una instancia de fecha y hora: 2021-08-04 10:00:00+05:00

Ejemplo 2: En el siguiente ejemplo, la función astimezone() no acepta ningún parámetro, por lo que esta función devuelve el objeto DateTime con la fecha, la hora y la zona horaria locales actuales. Aquí se devuelven la fecha, la hora y la zona horaria actuales debido a la función datetime.now().

# Python3 code for getting
# a datetime instance according
# to the specified time zone parameter tz
 
# Importing datetime module
import datetime
 
# Calling now() function to return
# current datetime
d1 = datetime.datetime.now()
 
# Calling the astimezone() function without
# any timezone parameter
d2 = d1.astimezone()
 
# Printing the local current date, time and
# timezone
print(format(d2))

Producción:

2021-08-04 06:41:15.128046+00:00