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
- Python 3.12 datetime documentation: datetime.replace()
- Python 3.12 datetime documentation: datetime.astimezone()
- Python 3.12 datetime documentation: timezone
- Python 3.12 datetime documentation: datetime.strftime()
- Python 3.12 datetime documentation: strftime() and strptime() Behavior
- Python 3.12 datetime documentation: datetime.isoformat()
- PEP 495 – Local Time Disambiguation