CKTIS / Python
Desfase UTC fijo y formato de fecha y hora con `strftime` e `isoformat`
Asocia un desfase fijo respecto a UTC sin cambiar la hora del reloj y representa el mismo valor en un formato personalizado y en el formato ISO 8601.
Versión: Python 3.12
Sintaxis
dt.replace(tzinfo=tz) -> datetime
dt.astimezone(tz) -> datetime
dt.strftime(format) -> str
dt.isoformat(sep='T', timespec='auto') -> strEn Python 3.12, dt.replace(tzinfo=tz) devuelve un nuevo objeto datetime.datetime con tzinfo asignado, sin cambiar la fecha ni la hora del reloj. Usa este método cuando sepas que la hora local registrada corresponde a ese desfase. timezone(timedelta(...)) representa un desfase fijo respecto a UTC, no una zona con reglas de horario de verano.
Asociar un desfase no es una conversión. Para un datetime con información de zona horaria (en inglés, aware), dt.astimezone(tz) conserva el mismo instante y ajusta, si hace falta, la fecha y la hora a la zona de destino. Sustituir tzinfo por un desfase distinto conserva la hora del reloj, pero cambia el instante representado.
dt.strftime(format) devuelve una cadena que sigue el patrón indicado. En el ejemplo, %d/%m/%Y %H:%M:%S %z coloca el día antes del mes, omite las fracciones de segundo y escribe el desfase como +0530. Con un objeto sin información de zona horaria (en inglés, naive), %z produce una cadena vacía. La compatibilidad con algunas directivas varía según la plataforma, y los nombres de los meses dependen de la configuración regional.
dt.isoformat() devuelve la fecha y la hora como una cadena y añade el desfase si utcoffset() no devuelve None. sep es un solo carácter que separa la fecha de la hora; por defecto es 'T'. El resultado no siempre cumple la norma ISO 8601: sep puede ser un carácter que la norma no admite e, incluso con el separador predeterminado, el desfase respecto a UTC puede contener segundos o fracciones de segundo, que la norma no admite en los desfases. Con timespec='auto' se muestran los segundos y se añaden seis cifras decimales solo cuando los microsegundos no son cero. Una opción más breve, como timespec='milliseconds', trunca en lugar de redondear; un timespec no válido provoca ValueError. Ninguno de los dos métodos de formato modifica el objeto.
Ejemplos
from datetime import datetime, timedelta, timezone
wall_time = datetime(2025, 3, 29, 14, 5, 6, 987654)
fixed_offset = timezone(timedelta(hours=5, minutes=30))
annotated = wall_time.replace(tzinfo=fixed_offset)
print(annotated.strftime('%d/%m/%Y %H:%M:%S %z'))
print(annotated.isoformat(timespec='milliseconds'))Resultado
29/03/2025 14:05:06 +0530 2025-03-29T14:05:06.987+05:30
Tras asociar `+05:30`, el reloj sigue marcando `14:05:06`. La primera línea usa el formato personalizado con `+0530`; la segunda usa el formato ISO con `+05:30` y la fracción `.987`.
Lecciones relacionadas
- Python · Lección 31 · Intermedio · Versión: 3
Fuentes
- Python 3.12 datetime documentation — datetime.isoformat
- Python 3.12 datetime documentation — datetime.replace
- Python 3.12 datetime documentation — datetime.astimezone
- Python 3.12 datetime documentation — timezone Objects
- Python 3.12 datetime documentation — datetime.strftime
- Python 3.12 datetime documentation — strftime() and strptime() Behavior