优秀的编程知识分享平台

网站首页 > 技术文章 正文

python散装笔记——5: 日期和时间(1)

nanyue 2025-02-13 13:30:35 技术文章 7 ℃

1: 将字符串解析为时区感知的日期时间对象

Python 3.2+ 在将字符串解析为日期时间对象时支持 %z 格式。

UTC 偏移量,格式为 +HHMM-HHMM(如果对象是本地化的,则为空字符串)。

Python 3.x Version ≥ 3.2

import datetimebr
dt = datetime.datetime.strptime("2024-04-15T08:27:18-0500", "%Y-%m-%dT%H:%M:%S%z")

对于其他版本的 Python,可以使用 dateutil 这样的外部库,它可以快速将包含时区的字符串解析为日期时间对象。

import dateutil.parser
dt = dateutil.parser.parse("2024-04-15T08:27:18-0500")

dt 变量现在是一个日期时间对象,其值如下:

datetime.datetime(2024, 4, 15, 8, 27, 18, tzinfo=tzoffset(None, -18000))

2: 构建可识别时区的日期时间

默认情况下,所有日期时间对象都是本地化的。要使其具有时区感知功能,必须附加一个 tzinfo 对象,该对象可提供 UTC 偏移量和时区缩写,作为日期和时间的函数。

固定偏移时区

对于从 UTC 固定偏移的时区,在 Python 3.2+ 中,datetime 模块提供了时区类(timezone class),它是 tzinfo 的具体实现,需要一个 timedelta 和一个(可选的)名称参数:

Python 3.x 版本 ≥ 3.2

from datetime import datetime, timedelta, timezone
JST = timezone(timedelta(hours=+9))

dt = datetime(2025, 1, 1, 12, 0, 0, tzinfo=JST)
print(dt)
# 2025-01-01 12:00:00+09:00br

print(dt.tzname())
# UTC+09:00

dt = datetime(2025, 1, 1, 12, 0, 0, tzinfo=timezone(timedelta(hours=9), 'JST'))
print(dt.tzname)
# 

对于 3.2 之前的 Python 版本,有必要使用第三方库,如 dateutildateutil 提供了一个等价类 tzoffset,它(从 2.5.3 版起)接受 dateutil.tz.tzoffset(tzname, offset) 形式的参数,其中 offset 以秒为单位指定:

from datetime import datetime, timedelta
from dateutil import tz
JST = tz.tzoffset('JST', 9 * 3600) # 3600 seconds per hour
dt = datetime(2025, 1, 1, 12, 0, tzinfo=JST)
print(dt)
# 2025-01-01 12:00:00+09:00
print(dt.tzname)
# 'JST'

采用夏令时的地区

pytzdateutil 是提供时区类的常用库。

除了静态时区,dateutil 还提供了使用夏令时的时区类(参见 tz 模块的文档)。您可以使用 tz.gettz() 方法获取时区对象,然后直接将其传递给 datetime 构造函数:

from datetime import datetime
from dateutil import tz

local = tz.gettz() # Local time
PT = tz.gettz('US/Pacific') # Pacific time

dt_l = datetime(2025, 1, 1, 12, tzinfo=local) # I am in EST
dt_pst = datetime(2025, 1, 1, 12, tzinfo=PT)
dt_pdt = datetime(2024, 7, 1, 12, tzinfo=PT) # DST is handled automatically
print(dt_l)
# 2025-01-01 12:00:00-05:00
print(dt_pst)
# 2025-01-01 12:00:00-08:00
print(dt_pdt)
# 2024-07-01 12:00:00-07:00

注意:从 2.5.3 版开始,dateutil 无法正确处理含糊不清的日期时间,总是默认为较晚的日期。没有办法用 dateutil 时区构建一个对象,例如 2024-11-01 1:30 EDT-4,因为这是在夏令时转换期间。

使用 pytz 时,所有边缘情况都能得到妥善处理,但不应通过构造函数直接将 pytz 时区附加到时区上。相反,应使用时区的 localize 方法附加 pytz 时区:

from datetime import datetime, timedelta
import pytz

PT = pytz.timezone('US/Pacific')
dt_pst = PT.localize(datetime(2025, 1, 1, 12))
dt_pdt = PT.localize(datetime(2024, 11, 1, 0, 30))
print(dt_pst)
# 2025-01-01 12:00:00-08:00
print(dt_pdt)
# 2024-11-01 00:30:00-07:00

需要注意的是,如果在 pytz 感知的时区上执行日期时间运算,则必须以 UTC 进行计算(如果需要绝对经过时间),或者必须对计算结果调用 normalize():

dt_new = dt_pdt + timedelta(hours=3) # This should be 2:30 AM PST
print(dt_new)
# 2024-11-01 03:30:00-07:00
dt_corrected = PT.normalize(dt_new)
print(dt_corrected)
# 2024-11-01 02:30:00-08:00

3: 计算时间差

timedelta 模块在计算时间差时非常有用:

from datetime import datetime, timedelta
now = datetime.now()
then = datetime(2024, 5, 23) # datetime.datetime(2024, 05, 23, 0, 0, 0)

创建新的日期时间对象时,指定时间是可选项:

delta = now-then

deltatimedelta 类型:

print(delta.days)
# 213 (运行此代码段的时间为2024年12月22日)
print(delta.seconds)
# 47554

要获得 n 天后的日期和 n 天前的日期,我们可以使用以下方法:

单前日期后 n 天:

def get_n_days_after_date(date_format="%d %B %Y", add_days=120):
    date_n_days_after = datetime.datetime.now() + timedelta(days=add_days)
    return date_n_days_after.strftime(date_format)

下面的截图,是计算 120 天后的日期,运行的日期是2024年12月22日,所以得到的结果是 2025 年 4 月21日。

单前日期前 n 天:

def get_n_days_before_date(date_format="%d %B %Y", days_before=120):
    date_n_days_ago = datetime.datetime.now() - timedelta(days=days_before)
    return date_n_days_ago.strftime(date_format)

下面的截图,是计算 120 天前的日期,运行的日期是2024年12月22日,所以得到的结果是 2024 年 8 月24日。

4: 日期时间对象的基本用法

日期时间模块包含三种主要类型的对象:datetime、和 datetime

import datetime

# Date object
today = datetime.date.today()
new_year = datetime.date(2025, 01, 01) #datetime.date(2025, 1, 1)

# Time object
noon = datetime.time(12, 0, 0) #datetime.time(12, 0)

# Current datetimebr
now = datetime.datetime.now()

# Datetime object
millenium_turn = datetime.datetime(2020, 1, 1, 0, 0, 0) #datetime.datetime(2020, 1, 1, 0, 0)

这些对象的算术运算只支持在相同数据类型内进行,对不同类型的实例进行简单算术运算将导致 TypeError


# subtraction of noon from todaybr
noon-todaybr
Traceback (most recent call last):br
  File "", line 1, in br
TypeError: unsupported operand type(s) for -: 'datetime.time' and 'datetime.date'br
However, it is straightforward to convert between types.br
br
# Do this insteadbr
print('Time since the millenium at midnight: ',br
      datetime.datetime(today.year, today.month, today.day) - millenium_turn)br
br
# Or thisbr
print('Time since the millenium at noon: ',br
      datetime.datetime.combine(today, noon) - millenium_turn)

5: 在时区之间切换

要在不同时区之间切换,需要使用具有时区感知功能的日期时间对象。

from datetime import datetime
from dateutil import tz

utc = tz.tzutc()
local = tz.tzlocal()

utc_now = datetime.utcnow()
utc_now # Not timezone-aware.

utc_now = utc_now.replace(tzinfo=utc)
utc_now # Timezone-aware.

local_now = utc_now.astimezone(local)
local_now # Converted to local time.

6: 简单的日期计算

日期并不是孤立存在的。通常,您需要查找日期之间的时间间隔或确定明天的日期。这可以通过使用 timedelta 对象来实现

import datetimebr

today = datetime.date.today()
print('Today:', today)

yesterday = today - datetime.timedelta(days=1)
print('Yesterday:', yesterday)

tomorrow = today + datetime.timedelta(days=1)
print('Tomorrow:', tomorrow)

print('Time between tomorrow and yesterday:', tomorrow - yesterday)

其结果类似于:

Today: 2024-12-22
Yesterday: 2024-12-21
Tomorrow: 2024-12-23
Difference between tomorrow and yesterday: 2 days, 0:00:00
最近发表
标签列表