381

I am dealing with dates in Python and I need to convert them to UTC timestamps to be used inside Javascript. The following code does not work:

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

Converting the date object first to datetime also does not help. I tried the example at this link from, but:

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

and now either:

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

or

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

does work.

So general question: how can I get a date converted to seconds since epoch according to UTC?

5
  • possible duplicate of How do I convert local time to UTC in Python? Jan 8, 2012 at 20:13
  • 37
    I'm not sure I would agree with marking it as a duplicate. While the solutions are similar the questions are not. One (this one) is attempting to create a timestamp from a datetime.date, the other is attempting to convert a string representation from one timezone to another. As someone looking for a solution to this problem, I may not conclude that the latter will provide the answer I'm looking for.
    – DRH
    Jan 8, 2012 at 20:26
  • 6
    datetime(date.year,date.month,date.day).timestamp()
    – Julian
    Jul 21, 2017 at 17:00
  • 4
  • Beware: mktime is up to 10x slower than other approaches. Since it's not unlikely you're doing this in a hot path, it matters.
    – Remko
    Oct 15, 2021 at 14:01

11 Answers 11

545

If d = date(2011, 1, 1) is in UTC:

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

If d is in local timezone:

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

timestamp1 and timestamp2 may differ if midnight in the local timezone is not the same time instance as midnight in UTC.

mktime() may return a wrong result if d corresponds to an ambiguous local time (e.g., during DST transition) or if d is a past(future) date when the utc offset might have been different and the C mktime() has no access to the tz database on the given platform. You could use pytz module (e.g., via tzlocal.get_localzone()) to get access to the tz database on all platforms. Also, utcfromtimestamp() may fail and mktime() may return non-POSIX timestamp if "right" timezone is used.


To convert datetime.date object that represents date in UTC without calendar.timegm():

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

How can I get a date converted to seconds since epoch according to UTC?

To convert datetime.datetime (not datetime.date) object that already represents time in UTC to the corresponding POSIX timestamp (a float).

Python 3.3+

datetime.timestamp():

from datetime import timezone

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

Note: It is necessary to supply timezone.utc explicitly otherwise .timestamp() assume that your naive datetime object is in local timezone.

Python 3 (< 3.3)

From the docs for 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:

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

And for an aware dt:

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

Interesting read: Epoch time vs. time of day on the difference between What time is it? and How many seconds have elapsed?

See also: datetime needs an "epoch" method

Python 2

To adapt the above code for Python 2:

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

where timedelta.total_seconds() is equivalent to (td.microseconds + (td.seconds + td.days * 24 * 3600) * 10**6) / 10**6 computed with true division enabled.

Example

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)

Beware of floating-point issues.

Output

2012-01-08 15:34:10.022403
1326036850.02

How to convert an aware datetime object to POSIX timestamp

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

On Python 3:

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)

On Python 2:

# utc time = local time              - utc offset
utc_naive  = dt.replace(tzinfo=None) - dt.utcoffset()
timestamp = (utc_naive - datetime(1970, 1, 1)).total_seconds()
36
  • 2
    For the Python 2 case, why not: timestamp = (dt - datetime.fromtimestamp(0)).total_seconds() ?
    – m01
    Dec 19, 2012 at 11:26
  • 7
    @m01: datetime(1970, 1, 1) is more explicit. fromtimestamp() is incorrect here (dt is in UTC so utcfromtimestamp() should be used instead).
    – jfs
    Dec 19, 2012 at 11:36
  • 1
    @fedorqui look at totimestamp() function in the answer.
    – jfs
    Nov 19, 2015 at 10:59
  • 22
    as much as I love python, its date-time lib is seriously broken.
    – Realfun
    Jan 15, 2016 at 4:14
  • 4
    @Realfun: timezones, DST transitions, the tz database, leap seconds exist independent of Python.
    – jfs
    Jan 16, 2016 at 6:58
112

For unix systems only:

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

Note 1: dizzyf observed that this applies localized timezones. Don't use in production.

Note 2: Jakub Narębski noted that this ignores timezone information even for offset-aware datetime (tested for Python 2.7).

9
  • 4
    A good answer if you know what system your code will run under, but it's important to note that the '%s' format string does not exist on all OSes, so this code is not portable. If you want to check whether it's supported you can check man strftime on Unix-like systems. Feb 4, 2016 at 10:42
  • 5
    It should be mentioned that this drops the fractional seconds part (microseconds or whatever).
    – Alfe
    Jan 24, 2017 at 10:50
  • 12
    WARNING: This applies localized timezones! You will get different strftime behavior for identical datetime objects depending on the machine time
    – dizzyf
    Mar 20, 2017 at 17:24
  • 3
    Moreover this ignores timezone information and assumes that datetime is in local timezone even for offset-aware datetime, with tzinfo set. Well, at least in Python 2.7. Mar 18, 2018 at 10:45
  • 1
    javascript timestamp = python timestamp * 1000
    – James
    May 30, 2018 at 16:37
44
  • Assumption 1: You're attempting to convert a date to a timestamp, however since a date covers a 24 hour period, there isn't a single timestamp that represents that date. I'll assume that you want to represent the timestamp of that date at midnight (00:00:00.000).

  • Assumption 2: The date you present is not associated with a particular time zone, however you want to determine the offset from a particular time zone (UTC). Without knowing the time zone the date is in, it isn't possible to calculate a timestamp for a specific time zone. I'll assume that you want to treat the date as if it is in the local system time zone.

First, you can convert the date instance into a tuple representing the various time components using the timetuple() member:

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)

You can then convert that into a timestamp using time.mktime:

ts = time.mktime(dtt) # 1293868800.0

You can verify this method by testing it with the epoch time itself (1970-01-01), in which case the function should return the timezone offset for the local time zone on that date:

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 is 8 hours, which would be correct for the Pacific time zone (where I'm at).

2
  • I'm not sure why this has been downvoted. It addresses the OP's issue (the working code the OP labelled as "not working"). It doesn't answer my question (convert UTC datetime.datetime to timestamp), but still… upvoting.
    – Thanatos
    Nov 19, 2012 at 22:22
  • 9
    Be careful. The assumption that "you want to treat the date as if it is in the local system timezone is the root of all issues with timezone in python. Unless you're 100% sure of the localization of the machine that will run your script and especially if serving clients that can come from anywhere in the world, ALWAYS assume dates are in UTC, and do the conversion as early as possible. It will keep hairs on your head, trust me.
    – Romain G
    Sep 29, 2016 at 13:58
10

I defined my own two functions

  • utc_time2datetime(utc_time, tz=None)
  • datetime2utc_time(datetime)

here:

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
3
  • 1
    I browsed straight past your example.. Way to messy and complicated for such a simple thing.. Not pythonic at all.
    – Angry 84
    Nov 16, 2018 at 4:18
  • @Mayhem: I cleaned it up a little and added comments. If you have a better and more generic solution to convert from time to datetime and back beeing able to set time zone - please let us know. Also let me know what a more pythonic example of my code should look like.
    – agittarius
    Nov 16, 2018 at 15:26
  • datetime is a poor choice of name for a function parameter in datetime2utc_time(datetime). It shadows the datetime import.
    – MathKid
    Aug 26, 2022 at 9:08
8

follow the python2.7 document, you have to use calendar.timegm() instead of time.mktime()

>>> d = datetime.date(2011,01,01)
>>> datetime.datetime.utcfromtimestamp(calendar.timegm(d.timetuple()))
datetime.datetime(2011, 1, 1, 0, 0)
1
  • 3
    how is it different from my answer if d is in UTC?
    – jfs
    Aug 20, 2014 at 18:19
6

A complete time-string contains:

  • date
  • time
  • utcoffset [+HHMM or -HHMM]

For example:

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

$ 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

Note:

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


Edit:

$ 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
2
  • 1
    @user908088 Convert 1970-01-01 06:00:00 +0500 to 3600 as you asked.
    – kev
    Jan 8, 2012 at 14:31
  • 1
    @user908088 There's no timezone in python2, you can do the calculation(06:00:00 - +0500 = 01:00:00) manually.
    – kev
    Jan 8, 2012 at 14:59
3

Using the arrow package:

>>> 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)
6
  • note: arrow uses dateutil and dateutil has known for many years bugs related to timezone handling. Don't use it if you need correct results for timezones with a non-fixed UTC offset (it is ok to use it for UTC timezone but the stdlib handles UTC case ok too).
    – jfs
    Mar 9, 2016 at 19:21
  • @J.F.Sebastian That bug only occurs during a transition, in an ambiguous time.
    – Paul
    Mar 15, 2016 at 20:17
  • Looks like the bug was fixed on March 28th Jun 20, 2016 at 15:55
  • Looks, like it is the best and cross-python solution. Just use arrow. Thanks;) Sep 1, 2017 at 12:48
  • @MathieuLongtin dateutil may have other issues
    – jfs
    Jan 7, 2018 at 6:19
2

the question is a little confused. timestamps are not UTC - they're a Unix thing. the date might be UTC? assuming it is, and if you're using Python 3.2+, simple-date makes this trivial:

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

if you actually have the year, month and day you don't need to create the date:

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

and if the date is in some other timezone (this matters because we're assuming midnight without an associated time):

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

[the idea behind simple-date is to collect all python's date and time stuff in one consistent class, so you can do any conversion. so, for example, it will also go the other way:

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

]

2
  • SimpleDate(date(2011,1,1), tz='America/New_York') raises NoTimezone, while pytz.timezone('America/New_York') doesn't raise any exceptions (simple-date==0.4.8, pytz==2014.7).
    – jfs
    Oct 1, 2014 at 17:18
  • I get an error on pip install simple-date, looks like it is python3/pip3 only.
    – NoBugs
    Jul 12, 2016 at 6:04
1

This works for me, pass through a function.

from datetime import timezone, datetime, timedelta 
import datetime


def utc_converter(dt):
    dt = datetime.datetime.now(timezone.utc)
    utc_time = dt.replace(tzinfo=timezone.utc)
    utc_timestamp = utc_time.timestamp()
    return utc_timestamp



# create start and end timestamps
_now = datetime.datetime.now()
str_start = str(utc_converter(_now))
_end = _now + timedelta(seconds=10)
str_end = str(utc_converter(_end))
0

i'm impressed of the deep discussion.

my 2 cents:

from datetime import datetime
import time

the timestamp in utc is:

timestamp = \
    (datetime.utcnow() - datetime(1970,1,1)).total_seconds()

or,

timestamp = time.time()

if now results from datetime.now(), in the same DST

utcoffset = (datetime.now() - datetime.utcnow()).total_seconds()
timestamp = \
    (now - datetime(1970,1,1)).total_seconds() - utcoffset
0

To convert a date into a UTC timestamp, it's best to specify explicitly the timezone before generating the timestamp:

from datetime import date, datetime, time, timezone


def utc_date_to_timestamp(utc_date: date):
    dt = datetime.combine(utc_date, time(tzinfo=timezone.utc))
    return dt.timestamp()

Note that in the above snippet, if we were to omit the timezone specification, we would have a potential problem if the local timezone is different from GMT (which is aligned with UTC). Consider this example:

my_date = date(2021, 1, 1)
wrong_timestamp = datetime.combine(my_date, time()).timestamp()
print(datetime.utcfromtimestamp(wrong_timestamp))  # 2020-12-31 18:00:00

Note that the specific value printed will differ depending on the local machine running the snippet.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.