CKTIS / Python
strftime: formatar data e hora com um desvio face a UTC
Associe um desvio fixo e conhecido face a UTC sem alterar a data nem a hora e apresente o mesmo valor num formato personalizado e no formato ISO 8601.
Versão: Python 3.12
Sintaxe
dt.strftime(format) -> str
dt.replace(tzinfo=offset) -> datetime
dt.isoformat(sep='T', timespec='auto') -> strEm Python 3.12, strftime(format) é um método de instância de datetime.datetime. Devolve uma str de acordo com a cadeia de formato indicada, sem modificar o objeto. No exemplo, %d/%m/%Y apresenta o dia, o mês e o ano, e %H:%M:%S apresenta a hora em formato de 24 horas, os minutos e os segundos. As barras, os dois pontos e os espaços são copiados literalmente.
Quando souber que a hora indicada corresponde a um desvio fixo face a UTC, use replace(tzinfo=offset) com um objeto timezone criado a partir de um timedelta. O resultado é um novo datetime com informação de fuso horário (aware), com a mesma data e hora. A operação associa um desvio sem converter a hora; um desvio fixo não acompanha as mudanças da hora de verão. Para representar o mesmo instante noutro fuso, use astimezone() num datetime que já tenha informação de fuso horário.
%z apresenta o desvio face a UTC: +05:30 passa a +0530; para um datetime sem informação de fuso horário (naive), esta diretiva devolve uma cadeia vazia. %Z apresenta o nome do fuso horário devolvido por tzname() em vez do desvio numérico. Se tzname() devolver None, por exemplo quando tzinfo é None, %Z produz uma cadeia vazia. O conjunto de diretivas suportadas varia consoante a plataforma, e os nomes dos meses e dos dias da semana podem depender das definições regionais.
Use strftime para definir a apresentação e isoformat() para obter uma representação ISO 8601. Ambos os métodos devolvem texto sem modificar o datetime. Por predefinição, isoformat() separa a data da hora com T e escreve o desvio deste exemplo como +05:30.
Exemplos
from datetime import datetime, timedelta, timezone
wall_time = datetime(2024, 6, 15, 9, 5, 7)
offset = timezone(timedelta(hours=5, minutes=30))
aware = wall_time.replace(tzinfo=offset)
print(aware.strftime("%d/%m/%Y %H:%M:%S %z"))
print(aware.isoformat())Resultado
15/06/2024 09:05:07 +0530 2024-06-15T09:05:07+05:30
Ambas as linhas mantêm `09:05:07`: a primeira usa o padrão de `strftime` e termina em `+0530`; a segunda usa `isoformat()` e termina em `+05:30`.
Lições relacionadas
- Python · Lição 31 · Intermédio · Versão: 3