乐趣区

pytz时区相关模块

jiezi

最近开发过程中遇到这样一个问题:

在使用 datetime 模块获取当前时间之后, 与程序中某些时间操作会报错:

TypeError: can't subtract offset-naive and offset-aware datetimes

这个我就有点纳闷了, 怎么会报这个错误呢? 然后我开始搜资料, 原来在有两种时间类型:naive 和 aware

  • naive

    • 没有表明时区的时间. 如: datetime.datetime.now()
    •   datetime.datetime(2019, 7, 8, 14, 13, 52, 534690)

  • aware

    • 有时区的时间. 如:datetime.datetime.now(pytz.utc)
    •   datetime.datetime(2019, 7, 8, 6, 22, 16, 245504, tzinfo=<UTC>)

可以发现 aware 类型时间在打印对象信息时多了一个 tzinfo, 没错, 这个就是用来标识时区的. 而因为我们获取当前的时候没有传入时区, 为 naive 类型, 所以与有些 aware 时间操作会发生异常, 其实解决方法也很简单, 将 naive 转化为 aware 类型就好了, 怎样转化呢? 我找到了这几种方式:

方式一 

datetime.datetime.now().replace(tzinfo=pytz.utc)

方式二 

datetime.datetime.now(pytz.utc)

方式三 

pytz.utc.localize(datetime.datetime.now())

而第二种生成方式是在创建时间的时候指定时间, 其他两种可以用来转化 / 修改时区. 写了这么多, 你们肯定在疑惑一个东西:pytz
这是一个时区模块, 用来在 python 中进行一个时区的相关操作. 其提供的对象方法为 

__all__ = [
    'timezone', 'utc', 'country_timezones', 'country_names',
    'AmbiguousTimeError', 'InvalidTimeError',
    'NonExistentTimeError', 'UnknownTimeZoneError',
    'all_timezones', 'all_timezones_set',
    'common_timezones', 'common_timezones_set',
]

接下来我们一个个介绍:

  • timezone: 传入一个时区, 如:Asia/Shanghai, 返回一个时区对象 

    • pytz.timezone('Asia/Shanghai')
>>> <DstTzInfo 'Asia/Shanghai' LMT+8:06:00 STD>

  • utc: 返回一个 utc 时区对象 

    • pytz.utc
>>> <UTC>

  • country_timezones: 传入一个国家英文缩写, 返回拥有的时区, 如: 中国 (‘CN’), 不传则返回由 247 个国家缩写为 key, 时区为值的 dict

    • pytz.country_timezones('CN')
>>> [u'Asia/Shanghai', u'Asia/Urumqi']

  • country_names: 拿一个国家英文缩写, 返回国家完整英文名称 

    • pytz.country_names['CN']
>>>  u'China'

  • all_timezones: 所有时区的列表 (591 个)

    • pytz.all_timezones
>>>  ['Asia/Shanghai', 'Asia/Urumqi', ...] # 有 591 个, 所以还是列一下咱们国家的时区

  • all_timezones_set: 所有时区的集合 

    • pytz.all_timezones_set
>>>  {'Asia/Shanghai', 'Asia/Urumqi', ...}

  • common_timezones: 常用的时区列表 (439 个)

    • pytz.common_timezones
>>>  ['Asia/Shanghai', 'Asia/Urumqi', ...] # 有 439 个

  • common_timezones_set: 常用的时区集合 

    • pytz.common_timezones
>>>  {'Asia/Shanghai', 'Asia/Urumqi', ...}
  • AmbiguousTimeError: 模糊时间错误
  • InvalidTimeError: 无效时间错误
  • NonExistentTimeError: 不存在的时间错误
  • UnknownTimeZoneError: 未知的时区错误
退出移动版