Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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') -> str

Em 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

Fontes