在Python中将datetime.date转换为UTC时间戳

Converting datetime.date to UTC timestamp in Python

我正在用python处理日期,我需要将它们转换为要使用的UTC时间戳在javascript中。以下代码不起作用:

1
2
3
>>> d = datetime.date(2011,01,01)
>>> datetime.datetime.utcfromtimestamp(time.mktime(d.timetuple()))
datetime.datetime(2010, 12, 31, 23, 0)

首先将日期对象转换为日期时间也没有帮助。我在这个链接上尝试了这个例子,但是:

1
2
3
4
from pytz import utc, timezone
from datetime import datetime
from time import mktime
input_date = datetime(year=2011, month=1, day=15)

现在也可以:

1
mktime(utc.localize(input_date).utctimetuple())

1
mktime(timezone('US/Eastern').localize(input_date).utctimetuple())

工作。

所以一般的问题是:如何根据UTC将日期转换为从epoch开始的秒数?


如果d = date(2011, 1, 1)使用的是UTC:

1
2
3
4
5
>>> from datetime import datetime, date
>>> import calendar
>>> timestamp1 = calendar.timegm(d.timetuple())
>>> datetime.utcfromtimestamp(timestamp1)
datetime.datetime(2011, 1, 1, 0, 0)

如果d在当地时区:

1
2
3
4
>>> import time
>>> timestamp2 = time.mktime(d.timetuple()) # DO NOT USE IT WITH UTC DATE
>>> datetime.fromtimestamp(timestamp2)
datetime.datetime(2011, 1, 1, 0, 0)

如果本地时区中的午夜与UTC中的午夜不同,则timestamp1timestamp2可能会有所不同。

如果d对应的本地时间不明确(例如,在DST转换期间),或者如果d是过去(将来)日期,当UTC偏移量可能不同,并且c mktime()无法访问给定平台上的TZ数据库时,mktime()可能返回错误的结果。您可以使用pytz模块(例如,通过tzlocal.get_localzone()访问所有平台上的TZ数据库)。另外,如果使用"right"时区,utcfromtimestamp()可能会失败,mktime()可能返回非posix时间戳。

要转换表示日期(UTC)的datetime.date对象,而不转换calendar.timegm()

1
2
3
DAY = 24*60*60 # POSIX day in seconds (exact value)
timestamp = (utc_date.toordinal() - date(1970, 1, 1).toordinal()) * DAY
timestamp = (utc_date - date(1970, 1, 1)).days * DAY

如何根据UTC将日期转换为从epoch开始的秒数?

将已经表示UTC时间的datetime.datetime对象(不是datetime.date对象)转换为相应的posix时间戳(float)。

Python 3.3 +

datetime.timestamp()

1
2
3
from datetime import timezone

timestamp = dt.replace(tzinfo=timezone.utc).timestamp()

注意:必须明确地提供timezone.utc,否则.timestamp()假定您的naive datetime对象在本地时区。

python 3(<3.3)

来自datetime.utcfromtimestamp()文件:

There is no method to obtain the timestamp from a datetime instance,
but POSIX timestamp corresponding to a datetime instance dt can be
easily calculated as follows. For a naive dt:

1
timestamp = (dt - datetime(1970, 1, 1)) / timedelta(seconds=1)

And for an aware dt:

1
timestamp = (dt - datetime(1970,1,1, tzinfo=timezone.utc)) / timedelta(seconds=1)

有趣的读物:纪元时间与一天中的时间之差是什么时候?过了多少秒?

另请参见:datetime需要"epoch"方法

Python 2

要为python 2调整上述代码:

1
timestamp = (dt - datetime(1970, 1, 1)).total_seconds()

其中,timedelta.total_seconds()相当于(td.microseconds + (td.seconds + td.days * 24 * 3600) * 10**6) / 10**6,计算时启用了真正的除法。

例子

1
2
3
4
5
6
7
8
9
10
11
from __future__ import division
from datetime import datetime, timedelta

def totimestamp(dt, epoch=datetime(1970,1,1)):
    td = dt - epoch
    # return td.total_seconds()
    return (td.microseconds + (td.seconds + td.days * 86400) * 10**6) / 10**6

now = datetime.utcnow()
print now
print totimestamp(now)

当心浮点问题。

产量

1
2
2012-01-08 15:34:10.022403
1326036850.02

如何将已知的datetime对象转换为posix时间戳

1
2
assert dt.tzinfo is not None and dt.utcoffset() is not None
timestamp = dt.timestamp() # Python 3.3+

关于Python 3:

1
2
3
4
5
from datetime import datetime, timedelta, timezone

epoch = datetime(1970, 1, 1, tzinfo=timezone.utc)
timestamp = (dt - epoch) / timedelta(seconds=1)
integer_timestamp = (dt - epoch) // timedelta(seconds=1)

关于Python 2:

1
2
3
# utc time = local time              - utc offset
utc_naive  = dt.replace(tzinfo=None) - dt.utcoffset()
timestamp = (utc_naive - datetime(1970, 1, 1)).total_seconds()


仅适用于UNIX系统:

1
2
3
4
>>> import datetime
>>> d = datetime.date(2011,01,01)
>>> d.strftime("%s")  # <-- THIS IS THE CODE YOU WANT
'1293832800'

注1:Dizzyf观察到这适用于局部时区。不要在生产中使用。

注2:Jakub Nar?BSKI注意到,这会忽略时区信息,即使对于偏移感知的日期时间(针对Python2.7进行测试)。


  • 假设1:您试图将日期转换为时间戳,但是由于日期包含24小时的时间段,所以没有一个时间戳代表该日期。我假设您希望表示该日期在午夜(00:00:00.000)的时间戳。

  • 假设2:您当前的日期与特定时区没有关联,但是您希望确定与特定时区(UTC)的偏移量。如果不知道日期所在的时区,就无法计算特定时区的时间戳。我假设您希望将日期视为在本地系统时区中。

首先,可以使用timetuple()成员将日期实例转换为表示各种时间组件的元组:

1
dtt = d.timetuple() # time.struct_time(tm_year=2011, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=1, tm_isdst=-1)

然后可以使用time.mktime将其转换为时间戳:

1
ts = time.mktime(dtt) # 1293868800.0

您可以通过使用epoch time本身(1970-01-01)来验证此方法,在这种情况下,函数应返回该日期的本地时区的时区偏移量:

1
2
3
d = datetime.date(1970,1,1)
dtt = d.timetuple() # time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=3, tm_yday=1, tm_isdst=-1)
ts = time.mktime(dtt) # 28800.0

28800.0是8小时,这对于太平洋时区(我所在的时区)是正确的。


按照python2.7文档,您必须使用calendar.timegm()而不是time.mktime()。

1
2
3
>>> d = datetime.date(2011,01,01)
>>> datetime.datetime.utcfromtimestamp(calendar.timegm(d.timetuple()))
datetime.datetime(2011, 1, 1, 0, 0)


我定义了自己的两个函数

  • UTC时间2日期时间(UTC时间,TZ=无)
  • 日期时间2UTC时间(日期时间)

在这里:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import time
import datetime
from pytz import timezone
import calendar
import pytz


def utc_time2datetime(utc_time, tz=None):
    # convert utc time to utc datetime
    utc_datetime = datetime.datetime.fromtimestamp(utc_time)

    # add time zone to utc datetime
    if tz is None:
        tz_datetime = utc_datetime.astimezone(timezone('utc'))
    else:
        tz_datetime = utc_datetime.astimezone(tz)

    return tz_datetime


def datetime2utc_time(datetime):
    # add utc time zone if no time zone is set
    if datetime.tzinfo is None:
        datetime = datetime.replace(tzinfo=timezone('utc'))

    # convert to utc time zone from whatever time zone the datetime is set to
    utc_datetime = datetime.astimezone(timezone('utc')).replace(tzinfo=None)

    # create a time tuple from datetime
    utc_timetuple = utc_datetime.timetuple()

    # create a time element from the tuple an add microseconds
    utc_time = calendar.timegm(utc_timetuple) + datetime.microsecond / 1E6

    return utc_time


使用箭头包:

1
2
3
4
5
6
7
>>> import arrow
>>> arrow.get(2010, 12, 31).timestamp
1293753600
>>> time.gmtime(1293753600)
time.struct_time(tm_year=2010, tm_mon=12, tm_mday=31,
    tm_hour=0, tm_min=0, tm_sec=0,
    tm_wday=4, tm_yday=365, tm_isdst=0)


这个问题有点困惑。时间戳不是UTC,而是一个Unix。日期可能是UTC?假设是这样,并且如果您使用的是python3.2+,那么简单的日期会使这变得很简单:

1
2
>>> SimpleDate(date(2011,1,1), tz='utc').timestamp
1293840000.0

如果您实际拥有年、月和日,则不需要创建date

1
2
>>> SimpleDate(2011,1,1, tz='utc').timestamp
1293840000.0

如果日期在其他时区(这很重要,因为我们假设午夜没有相关的时间):

1
2
>>> SimpleDate(date(2011,1,1), tz='America/New_York').timestamp
1293858000.0

[简单日期背后的想法是在一个一致的类中收集所有Python的日期和时间信息,这样您就可以进行任何转换。因此,例如,它也会朝另一个方向发展:

1
2
>>> SimpleDate(1293858000, tz='utc').date
datetime.date(2011, 1, 1)

]


完整时间字符串包含:

  • 日期
  • 时间
  • utcoffset [+HHMM or -HHMM]

例如:

1970-01-01 06:00:00 +0500==1970-01-01 01:00:00 +0000==UNIX timestamp:3600

1
2
3
4
5
6
7
$ python3
>>> from datetime import datetime
>>> from calendar import timegm
>>> tm = '1970-01-01 06:00:00 +0500'
>>> fmt = '%Y-%m-%d %H:%M:%S %z'
>>> timegm(datetime.strptime(tm, fmt).utctimetuple())
3600

注:

UNIX timestamp is a floating point number expressed in seconds since the epoch, in UTC.

编辑:

1
2
3
4
5
6
7
$ python3
>>> from datetime import datetime, timezone, timedelta
>>> from calendar import timegm
>>> dt = datetime(1970, 1, 1, 6, 0)
>>> tz = timezone(timedelta(hours=5))
>>> timegm(dt.replace(tzinfo=tz).utctimetuple())
3600