python - 如何仅使用标准库将 UTC 日期时间转换为本地日期时间？

Question

我有一个datetime使用数据库创建datetime.utcnow()并保存在数据库中的 python 实例。

为了显示，我想将使用默认本地时区datetime从数据库中检索到的实例转换为datetime本地（即，好像datetime是使用创建的datetime.now()）。

如何仅使用 python 标准库（例如，无依赖关系）将 UTC 转换datetime为本地？datetimepytz

似乎一种解决方案是使用datetime.astimezone(tz)，但是您将如何获得默认的本地时区？

score 380 · Accepted Answer

在 Python 3.3+ 中：

from datetime import datetime, timezone

def utc_to_local(utc_dt):
    return utc_dt.replace(tzinfo=timezone.utc).astimezone(tz=None)

在 Python 2/3 中：

import calendar
from datetime import datetime, timedelta

def utc_to_local(utc_dt):
    # get integer timestamp to avoid precision lost
    timestamp = calendar.timegm(utc_dt.timetuple())
    local_dt = datetime.fromtimestamp(timestamp)
    assert utc_dt.resolution >= timedelta(microseconds=1)
    return local_dt.replace(microsecond=utc_dt.microsecond)

使用pytz（Python 2/3）：

import pytz

local_tz = pytz.timezone('Europe/Moscow') # use your local timezone name here
# NOTE: pytz.reference.LocalTimezone() would produce wrong result here

## You could use `tzlocal` module to get local timezone on Unix and Win32
# from tzlocal import get_localzone # $ pip install tzlocal

# # get local timezone    
# local_tz = get_localzone()

def utc_to_local(utc_dt):
    local_dt = utc_dt.replace(tzinfo=pytz.utc).astimezone(local_tz)
    return local_tz.normalize(local_dt) # .normalize might be unnecessary

例子

def aslocaltimestr(utc_dt):
    return utc_to_local(utc_dt).strftime('%Y-%m-%d %H:%M:%S.%f %Z%z')

print(aslocaltimestr(datetime(2010,  6, 6, 17, 29, 7, 730000)))
print(aslocaltimestr(datetime(2010, 12, 6, 17, 29, 7, 730000)))
print(aslocaltimestr(datetime.utcnow()))

输出

蟒蛇 3.3

2010-06-06 21:29:07.730000 MSD+0400
2010-12-06 20:29:07.730000 MSK+0300
2012-11-08 14:19:50.093745 MSK+0400

蟒蛇2

2010-06-06 21:29:07.730000 
2010-12-06 20:29:07.730000 
2012-11-08 14:19:50.093911

皮茨

2010-06-06 21:29:07.730000 MSD+0400
2010-12-06 20:29:07.730000 MSK+0300
2012-11-08 14:19:50.146917 MSK+0400

注意：它考虑了 DST 和 MSK 时区最近的 UTC 偏移量变化。

我不知道非 pytz 解决方案是否适用于 Windows。

score 70 · Accepted Answer

从 Python 3.9 开始，您可以使用该zoneinfo模块。

首先让我们花时间utcnow()：

>>> from datetime import datetime
>>> database_time = datetime.utcnow()
>>> database_time
datetime.datetime(2021, 9, 24, 4, 18, 27, 706532)

然后创建时区：

>>> from zoneinfo import ZoneInfo
>>> utc = ZoneInfo('UTC')
>>> localtz = ZoneInfo('localtime')

然后转换。要在时区之间转换，日期时间必须知道它所在的时区，然后我们只需使用astimezone()：

>>> utctime = database_time.replace(tzinfo=utc)
>>> localtime = utctime.astimezone(localtz)
>>> localtime
datetime.datetime(2021, 9, 24, 6, 18, 27, 706532, tzinfo=zoneinfo.ZoneInfo(key='localtime'))

对于 Python 3.6 到 3.8，您需要 backports.zoneinfo 模块：

>>> try:
>>>     from zoneinfo import ZoneInfo
>>> except ImportError:
>>>     from backports.zoneinfo import ZoneInfo

其余的都是一样的。

对于早于该版本的版本需要pytz或dateutil. datutil 的工作方式类似于 zoneinfo：

>>> from dateutil import tz
>>> utc = tz.gettz('UTC')
>>> localtz = tz.tzlocal()

The Conversion:
>>> utctime = now.replace(tzinfo=UTC)
>>> localtime = utctime.astimezone(localtz)
>>> localtime
datetime.datetime(2010, 12, 30, 15, 51, 22, 114668, tzinfo=tzlocal())

pytz有一个不同的界面，这是由于 Python 的时区处理不处理模棱两可的时间：

>>> import pytz
>>> utc = pytz.timezone('UTC')
# There is no local timezone support, you need to know your timezone
>>> localtz = pytz.timezone('Europe/Paris')

>>> utctime = utc.localize(database_time)
>>> localtime = localtz.normalize(utctime.astimezone(localtz))
>>> localtime

score 18 · Accepted Answer

Python 3.9 添加了该zoneinfo模块，因此现在可以按如下方式完成（仅限 stdlib）：

from zoneinfo import ZoneInfo
from datetime import datetime

utc_unaware = datetime(2020, 10, 31, 12)  # loaded from database
utc_aware = utc_unaware.replace(tzinfo=ZoneInfo('UTC'))  # make aware
local_aware = utc_aware.astimezone(ZoneInfo('localtime'))  # convert

中欧比 UTC 早 1 或 2 小时，因此local_aware：

datetime.datetime(2020, 10, 31, 13, 0, tzinfo=backports.zoneinfo.ZoneInfo(key='localtime'))

作为str：

2020-10-31 13:00:00+01:00

Windows 没有系统时区数据库，所以这里需要一个额外的包：

pip install tzdata

有一个 backport 允许在Python 3.6 到 3.8中使用：

sudo pip install backports.zoneinfo

然后：

from backports.zoneinfo import ZoneInfo

score 13 · Accepted Answer

你不能用标准库来做到这一点。使用 pytz模块，您可以将任何幼稚/感知的日期时间对象转换为任何其他时区。让我们看一些使用 Python 3 的示例。

通过类方法创建的天真的对象utcnow()

要将原始对象转换为任何其他时区，首先必须将其转换为可感知的日期时间对象。您可以使用该replace方法将天真的日期时间对象转换为有意识的日期时间对象。然后将感知日期时间对象转换为您可以使用的任何其他时区astimezone。

该变量pytz.all_timezones为您提供 pytz 模块中所有可用时区的列表。

import datetime,pytz

dtobj1=datetime.datetime.utcnow()   #utcnow class method
print(dtobj1)

dtobj3=dtobj1.replace(tzinfo=pytz.UTC) #replace method

dtobj_hongkong=dtobj3.astimezone(pytz.timezone("Asia/Hong_Kong")) #astimezone method
print(dtobj_hongkong)

通过类方法创建的天真的对象now()

因为now方法返回当前日期和时间，所以你必须首先让 datetime 对象知道时区。该localize 函数将一个简单的日期时间对象转换为一个时区感知的日期时间对象。然后您可以使用该astimezone方法将其转换为另一个时区。

dtobj2=datetime.datetime.now()

mytimezone=pytz.timezone("Europe/Vienna") #my current timezone
dtobj4=mytimezone.localize(dtobj2)        #localize function

dtobj_hongkong=dtobj4.astimezone(pytz.timezone("Asia/Hong_Kong")) #astimezone method
print(dtobj_hongkong)

score 8 · Accepted Answer

以阿列克谢的评论为基础。这也适用于 DST。

import time
import datetime

def utc_to_local(dt):
    if time.localtime().tm_isdst:
        return dt - datetime.timedelta(seconds = time.altzone)
    else:
        return dt - datetime.timedelta(seconds = time.timezone)

score 6 · Accepted Answer

我想我想通了：计算自纪元以来的秒数，然后使用 time.localtime 转换为本地 timzeone，然后将时间结构转换回日期时间......

EPOCH_DATETIME = datetime.datetime(1970,1,1)
SECONDS_PER_DAY = 24*60*60

def utc_to_local_datetime( utc_datetime ):
    delta = utc_datetime - EPOCH_DATETIME
    utc_epoch = SECONDS_PER_DAY * delta.days + delta.seconds
    time_struct = time.localtime( utc_epoch )
    dt_args = time_struct[:6] + (delta.microseconds,)
    return datetime.datetime( *dt_args )

它正确应用夏季/冬季 DST：

>>> utc_to_local_datetime( datetime.datetime(2010, 6, 6, 17, 29, 7, 730000) )
datetime.datetime(2010, 6, 6, 19, 29, 7, 730000)
>>> utc_to_local_datetime( datetime.datetime(2010, 12, 6, 17, 29, 7, 730000) )
datetime.datetime(2010, 12, 6, 18, 29, 7, 730000)

score 4 · Accepted Answer

标准 Python 库根本没有任何tzinfo实现。我一直认为这是 datetime 模块的一个令人惊讶的缺点。

tzinfo 类的文档确实提供了一些有用的示例。查找本节末尾的大代码块。

score 2 · Accepted Answer

使用time.timezone，它以“UTC 以西的秒数”为单位给出一个整数。

例如：

from datetime import datetime, timedelta, timezone
import time

# make datetime from timestamp, thus no timezone info is attached
now = datetime.fromtimestamp(time.time())

# make local timezone with time.timezone
local_tz = timezone(timedelta(seconds=-time.timezone))

# attach different timezones as you wish
utc_time = now.astimezone(timezone.utc)
local_time = now.astimezone(local_tz)

print(utc_time.isoformat(timespec='seconds')) 
print(local_time.isoformat(timespec='seconds'))

在我的电脑（Python 3.7.3）上，它给出：

2021-05-07T12:50:46+00:00
2021-05-07T20:50:46+08:00

很简单，只使用标准库~

score 0 · Accepted Answer

一种适用于 Python 2 和 3 的简单（但可能存在缺陷）方式：

import time
import datetime

def utc_to_local(dt):
    return dt - datetime.timedelta(seconds = time.timezone)

它的优点是写一个反函数很简单

score 0 · Accepted Answer

我发现最简单的方法是获取您所在位置的时间偏移量，然后从小时中减去它。

def format_time(ts,offset):
    if not ts.hour >= offset:
        ts = ts.replace(day=ts.day-1)
        ts = ts.replace(hour=ts.hour-offset)
    else:
        ts = ts.replace(hour=ts.hour-offset)
    return ts

这对我有用，在 Python 3.5.2 中。

score 0 · Accepted Answer

这是另一种以日期时间格式更改时区的方法（我知道我在这上面浪费了我的精力，但我没有看到这个页面，所以我不知道如何）没有 min. 和秒。因为我的项目不需要它：

def change_time_zone(year, month, day, hour):
      hour = hour + 7 #<-- difference
      if hour >= 24:
        difference = hour - 24
        hour = difference
        day += 1
        long_months = [1, 3, 5, 7, 8, 10, 12]
        short_months = [4, 6, 9, 11]
        if month in short_months:
          if day >= 30:
            day = 1
            month += 1
            if month > 12:
              year += 1
        elif month in long_months:
          if day >= 31:
            day = 1
            month += 1
            if month > 12:
              year += 1
        elif month == 2:
          if not year%4==0:
            if day >= 29:
              day = 1
              month += 1
              if month > 12:
                year += 1
          else:
            if day >= 28:
              day = 1
              month += 1
              if month > 12:
                year += 1
      return datetime(int(year), int(month), int(day), int(hour), 00)

score 0 · Accepted Answer

对于特定情况：
　输入 UTC 日期时间字符串。// 通常从日志
　输出语言环境日期时间字符串。

def utc_to_locale(utc_str):
    # from utc to locale
    d1=datetime.fromisoformat(utc_str+'-00:00')
    return d1.astimezone().strftime('%F %T.%f')[:-3]

测试：

>>> utc_to_locale('2022-02-14 00:49:06')
'2022-02-14 08:49:06.000'
>>> utc_to_locale('2022-02-14 00:49:06.123')
'2022-02-14 08:49:06.123'
>>> utc_to_locale('2022-02-14T00:49:06.123')
'2022-02-14 08:49:06.123'

score -1 · Accepted Answer

这是一种糟糕的方法，但它避免了创建定义。它满足了坚持使用基本 Python3 库的要求。

# Adjust from UST to Eastern Standard Time (dynamic)
# df.my_localtime should already be in datetime format, so just in case
df['my_localtime'] = pd.to_datetime.df['my_localtime']

df['my_localtime'] = df['my_localtime'].dt.tz_localize('UTC').dt.tz_convert('America/New_York').astype(str)
df['my_localtime'] = pd.to_datetime(df.my_localtime.str[:-6])

score -1 · Accepted Answer

使用 timedelta 在时区之间切换。您所需要的只是时区之间的小时偏移量。不必为日期时间对象的所有 6 个元素摆弄边界。timedelta 也可以轻松处理闰年、闰世纪等。你必须先

from datetime import datetime, timedelta

那么如果offset是以小时为单位的时区增量：

timeout = timein + timedelta(hours = offset)

其中 timein 和 timeout 是日期时间对象。例如

timein + timedelta(hours = -8)

从 GMT 转换为 PST。

那么，如何判断offset呢？这是一个简单的函数，前提是您只有几种转换可能性，而不使用时区“感知”的日期时间对象，而其他一些答案很好地做到了。有点手动，但有时清晰是最好的。

def change_timezone(timein, timezone, timezone_out):
    '''
    changes timezone between predefined timezone offsets to GMT
    timein - datetime object
    timezone - 'PST', 'PDT', 'GMT' (can add more as needed)
    timezone_out - 'PST', 'PDT', 'GMT' (can add more as needed)
    ''' 
    # simple table lookup        
    tz_offset =  {'PST': {'GMT': 8, 'PDT': 1, 'PST': 0}, \
                  'GMT': {'PST': -8, 'PDT': -7, 'GMT': 0}, \
                  'PDT': {'GMT': 7, 'PST': -1, 'PDT': 0}}
    try:
        offset = tz_offset[timezone][timezone_out]
    except:
        msg = 'Input timezone=' + timezone + ' OR output time zone=' + \
            timezone_out + ' not recognized'
        raise DateTimeError(msg)

    return timein + timedelta(hours = offset)

在查看了众多答案并使用了我能想到的最严格的代码之后（目前），所有应用程序，其中时间很重要并且必须考虑混合时区，最好应该努力制作所有日期时间对象“意识到的”。那么看起来最简单的答案是：

timeout = timein.astimezone(pytz.timezone("GMT"))

例如转换为 GMT。当然，要转换到/从您希望的任何其他时区，本地或其他时区，只需使用 pytz 理解的适当时区字符串（来自 pytz.all_timezones）。然后还考虑夏令时。

python - 如何仅使用标准库将 UTC 日期时间转换为本地日期时间？

14 回答 14

例子

输出

Related

Reference