python:timezone 对象
timezone 类是 tzinfo 的子类,它的每个实例都代表一个以与 UTC 的固定时差来定义的时区。
此类的对象不可被用于代表某些特殊地点的时区信息,这些地点在一年的不同日期会使用不同的时差,或是在历史上对民用时间进行过调整。
class datetime.timezone(offset, name=None)
offset 参数必须指定为一个 timedelta 对象,表示本地时间与 UTC 的时差。 它必须严格限制于 -timedelta(hours=24) 和 timedelta(hours=24) 之间,否则会引发 ValueError。
name 参数是可选的。 如果指定则必须为一个字符串,它将被用作 datetime.tzname() 方法的返回值。
3.2 新版功能.
在 3.7 版更改: UTC 时差不再限制为一个整数分钟值。
timezone.utcoffset(dt)
返回当 timezone 实例被构造时指定的固定值。
dt 参数会被忽略。 返回值是一个 timedelta 实例,其值等于本地时间与 UTC 之间的时差。
在 3.7 版更改: UTC 时差不再限制为一个整数分钟值。
timezone.tzname(dt)
返回当 timezone 实例被构造时指定的固定值。
如果没有在构造器中提供 name,则 tzname(dt) 所返回的名称将根据 offset 值按以下规则生成。 如果 offset 为 timedelta(0),则名称为“UTC”,否则为字符串 UTC±HH:MM,其中 ± 为 offset 的正负符号,HH 和 MM 分别为表示 offset.hours 和 offset.minutes 的两个数码。
在 3.6 版更改: Name generated from offset=timedelta(0) is now plain ‘UTC’, not ‘UTC+00:00’.
timezone.dst(dt)
总是返回 None。
timezone.fromutc(dt)
返回 dt + offset。 dt 参数必须为一个感知型 datetime 实例,其中 tzinfo 值设为 self。
类属性:
timezone.utc
UTC 时区,timezone(timedelta(0))。