CKTIS / Python
Associar um desvio UTC com datetime.replace()
Associa um desvio fixo e conhecido em relação a UTC sem alterar a data nem a hora indicada e apresenta o resultado num formato personalizado ou em formato ISO 8601.
Versão: Python 3.12
Sintaxe
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()Em Python 3.12, datetime.datetime.replace é um método de instância da classe datetime do módulo datetime. Devolve um novo objeto com os campos indicados substituídos e os campos omitidos copiados do original. Não é uma operação aritmética sobre o tempo: por exemplo, hour=24 lança ValueError em vez de avançar para o dia seguinte.
Se sabes que a hora registada corresponde ao desvio +02:00, cria tz = timezone(timedelta(hours=2)) e chama dt.replace(tzinfo=tz). Um objeto sem informação de fuso horário (naive) passa a tê-la (aware), mas a data e a hora indicada mantêm-se. Um desvio fixo não tem em conta as mudanças da hora de verão. dt.replace(tzinfo=None) remove a informação de fuso horário sem converter a data nem a hora.
Para representar o mesmo instante noutro fuso, chama astimezone(tz) num objeto que já tenha informação de fuso horário: a data ou a hora pode mudar, mas o instante é preservado. Num objeto naive, astimezone() assume o fuso local do sistema. O argumento fold só pode ser passado pelo nome. Num intervalo de hora local que se repete, 0 seleciona o primeiro instante e 1 o segundo. Se omitires fold, o valor original é mantido.
strftime() segue uma cadeia de formatação explícita; aqui, %z produz +0200. O conjunto completo de diretivas suportadas depende da plataforma. Sem argumentos, isoformat() devolve uma cadeia ISO 8601 com o separador T e o desvio +02:00. Nenhum dos métodos altera o objeto ou converte a hora.
Exemplos
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
As duas linhas mantêm `09:30:00`. O formato personalizado coloca o dia antes do mês e escreve `+0200`; o formato ISO 8601 escreve `+02:00`.
Lições relacionadas
- Python · Lição 31 · Intermédio · Versão: 3
Fontes
- 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