CKTIS / Python
Desvio fixo de UTC e formatação com `strftime` e `isoformat`
Associe um desvio fixo em relação a UTC sem alterar a hora indicada pelo relógio e apresente o mesmo valor num formato personalizado e no formato ISO 8601.
Versão: Python 3.12
Sintaxe
dt.replace(tzinfo=tz) -> datetime
dt.astimezone(tz) -> datetime
dt.strftime(format) -> str
dt.isoformat(sep='T', timespec='auto') -> strEm Python 3.12, dt.replace(tzinfo=tz) devolve um novo objeto datetime.datetime com tzinfo definido, sem alterar a data nem a hora indicada pelo relógio. Use este método quando souber que a hora local registada corresponde a esse desvio. timezone(timedelta(...)) representa um desvio fixo em relação a UTC, não um fuso horário com regras de hora de verão.
Associar um desvio não é o mesmo que converter a hora. Num datetime com informação de fuso horário (em inglês, aware), dt.astimezone(tz) conserva o mesmo instante e ajusta, se necessário, a data e a hora ao fuso de destino. Substituir tzinfo por um desvio diferente mantém a hora indicada pelo relógio, mas muda o instante representado.
dt.strftime(format) devolve uma cadeia de caracteres de acordo com o padrão fornecido. No exemplo, %d/%m/%Y %H:%M:%S %z coloca o dia antes do mês, omite as frações de segundo e escreve o desvio como +0530. Num objeto sem informação de fuso horário (em inglês, naive), %z produz uma cadeia vazia. O suporte de algumas diretivas varia consoante a plataforma, e os nomes dos meses dependem das definições regionais.
dt.isoformat() devolve a data e a hora como uma cadeia de caracteres e acrescenta o desvio se utcoffset() não devolver None. sep é o único carácter que separa a data da hora; por omissão é 'T'. O resultado nem sempre está em conformidade com a norma ISO 8601: sep pode ser um carácter que a norma não admite e, mesmo com o separador predefinido, o desvio em relação a UTC pode conter segundos ou frações de segundo, que a norma não admite nos desvios. Com timespec='auto' são apresentados os segundos e só se acrescentam seis algarismos decimais quando os microssegundos não são zero. Uma opção mais curta, como timespec='milliseconds', trunca em vez de arredondar; um valor inválido de timespec lança ValueError. Nenhum dos dois métodos de formatação modifica o objeto.
Exemplos
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
Depois de associar `+05:30`, o relógio continua a marcar `14:05:06`. A primeira linha usa o formato personalizado com `+0530`; a segunda usa o formato ISO com `+05:30` e a fração `.987`.
Lições relacionadas
- Python · Lição 31 · Intermédio · Versão: 3
Fontes
- 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