¿Por qué datetime.datetime.utcnow() no contiene información de zona horaria?

datetime.datetime.utcnow()

¿Por qué esto datetime no tiene ninguna información de zona horaria dado que es explícitamente un UTC datetime?

Esperaría que esto contuviera tzinfo.

Tenga en cuenta que para Python 3.2 en adelante, el datetime el módulo contiene datetime.timezone. la documentación para datetime.utcnow() dice:

Se puede obtener una fecha y hora UTC actual al llamar datetime.now(timezone.utc).

Asi que, datetime.utcnow() no se pone tzinfo para indicar que es UTC, pero datetime.now(datetime.timezone.utc) devuelve la hora UTC con tzinfo establecer.

Entonces puedes hacer:

>>> import datetime
>>> datetime.datetime.now(datetime.timezone.utc)
datetime.datetime(2014, 7, 10, 2, 43, 55, 230107, tzinfo=datetime.timezone.utc)

Eso significa que es ingenuo de zona horaria, por lo que no puede usarlo con datetime.astimezone

puedes darle una zona horaria como esta

import pytz  # 3rd party: $ pip install pytz

u = datetime.utcnow()
u = u.replace(tzinfo=pytz.utc) #NOTE: it works only with a fixed utc offset

ahora puedes cambiar las zonas horarias

print(u.astimezone(pytz.timezone("America/New_York")))

Para obtener la hora actual en una zona horaria determinada, puede pasar tzinfo a datetime.now() directamente:

#!/usr/bin/env python
from datetime import datetime
import pytz # $ pip install pytz

print(datetime.now(pytz.timezone("America/New_York")))

Funciona para cualquier zona horaria, incluidas aquellas que observan el horario de verano (DST), es decir, funciona para zonas horarias que pueden tener diferentes compensaciones utc en diferentes momentos (compensación utc no fija). no usar tz.localize(datetime.now()) — puede fallar durante la transición del final del horario de verano cuando la hora local es ambigua.

Las bibliotecas estándar de Python no incluían ninguna clase de tzinfo hasta Python 3.2. Sólo puedo adivinar las razones. Personalmente, creo que fue un error no incluir una clase tzinfo para UTC, porque es lo suficientemente incontrovertible como para tener una implementación estándar. Aunque no hubo implementación en la biblioteca, hay una que se da como ejemplo en el tzinfo documentación.

from datetime import timedelta, tzinfo

ZERO = timedelta(0)

# A UTC class.

class UTC(tzinfo):
    """UTC"""

    def utcoffset(self, dt):
        return ZERO

    def tzname(self, dt):
        return "UTC"

    def dst(self, dt):
        return ZERO

utc = UTC()

Una vez que tenga un UTC tzinfo objeto, todavía no puedes usarlo con utcnow. Para obtener la hora actual como un objeto de fecha y hora consciente:

from datetime import datetime 

now = datetime.now(utc)

En Python 3.2 finalmente pusieron un UTC tzinfo clase en la biblioteca:

from datetime import datetime, timezone 

now = datetime.now(timezone.utc)

En Python 3.9 crearon tzinfo clases para todas las demás zonas horarias. Ver PEP 615 — Compatibilidad con la base de datos de zonas horarias de la IANA en la biblioteca estándar para todos los detalles.

los pytz módulo es una opción, y hay otra python-dateutilque aunque también es un paquete de terceros, es posible que ya esté disponible según sus otras dependencias y sistema operativo.

Solo quería incluir esta metodología como referencia, si ya instaló python-dateutil para otros fines, puede utilizar su tzinfo en lugar de duplicar con pytz

import datetime
import dateutil.tz

# Get the UTC time with datetime.now:
utcdt = datetime.datetime.now(dateutil.tz.tzutc())

# Get the UTC time with datetime.utcnow:
utcdt = datetime.datetime.utcnow()
utcdt = utcdt.replace(tzinfo=dateutil.tz.tzutc())

# For fun- get the local time
localdt = datetime.datetime.now(dateutil.tz.tzlocal())

Tiendo a estar de acuerdo en que las llamadas a utcnow debe incluir la información de la zona horaria UTC. Sospecho que esto no está incluido porque la biblioteca de fecha y hora nativa tiene por defecto las fechas y horas ingenuas para la compatibilidad cruzada.

Para agregar timezone información en Python 3.2+

import datetime

>>> d = datetime.datetime.now(tz=datetime.timezone.utc)
>>> print(d.tzinfo)
'UTC+00:00'

Julien Danjou escribió un buen artículo explicando por qué nunca deberías lidiar con las zonas horarias. Un experto:

De hecho, la API de fecha y hora de Python siempre devuelve objetos de fecha y hora inconscientes, lo cual es muy desafortunado. De hecho, tan pronto como obtenga uno de estos objetos, no hay forma de saber cuál es la zona horaria, por lo tanto, estos objetos son bastante “inútiles” por sí solos.

Por desgracia, a pesar de que puede utilizar utcnow()aún no verá la información de la zona horaria, como descubrió.

Recomendaciones:

• Utilice siempre consciente datetime objetos, es decir, con información de la zona horaria. Eso asegura que pueda compararlos directamente (consciente y no consciente) datetime
  los objetos no son comparables) y los devolverá correctamente a los usuarios. Aprovechar pytz tener objetos de zona horaria.

• Usar ISO 8601 como el formato de cadena de entrada y salida. Usar datetime.datetime.isoformat() para devolver las marcas de tiempo como una cadena formateada con ese formato, que incluye la información de la zona horaria.

• Si necesita analizar cadenas que contienen marcas de tiempo con formato ISO 8601, puede confiar en iso8601, que devuelve marcas de tiempo con información de zona horaria correcta. Esto hace que las marcas de tiempo sean directamente comparables.

el comportamiento de datetime.datetime.utcnow() devolver la hora UTC como un objeto ingenuo de fecha y hora es obviamente problemático y debe solucionarse. Puede dar lugar a resultados inesperados si la zona horaria local de su sistema no es UTC, ya que la biblioteca de fecha y hora supone que el objeto ingenuo de fecha y hora representa la hora local del sistema. Por ejemplo, datetime.datetime.utcnow().timestaamp() da una marca de tiempo de 4 horas antes del valor correcto en mi computadora. Además, a partir de Python 3.6, datetime.astimezone() se puede llamar en instancias de fecha y hora ingenuas, pero datetime.datetime.utcnow().astimezone(any_timezone) da un resultado incorrecto a menos que la zona horaria local de su sistema sea UTC.