Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

Asignar un desfase UTC con datetime.replace()

Asigna un desfase fijo y conocido respecto de UTC sin cambiar la fecha ni la hora del reloj, y genera una cadena personalizada o una cadena en formato ISO 8601.

Versión: Python 3.12

Sintaxis

dt.replace(year=dt.year, month=dt.month, day=dt.day, hour=dt.hour, minute=dt.minute, second=dt.second, microsecond=dt.microsecond, tzinfo=dt.tzinfo, fold=dt.fold)
aware = dt.replace(tzinfo=timezone(timedelta(hours=2)))
aware.strftime("%d/%m/%Y %H:%M:%S %z")
aware.isoformat()

En Python 3.12, datetime.datetime.replace es un método de instancia de la clase datetime del módulo datetime. Devuelve un objeto nuevo con los campos indicados sustituidos y los campos omitidos copiados del original. No es aritmética temporal: por ejemplo, hour=24 lanza ValueError en lugar de pasar al día siguiente.

Si sabes que la hora registrada corresponde a +02:00, crea tz = timezone(timedelta(hours=2)) y llama a dt.replace(tzinfo=tz). Un objeto ingenuo (naive) pasa a tener información de zona horaria (aware), pero mantiene la fecha y la hora del reloj. Un desfase fijo no tiene en cuenta los cambios de horario de verano. dt.replace(tzinfo=None) elimina la información de zona sin convertir la fecha ni la hora.

Para representar el mismo instante en otra zona, llama a astimezone(tz) sobre un objeto que ya tenga información de zona: la fecha o la hora puede cambiar, pero el instante se conserva. Si el objeto es ingenuo, astimezone() presupone la zona local del sistema. El argumento fold solo puede pasarse por nombre. En un intervalo local que se repite, 0 selecciona el instante anterior y 1 el posterior. Si se omite fold, se conserva su valor original.

strftime() sigue una cadena de formato explícita; aquí %z produce +0200. El conjunto completo de directivas admitidas depende de la plataforma. Sin argumentos, isoformat() devuelve una cadena ISO 8601 con el separador T y el desfase +02:00. Ninguno de los dos métodos modifica el objeto ni convierte la hora.

Ejemplos

from datetime import datetime, timedelta, timezone

wall_time = datetime(2024, 6, 15, 9, 30)
fixed_offset = timezone(timedelta(hours=2))
aware = wall_time.replace(tzinfo=fixed_offset)

print(aware.strftime("%d/%m/%Y %H:%M:%S %z"))
print(aware.isoformat())

Resultado

15/06/2024 09:30:00 +0200
2024-06-15T09:30:00+02:00

Las dos líneas conservan `09:30:00`. El formato personalizado pone el día antes del mes y escribe `+0200`; el formato ISO 8601 escribe `+02:00`.

Lecciones relacionadas

  • Python · Lección 31 · Intermedio · Versión: 3

Fuentes