Как сделать незнакомый часовой пояс даты и времени в Python

Что я должен сделать

У меня есть объект datetime, не поддерживающий часовой пояс, к которому мне нужно добавить часовой пояс, чтобы иметь возможность сравнивать его с другими объектами datetime с учетом часового пояса. Я не хочу преобразовывать все мое приложение в часовой пояс, не подозревая об этом унаследованном случае.

Что я пробовал

Во-первых, чтобы продемонстрировать проблему:

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

Сначала я попробовал astimezone:

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

Неудивительно, что это не удалось, так как он пытается конвертировать. Заменить казалось лучшим выбором (согласно Python: как получить значение datetime.today (), которое «учитывает часовой пояс»? ):

>>> 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
>>> 

Но, как вы можете видеть, замена, кажется, устанавливает tzinfo, но не делает объект осведомленным. Я собираюсь вернуться к лечению входной строки, чтобы иметь часовой пояс перед его синтаксическим анализом (я использую dateutil для анализа, если это имеет значение), но это кажется невероятно грязным.

Кроме того, я пробовал это и в Python 2.6 и Python 2.7, с одинаковыми результатами.

контекст

Я пишу парсер для некоторых файлов данных. Существует старый формат, который мне нужно поддерживать, когда строка даты не имеет индикатора часового пояса. Я уже исправил источник данных, но мне все еще нужно поддерживать устаревший формат данных. Однократное преобразование устаревших данных не подходит по различным причинам бизнес-BS. Хотя в целом мне не нравится идея жесткого кодирования часового пояса по умолчанию, в этом случае он кажется наилучшим вариантом. Я с достаточной уверенностью знаю, что все унаследованные данные находятся в UTC, поэтому я готов принять на себя риск невыполнения этого требования в этом случае.

В общем, чтобы сделать наивный точный часовой пояс даты и времени, используйте метод локализации :

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

Для часового пояса UTC использование на самом деле не является необходимым, localizeтак как нет никакого расчета летнего времени для обработки:

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

работает. ( .replaceвозвращает новую дату и время; она не изменяется unaware.)

Во всех этих примерах используется внешний модуль, но вы можете достичь того же результата, используя только модуль datetime, как также представлено в этом ответе SO :

from datetime import datetime
from datetime import timezone

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

print(dt.replace(tzinfo=timezone.utc).isoformat())
'2017-01-12T22:11:31+00:00'

Меньше зависимостей и нет проблем с Pytz.

ПРИМЕЧАНИЕ: Если вы хотите использовать это с python3 и python2, вы можете использовать это также для импорта часового пояса (жестко задано для 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()

Я использовал от dt_aware до dt_unaware

dt_unaware = dt_aware.replace(tzinfo=None)

и dt_unware для dt_aware

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

но ответ раньше тоже хорошее решение.

Я использую это утверждение в Django, чтобы преобразовать неосведомленное время в осведомленное:

from django.utils import timezone

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

Я согласен с предыдущими ответами, и это нормально, если вы можете начать в UTC. Но я думаю, что это также распространенный сценарий, когда люди работают со значением, учитывающим tz, которое имеет дату и время, а не местный часовой пояс UTC.

Если бы вы просто пошли по имени, можно было бы предположить, что replace () будет применим и создаст правильный объект с указанием даты и времени. Это не вариант.

замена (tzinfo = ...) кажется случайной в своем поведении . Поэтому бесполезно. Не используйте это!

localize - это правильная функция для использования. Пример:

localdatetime_aware = tz.localize(datetime_nonaware)

Или более полный пример:

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

дает мне текущее местное время с учетом даты и времени:

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

Используйте, dateutil.tz.tzlocal()чтобы получить часовой пояс в вашем использовании datetime.datetime.now()и 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())

Обратите внимание, что datetime.astimezoneсначала будет преобразован ваш datetimeобъект в UTC, а затем в часовой пояс, который аналогичен вызову datetime.replaceс исходной информацией часового пояса None.

Это систематизирует ответы @ Sérgio и @ unutbu . Он будет «просто работать» с pytz.timezoneобъектом или строкой часового пояса IANA .

def make_tz_aware(dt, tz='UTC', is_dst=None):
    """Add timezone information to a datetime object, only if it is naive."""
    tz = dt.tzinfo or tz
    try:
        tz = pytz.timezone(tz)
    except AttributeError:
        pass
    return tz.localize(dt, is_dst=is_dst) 

Это похоже на то, что datetime.localize()(или .inform()или .awarify()) должно делать, принимать как строки, так и объекты часового пояса для аргумента tz и по умолчанию UTC, если часовой пояс не указан.

Python 3.9 добавляет zoneinfoмодуль, поэтому теперь нужна только стандартная библиотека!

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

Прикрепить часовой пояс:

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

Присоедините местный часовой пояс системы:

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

Впоследствии он правильно конвертируется в другие часовые пояса:

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

Википедия список доступных часовых поясов

Windows не имеет базы данных системного часового пояса, поэтому здесь необходим дополнительный пакет:

pip install tzdata  

Существует бэкпорт, позволяющий использовать в Python 3.6 до 3.8 :

pip install backports.zoneinfo

Затем:

from backports.zoneinfo import ZoneInfo

В формате ответа unutbu; Я сделал служебный модуль, который обрабатывает подобные вещи с более интуитивным синтаксисом. Может быть установлен с помощью пипа.

import datetime
import saturn

unaware = datetime.datetime(2011, 8, 15, 8, 15, 12, 0)
now_aware = saturn.fix_naive(unaware)

now_aware_madrid = saturn.fix_naive(unaware, 'Europe/Madrid')

для тех, кто просто хочет узнать дату и время

import datetime
import pytz

datetime.datetime(2019, 12, 7, tzinfo=pytz.UTC)

совершенно новый для Python, и я столкнулся с той же проблемой. Я нахожу это решение довольно простым, и для меня оно отлично работает (Python 3.6):

unaware=parser.parse("2020-05-01 0:00:00")
aware=unaware.replace(tzinfo=tz.tzlocal()).astimezone(tz.tzlocal())

Переключение между часовыми поясами

import pytz
from datetime import datetime

other_tz = pytz.timezone('Europe/Madrid')

# From random aware datetime...
aware_datetime = datetime.utcnow().astimezone(other_tz)
>> 2020-05-21 08:28:26.984948+02:00

# 1. Change aware datetime to UTC and remove tzinfo to obtain an unaware datetime
unaware_datetime = aware_datetime.astimezone(pytz.UTC).replace(tzinfo=None)
>> 2020-05-21 06:28:26.984948

# 2. Set tzinfo to UTC directly on an unaware datetime to obtain an utc aware datetime
aware_datetime_utc = unaware_datetime.replace(tzinfo=pytz.UTC)
>> 2020-05-21 06:28:26.984948+00:00

# 3. Convert the aware utc datetime into another timezone
reconverted_aware_datetime = aware_datetime_utc.astimezone(other_tz)
>> 2020-05-21 08:28:26.984948+02:00

# Initial Aware Datetime and Reconverted Aware Datetime are equal
print(aware_datetime1 == aware_datetime2)
>> True