python 学习笔记 14 -- 常用的时间模块之datetime

关注

原创最新推荐文章于 2026-08-24 09:46:23 发布 7.5k 阅读 AI 写同款· GEO 优化 ›

Python时间与日期处理：datetime模块的全面解析 Python的datetime模块为处理日期和时间提供了强大的工具，涵盖了从基础操作到高级技巧的广泛功能。本文详细解析了datetime模块的核心类，包括date、time、datetime、timedelta和tzinfo，并展示了如何创建、操作和格式化日期时间对象。此外，文章还介绍了时区处理、时间间隔计算以及日期时间的格式化与解析方法。通过掌握这些内容，开发者可以高效地处理各种时间日期相关任务，满足应用程序开发中的核心需求。阅读详情

书接上文，前面我们讲到《常用的时间模块之time》，这次我们学习datetime -- 日期和时间值管理模块

使用apihelper 查看datetime 模块，我们可以看到简单的几项：
date       --- 日期对象，结构为date(year, month, day)
time       --- 时间值对象，结构为 time([hour[, minute[, second[, microsecond[, tzinfo]]]]])。时间对象所有的参数都是可选的。tzinfo 可以是None 或者是tzinfo子类的一个实例。
datetime   --- 日期和时间管理对象，结构为 datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])。其中year, month 以及day 参数是必需的。而tzinfo 可以是None 或者是tzinfo子类的一个实例。
timedelta --- 两个datetime 值的差。用作datetime 对象之间的计算以及比较。
tzinfo     --- 时区信息对象的抽象基类。

我们可以看到datetime 模块下面还有好几个具体的类，下面分别从这几个类来分析datetime 模块：

1. date

1.1 date 类简介以及简单使用

date 是一个日期对象类，它有year,month和day三个属性。使用today()方法很容易创建一个表示当前日期的日期对象。当然，我们也可以手动指定年月日，从而直接使用datetime.date(year, month, day) 来创建一个日期对象，如：
   >>> da = datetime.date(1991, 1, 1)
   >>> da
   datetime.date(1991, 1, 1)
   >>> da.year                   # 还可以通过指定具体项获取对应值

1991

我们再来看看date 类的相关信息：
    >>> print datetime.date.resolution        # 日期对象的分辨率是一天
    1 day, 0:00:00
    >>> print datetime.date.min                # 日期对象最小值是1-1-1，下面会提到 toordinal 函数，它的返回值就是从这天计算的
    0001-01-01
    >>> print datetime.date.max                # 最大值

9999-12-31

date 对象之间是可以计算的，算算你到这个世界多久了？
   >>> bron_day = datetime.date(1991, 1, 1)   # 指定生日
   >>> today = datetime.date.today()           # 获取今天的date 信息
   >>> print today-bron_day
   8590 days, 0:00:00                           # date 对象之间直接相减，得到以日计算的差值
   >>> today < bron_day
   False                                       # 还可以直接对date 对象进行比较

1.2 date 类提供的方法

下面我们仍然使用apihelper (使用见《python 学习笔记 9 -- Python强大的自省简析》)来查看date 类还提供了哪些强大的方法：

(1) today

以当前时间获取一个日期对象
    >>> today = datetime.date.today()
    >>> today
    datetime.date(2014, 7, 8)

(2) ctime

将一个日期对象转化为ctime() 形式的字符串
>>> date.date.ctime(today)
'Tue Jul 8 00:00:00 2014'

(3) replace

对于日期对象，支持使用replace 方法直接修改具体项：
    >>> da = datetime.date(2008, 10, 1)
    >>> print da
    2008-10-01
   >>> print da.replace(2001, 1, 1)       # 不指定，可全部进行修改
   2001-01-01
    >>> print da.replace(year=2009, day=13)   # 符合python 的参数习惯，可以指定修改某一参数
    2009-10-13

(4) isoformat

以ISO 8601 格式("YYYY-MM-DD")返回一个日期对象：
>>> datetime.date.isoformat(today)
'2014-07-08'

(5) weekday 和 isoweekday

weekday -- 返回日期对象是周几。注意：返回值从0～6 ，也就是说Monday == 0 ... Sunday == 6。

isoweekday --返回日期对象是周几，但是isoweekday 返回值与weekday的返回值不一样，其返回值范围为1～7：Monday == 1 ... Sunday == 7。

    >>> time.ctime()
   'Wed Jul 9 11:24:58 2014'       # 今天是周三
   >>> today.weekday()
   2                               # 使用weekday 获取的返回值是2，因为它从0开始计数，周三对应2。
   >>> today.isoweekday()           # 使用isoweekday 获取的是3，符合日常使用习惯。
   3

(6) isocalendar

返回一个3元元组，值分别表示（年，第几周，周几）
>>> today.isocalendar()
(2014, 28, 3)

(7) strftime

与time.strftime 类似，用于将时间对像进行格式化转化：
>>> today.strftime('%Y-%m-%d %H:%M:%S')
'2014-07-09 00:00:00' # 至此，我们才发现默认使用 today = datetime.date.today() 获取今天日期对象，只获取了日期信息，而对应的时间默认使用了 00:00:00，后面我们会介绍使用 datetime 对象将日期对象和时间对像结合！

注：下面介绍的对象中都会涉及到 strftime 或 strptime, 其实用法都和前面 time 模块中介绍的一样，具体参数意义也请参见《python 学习笔记 13 -- 常用的时间模块之time》

(8) timetuple

以时间结构体 struct_time 形式返回时间信息，与time.localtime()兼容：
>>> today.timetuple()
time.struct_time(tm_year=2014, tm_mon=7, tm_mday=9, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=2, tm_yday=190, tm_isdst=-1)

(9) fromtimestamp

此函数能够解析time.time()返回的浮点值，返回一个datetime.date 日期值，格式为"datetime.date(2014, 7, 8)", 所以我们可以通过datetime.date.fromtimestamp(time.time()).year 来获取年（月，日亦可！）
   >>> time.time()
   1404876430.573843
   >>> datetime.date.fromtimestamp(1404876430)
   datetime.date(2014, 7, 9)
   >>> datetime.date.fromtimestamp(1404876430.0)
   datetime.date(2014, 7, 9)
   >>> datetime.date.fromtimestamp(1404876430.0).year
   2014

(10) toordinal 和fromordinal

toordinal -- 返回日期对象位于公历的序数，也就是说返回值是“ 时间对象是从1年1月1日起的第几天”（返回值是一个整数）。

fromordinal -- 上面的toordinal 会将一个日期对象经过计算，返回这个日期是1年1月1日开始的第几天。而fromordinal 功能刚好与toordinal相反，它可以计算出一个给定的整形数对应的日期对象。

    >>> today.toordinal()
   735423
    >>> datetime.date.fromordinal(735423)
    datetime.date(2014, 7, 9)

2. time

2.1 time 类简介以及简单使用

datetime 的 time类用来表示时间信息，如上面介绍的date 类，我们可以使用time([hour[, minute[, second[, microsecond[, tzinfo]]]]]) 来初始化时间对象。
我们再来看看time 类的相关信息：
    >>> print datetime.time.min            # 合法时间范围为00:00:00 ～ 23:59:59.999999
    00:00:00
    >>> print datetime.time.max
    23:59:59.999999
    >>> print datetime.time.resolution    # 分辨率限制为微秒级

0:00:00.000001

我们也可以直接指定项获取其内容：
   >>> ti = datetime.time(11, 36, 0)
   >>> ti.hour
   11

2.2 time 类提供的方法

下面我们仍然使用apihelper来查看time 类提供了哪些强大的方法：

(1) isoformat

以 ISO 8601 格式(HH:MM:SS[.mmmmmm][+HH:MM].)返回时间值：

>>> ti.isoformat()
'15:10:20'

(2) replace

与上面的日期类中的replace 方法类似，用于替换日期对象中的值：

    >>> ti = datetime.time(15, 10, 20)
    >>> ti.replace(hour = 12)
    datetime.time(12, 10, 20)

(3) strftime

如同上面的strftime 方法，以自定义的格式打印信息：

>>> ti.strftime('%Y-%m-%d %H:%M:%S')
'1900-01-01 15:10:20' # 看来未指定年月日，系统默认是1900-01-01

其他还有三个方法： dst, tzname, utcoffset ,一般应该用不上，这里就不介绍了！

3. datetime

3.1 datetime 类简介以及简单使用

使用datetime 类可以存储由日期和时间分量构成的值。

我们先看看预定给datetime 类的一些细节：
   >>> print datetime.datetime.resolution       # 同time， datetime 的精度为一微秒
   0:00:00.000001
   >>> print datetime.datetime.min               # datetime 最小值为0001年1月1日的0时0分0秒，这也是公历的起始
   0001-01-01 00:00:00
   >>> print datetime.datetime.max               # 最大值
   9999-12-31 23:59:59.999999

同上面date/time， datetime 也可以直接手动定义：" datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])" 其中year, month 以及day 参数是必需的。

    >>> datetime.datetime(2008, 11, 20, 10, 50)
   datetime.datetime(2008, 11, 20, 10, 50)
   >>> print datetime.datetime(2008, 11, 20, 10, 50).time()   # 可以直接使用time 和date 获取datetime 的时间和日期信息。
   10:50:00
   >>> print datetime.datetime(2008, 11, 20, 10, 50).time().hour   # 想要获取时间/日期信息下面的时分秒/年月日就要在使用time/date 之后再使用需要的项来获取。
   10

对于datetime 的十几种方法，我们按照官方手册将其分为“类方法”和“实例方法”两个方面来讲解：

3.2 类方法：

类方法可以理解成通过 datetime.datetime.**() 调用的方法，如：
now = datetime.datetime.now()
=====================================================

(1) today, now 和 utcnow

today      -- today 方法可以获取当前日期和时间(没有时区信息)，等于datetime.datetime.fromtimestamp(time.time())。
now([tz]) -- 返回当前日期和时间，如果没有使用tz 作为参数，其结果与today方法一样；如果有时区信息，则返回的时区对应的时间(注：这里要求的tz 是tzinfo 类的一个实例而不是一个字符串)。
utcnow     -- 方法与now 类似，只不过提供的是UTC 时间。（UTC，Coordinated Universal Time ，世界标准时间, now 得到的时间是根据UTC时间加上时区的）
    >>> datetime.datetime.now()
    datetime.datetime(2014, 7, 8, 20, 34, 59, 121292)
    >>> datetime.datetime.today()        # today 和now 获取的时间一致
    datetime.datetime(2014, 7, 8, 20, 35, 0, 565851)
    >>> datetime.datetime.utcnow()        # UTC 时间当前为12点，而我们北京时间处于东8区，加8个小时，刚好等于now/today显示的20点
    datetime.datetime(2014, 7, 8, 12, 35, 6, 89866)

(2) fromtimestamp 和 utcfromtimestamp

fromtimestamp(timestamp[, tz]) -- fromtimestamp 根据POSIX 的时间戳（比如time.time()）返回一个时间信息。与now 比较接近，如果没有携带'tz'参数，它会将时间戳转化为本地时间和日期；如果有时区信息'tz'，返回的是该时区的时间信息。
utcfromtimestamp(timestamp) -- 将时间戳转化为UTC 时间

    >>> datetime.datetime.utcfromtimestamp(time.time())
   datetime.datetime(2014, 7, 9, 6, 42, 3, 395073)
   >>> datetime.datetime.fromtimestamp(time.time())       # 本地时间，CST 比UTC时间多8小时
   datetime.datetime(2014, 7, 9, 14, 42, 7, 528134)
   >>> datetime.datetime.today()                           # 上面介绍today 时说了，today()的返回值与fromtimestamp(time.time())一样
   datetime.datetime(2014, 7, 9, 14, 42, 19, 450996)

(3) fromordinal

fromordinal -- 与下面要介绍的实例方法toordinal 相反，实例方法toordinal会将一个datetime 对象返回值为自公历1年1月1日起的第几天，而fromordinal 将一个天数（整形）计算出来对应的哪年哪月哪日。
    >>> now
    datetime.datetime(2014, 7, 8, 20, 41, 2, 882183)
    >>> datetime.datetime.toordinal(now)
    735422
    >>> datetime.datetime.fromordinal(735422)       # 因为toordinal 计算的只是第几天，未涉及到具体时间，所以fromordinal 转化后的时间为0:0:0
    datetime.datetime(2014, 7, 8, 0, 0)

(4) combine

conbine 方法可以将一个date 实例和一个time 实例结合创建一个datetime 实例。
    >>> today = datetime.date.today()
    >>> today.strftime('%Y-%m-%d %H:%M:%S')
    '2014-07-09 00:00:00'            # 使用 date.today() 只会接收今天的日期，不会接收时间信息，时间默认使用 00:00:00
    >>> now = datetime.time(12, 30, 00)
    >>> now.strftime('%Y-%m-%d %H:%M:%S')
    '1900-01-01 12:30:00'            # 使用time 设置时间后，日期默认使用 1900-01-01
    >>> print datetime.datetime.combine(today, now)
    '2014-07-09 12:30:00'            # 使用datetime 的combine 方法可以将上面的日期实例和时间实例集合为一个datetime 实例。

(5) strptime

同前面介绍time 中的strptime一样，strptime 可以将一个格式化打印的字符串整合成为原来的datetime 对象。

    >>> now = datetime.datetime.now()
    >>> now
    datetime.datetime(2014, 7, 9, 15, 54, 17, 742398)
    >>> now.strftime('%Y-%m-%d %H:%M:%S')        # 下面将要介绍的一个实例方法，其实和time.strftime 类似
    '2014-07-09 15:54:17'     # 此时是一个格式化打印的字符串\
    >>> datetime.datetime.strptime(now.strftime('%Y-%m-%d %H:%M:%S'), '%Y-%m-%d %H:%M:%S')
    datetime.datetime(2014, 7, 9, 15, 54, 17)             # 使用strptime 将字符串还原为 datetime 对象

3.3 实例方法：

实例方法可以理解成datetime 实例/对象调用的方法，如：
   now = datetime.datetime.now()
   now.***();       ### 其中*** 对应的就是实例方法
其实也可以使用datetime.datetime.***(now)来调用。举个例子：

   >>> now.date()   # date 就是下面要讲的实例方法之一
   datetime.date(2014, 7, 9)
   >>> datetime.datetime.date(now)   # 实例方法也可以通过类似于类方法那么调用，只不过需要实例/对象作为参数
   datetime.date(2014, 7, 9)
既然放在实例方法一节，下面例子中都使用 now.***() 方式调用。
==============================================

(1)date

返回datetime.datetime对象的日期值
   >>> now = datetime.datetime.now()
   >>> now.date()
   datetime.date(2014, 7, 9)

(2) time 和 timetz

time       --将一个datetime.datetime 对象的时间值返回
timetz     -- 使用相同的时间和时区返回time 对象
   >>> now.time()
   datetime.time(14, 48, 2, 224132)
   >>> now.timetz()
   datetime.time(14, 48, 2, 224132)

(3) replace

可以指定修改域对datetime 实例进行修改：
    >>> utcnow = datetime.datetime.utcnow()
    >>> utcnow
    datetime.datetime(2014, 7, 8, 12, 37, 21, 59472)
    >>> utcnow.replace(hour = 1)
    datetime.datetime(2014, 7, 8, 1, 37, 21, 59472)

(4) timetuple 和 utctimetuple

timetuple --将一个datetime.datetime 对象解析成一个struc_time结构体返回。（与time.localtime()的返回值类型一样）
utctimetuple -- 与上面timetuple类似，返回UTC时间的解析结构体
   >>> now.timetuple()
   time.struct_time(tm_year=2014, tm_mon=7, tm_mday=9, tm_hour=14, tm_min=48, tm_sec=2, tm_wday=2, tm_yday=190, tm_isdst=-1)
   >>> now.utctimetuple()
   time.struct_time(tm_year=2014, tm_mon=7, tm_mday=9, tm_hour=14, tm_min=48, tm_sec=2, tm_wday=2, tm_yday=190, tm_isdst=0)
    >>> time.localtime(time.time())           # 使用time.localtime 解析time()的浮点数得到的结果同timetuple 一样，都是struct_time 结构的时间
   time.struct_time(tm_year=2014, tm_mon=7, tm_mday=9, tm_hour=14, tm_min=51, tm_sec=12, tm_wday=2, tm_yday=190, tm_isdst=0)

(5) toordinal

返回一个整数，代表datetime.datetime 对象是从第1年第1月第1天算起的第几天。

(6) weekday 和 isoweekday

weekday    -- 返回datetime对象是周几，但是对应的值从0～6： Monday == 0 ... Sunday == 6
isoweekday -- 返回datetime对象是周几，对应的值从1～7： Monday == 1 ... Sunday == 7
   >>> now.ctime()               # 以ctime() 字符串形式打印datetime 对象的时间日期信息。下面会提到
   'Wed Jul 9 14:48:02 2014'       # 周三
   >>> now.weekday()
   2                               # 周三使用weekday 返回2
   >>> now.isoweekday()
   3                               # isoweekday 返回3

(7) isocalendar

返回一个三值的元组，格式为(年，第几周，周几)
>>> now.isocalendar()
(2014, 28, 3)

(8) isoformat

以ISO 8601 格式（YYYY-MM-DDTHH:MM:SS[.mmmmmm][+HH:MM]）打印datetime.datetime对象。默认使用的间隔符是'T'.
>>> datetime.datetime.isoformat(now)
'2014-07-08T20:41:02.882183'

(9) ctime

ctime -- 将datetime.datetime 对象解析成time.ctime 的字符串

(10) strftime

strftime   -- 同其他类一样，datetime 可以通过strftime 进行格式化打印成你想要的格式。（默认是用的是ISO-8601 格式：YYYY-MM-DDTHH:MM:SS.mmmmmm）
   >>> now.strftime('%Y-%m-%d %H:%M:%S')
   '2014-07-09 14:48:02'

(11) 其他

上面还未涉及到这几个函数astimezone, utcoffset, dst, tzname，都是与时区相关，一般涉及不到，此处不追逐。

4. timedelta

4.1 timedelta 类简介以及简单使用

   datetime 对象之间可以使用算术运算，或者结合一个datetime 和一个timedelta ，可以用来计算过去或将来的一些日期。两个日期相减可以生成一个timedelta，还可以对某个日期与一个timedelta 计算来得出另一个日期。所以可以理解成两个datetime 的中间变量，可以用于计算和比较。
来看看timedelta 的精度以及范围：
   >>> print datetime.timedelta.max
   999999999 days, 23:59:59.999999
   >>> print datetime.timedelta.min
   -999999999 days, 0:00:00
   >>> print datetime.timedelta.resolution       # 精度为1微秒
   0:00:00.000001

timedelta 的内部值按日、秒和毫秒存储：
   >>> td = datetime.timedelta(microseconds = 1); print "%s -- %r" %(td, td)
   0:00:00.000001 -- datetime.timedelta(0, 0, 1)
   >>> td = datetime.timedelta(milliseconds = 1); print "%s -- %r" %(td, td)
   0:00:00.001000 -- datetime.timedelta(0, 0, 1000)
   >>> td = datetime.timedelta(seconds = 1); print "%s -- %r" %(td, td)
   0:00:01 -- datetime.timedelta(0, 1)
   >>> td = datetime.timedelta(minutes = 1); print "%s -- %r" %(td, td)
   0:01:00 -- datetime.timedelta(0, 60)
   >>> td = datetime.timedelta(hours = 1); print "%s -- %r" %(td, td)
   1:00:00 -- datetime.timedelta(0, 3600)
   >>> td = datetime.timedelta(days = 1); print "%s -- %r" %(td, td)
   1 day, 0:00:00 -- datetime.timedelta(1)
   >>> td = datetime.timedelta(weeks = 1); print "%s -- %r" %(td, td)
   7 days, 0:00:00 -- datetime.timedelta(7)

4.2 timedelta 类提供的方法

   因为timedelta 只是一个用于计算的中间量，所以并没有提供很多方法，用apihelper 可以看到只提供一个方法total_seconds 用以返回一个timedelta 完整时间段的所有秒数:
   >>> td = datetime.timedelta(hours = 1); print td.total_seconds()
   3600.0

4.3 使用timedelta 计算

   >>> one_day = datetime.timedelta(days = 1);   # one_day 是一个定义为1天的timedelta 实例
   >>> today = datetime.date.today()                   # today 是date 实例
   >>> tomorrow = today + one_day              # 直接使用timedelta 实例与datetime 的date 实例进行计算
   >>> yestoday = today - one_day
   >>> today
   datetime.date(2014, 7, 8)
   >>> tomorrow
   datetime.date(2014, 7, 9)
   >>> yestoday
   datetime.date(2014, 7, 7)
   >>> tomorrow - yestoday            # 两个date 实例也可以计算
   datetime.timedelta(2)
   >>> print tomorrow - yestoday
   2 days, 0:00:00