Wie mache ich ein Datetime-Objekt in Python bewusst (nicht naiv)?

Was ich tun muss

Ich habe ein zeitzonenunabhängiges datetime-Objekt, dem ich eine Zeitzone hinzufügen muss, um es mit anderen zeitzonenabhängigen datetime-Objekten vergleichen zu können. Ich möchte nicht meine gesamte Anwendung für diesen einen Legacy-Fall ohne Kenntnis der Zeitzone konvertieren.

Was ich versucht habe

Erstmal um das Problem zu demonstrieren:

Python 2.6.1 (r261:67515, Jun 24 2010, 21:47:49) 
[GCC 4.2.1 (Apple Inc. build 5646)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import datetime
>>> import pytz
>>> unaware = datetime.datetime(2011,8,15,8,15,12,0)
>>> unaware
datetime.datetime(2011, 8, 15, 8, 15, 12)
>>> aware = datetime.datetime(2011,8,15,8,15,12,0,pytz.UTC)
>>> aware
datetime.datetime(2011, 8, 15, 8, 15, 12, tzinfo=<UTC>)
>>> aware == unaware
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: can't compare offset-naive and offset-aware datetimes

Zuerst habe ich astimezone ausprobiert:

>>> unaware.astimezone(pytz.UTC)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: astimezone() cannot be applied to a naive datetime
>>>

Es ist nicht sehr überraschend, dass dies fehlgeschlagen ist, da es tatsächlich versucht, eine Konvertierung durchzuführen. Ersetzen schien eine bessere Wahl zu sein (gemäß Wie bekomme ich einen Wert von datetime.today() in Python, der “zeitzonenbewusst” ist?):

>>> unaware.replace(tzinfo=pytz.UTC)
datetime.datetime(2011, 8, 15, 8, 15, 12, tzinfo=<UTC>)
>>> unaware == aware
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: can't compare offset-naive and offset-aware datetimes
>>> 

Aber wie Sie sehen können, scheint replace die tzinfo zu setzen, aber das Objekt nicht darauf aufmerksam zu machen. Ich bereite mich darauf vor, die Eingabezeichenfolge zu bearbeiten, um eine Zeitzone zu erhalten, bevor ich sie parse (ich verwende dateutil zum Parsing, wenn das wichtig ist), aber das scheint unglaublich klobig zu sein.

Außerdem habe ich dies sowohl in Python 2.6 als auch in Python 2.7 versucht, mit den gleichen Ergebnissen.

Kontext

Ich schreibe einen Parser für einige Datendateien. Es gibt ein altes Format, das ich unterstützen muss, bei dem die Datumszeichenfolge keine Zeitzonenanzeige hat. Ich habe die Datenquelle bereits repariert, aber ich muss noch das Legacy-Datenformat unterstützen. Eine einmalige Konvertierung der Altdaten ist aus verschiedenen betriebswirtschaftlichen Gründen nicht möglich. Während ich im Allgemeinen die Idee nicht mag, eine Standardzeitzone fest zu codieren, scheint es in diesem Fall die beste Option zu sein. Ich weiß mit angemessener Sicherheit, dass alle fraglichen Altdaten in UTC vorliegen, daher bin ich bereit, das Risiko eines Verzugs in diesem Fall in Kauf zu nehmen.

Um ein naives datetime zeitzonenbewusst zu machen, verwenden Sie im Allgemeinen die Methode lokalisieren:

import datetime
import pytz

unaware = datetime.datetime(2011, 8, 15, 8, 15, 12, 0)
aware = datetime.datetime(2011, 8, 15, 8, 15, 12, 0, pytz.UTC)

now_aware = pytz.utc.localize(unaware)
assert aware == now_aware

Für die UTC-Zeitzone ist es nicht wirklich notwendig, sie zu verwenden localize da keine Sommerzeitberechnung zu handhaben ist:

now_aware = unaware.replace(tzinfo=pytz.UTC)

funktioniert. (.replace gibt eine neue Datumszeit zurück; es ändert sich nicht unaware.)

Alle diese Beispiele verwenden ein externes Modul, aber Sie können das gleiche Ergebnis nur mit dem datetime-Modul erzielen, wie auch in dieser SO-Antwort dargestellt:

from datetime import datetime, timezone

dt = datetime.now()
dt = dt.replace(tzinfo=timezone.utc)

print(dt.isoformat())
# '2017-01-12T22:11:31+00:00'

Weniger Abhängigkeiten und keine Pytz-Probleme.

HINWEIS: Wenn Sie dies mit python3 und python2 verwenden möchten, können Sie dies auch für den Zeitzonenimport verwenden (fest codiert für UTC):

try:
    from datetime import timezone
    utc = timezone.utc
except ImportError:
    #Hi there python2 user
    class UTC(tzinfo):
        def utcoffset(self, dt):
            return timedelta(0)
        def tzname(self, dt):
            return "UTC"
        def dst(self, dt):
            return timedelta(0)
    utc = UTC()

Ich habe dieses Python 2-Skript im Jahr 2011 geschrieben, aber nie überprüft, ob es unter Python 3 funktioniert.

Ich war von dt_aware zu dt_unaware gewechselt:

dt_unaware = dt_aware.replace(tzinfo=None)

und dt_unware zu dt_aware:

from pytz import timezone
localtz = timezone('Europe/Lisbon')
dt_aware = localtz.localize(dt_unware)

Ich verwende diese Anweisung in Django, um eine unbewusste Zeit in eine bewusste zu konvertieren:

from django.utils import timezone

dt_aware = timezone.make_aware(dt_unaware, timezone.get_current_timezone())

Python 3.9 fügt die hinzu zoneinfo Modul also wird jetzt nur noch die Standardbibliothek benötigt!

from zoneinfo import ZoneInfo
from datetime import datetime
unaware = datetime(2020, 10, 31, 12)

Zeitzone anhängen:

>>> unaware.replace(tzinfo=ZoneInfo('Asia/Tokyo'))
datetime.datetime(2020, 10, 31, 12, 0, tzinfo=zoneinfo.ZoneInfo(key='Asia/Tokyo'))
>>> str(_)
'2020-10-31 12:00:00+09:00'

Hängen Sie die lokale Zeitzone des Systems an:

>>> unaware.replace(tzinfo=ZoneInfo('localtime'))
datetime.datetime(2020, 10, 31, 12, 0, tzinfo=zoneinfo.ZoneInfo(key='localtime'))
>>> str(_)
'2020-10-31 12:00:00+01:00'

Anschließend wird korrekt in andere Zeitzonen umgerechnet:

>>> unaware.replace(tzinfo=ZoneInfo('localtime')).astimezone(ZoneInfo('Asia/Tokyo'))
datetime.datetime(2020, 10, 31, 20, 0, tzinfo=backports.zoneinfo.ZoneInfo(key='Asia/Tokyo'))
>>> str(_)
'2020-10-31 20:00:00+09:00'

Wikipedia-Liste der verfügbaren Zeitzonen

Windows hat kein System-Zeitzonendatenbank, daher wird hier ein zusätzliches Paket benötigt:

pip install tzdata  

Es gibt einen Backport, um die Verwendung zu ermöglichen zoneinfo In Python 3.6 bis 3.8:

pip install backports.zoneinfo

Dann:

from backports.zoneinfo import ZoneInfo

Ich stimme den vorherigen Antworten zu und es ist in Ordnung, wenn Sie in UTC beginnen können. Aber ich denke, es ist auch ein gängiges Szenario, dass Menschen mit einem tz-bewussten Wert arbeiten, der einen hat datetime, die eine andere lokale Zeitzone als UTC hat.

Wenn Sie nur nach Namen gehen würden, würde man wahrscheinlich folgern, dass replace() anwendbar ist und das richtige datetime-bewusste Objekt erzeugt. Das ist nicht der Fall.

das replace( tzinfo=… ) scheint in seinem Verhalten zufällig zu sein. Es ist daher nutzlos. Verwenden Sie dies nicht!

localize ist die richtige zu verwendende Funktion. Beispiel:

localdatetime_aware = tz.localize(datetime_nonaware)

Oder ein vollständigeres Beispiel:

import pytz
from datetime import datetime
pytz.timezone('Australia/Melbourne').localize(datetime.now())

gibt mir einen zeitzonenbewussten datetime-Wert der aktuellen Ortszeit:

datetime.datetime(2017, 11, 3, 7, 44, 51, 908574, tzinfo=<DstTzInfo 'Australia/Melbourne' AEDT+11:00:00 DST>)

Verwenden dateutil.tz.tzlocal() um die Zeitzone in Ihrer Verwendung von zu erhalten datetime.datetime.now() Und datetime.datetime.astimezone():

from datetime import datetime
from dateutil import tz

unlocalisedDatetime = datetime.now()

localisedDatetime1 = datetime.now(tz = tz.tzlocal())
localisedDatetime2 = datetime(2017, 6, 24, 12, 24, 36, tz.tzlocal())
localisedDatetime3 = unlocalisedDatetime.astimezone(tz = tz.tzlocal())
localisedDatetime4 = unlocalisedDatetime.replace(tzinfo = tz.tzlocal())

Beachten Sie, dass datetime.astimezone konvertiert zuerst Ihre datetime Objekt auf UTC dann in die Zeitzone, was dasselbe ist wie ein Anruf datetime.replace mit den ursprünglichen Zeitzoneninformationen None.