tz.win

此模块为Windows上的本机时区数据提供接口,包括 datetime.tzinfo 实施。

尝试在非Windows平台上导入此模块将引发 ImportError

Classes

class dateutil.tz.win.tzres(tzres_loc='tzres.dll')[源代码]

类,用于访问 tzres.dll ,它包含与时区名称相关的资源。

在 2.5.0 版本加入.

load_name(offset)[源代码]

从DLL偏移量加载时区名称(整数)。

>>> from dateutil.tzwin import tzres
>>> tzr = tzres()
>>> print(tzr.load_name(112))
'Eastern Standard Time'
参数:

offset -- 引用来自tzres DLL的字符串的正整数值。

备注

在注册表中找到的偏移量通常为以下形式 @tzres.dll,-114 。本例中的偏移量是114,而不是-114。

name_from_string(tzname_str)[源代码]

将从Windows注册表返回的字符串解析为注册表中定义的时区名称。

>>> from dateutil.tzwin import tzres
>>> tzr = tzres()
>>> print(tzr.name_from_string('@tzres.dll,-251'))
'Dateline Daylight Time'
>>> print(tzr.name_from_string('Eastern Standard Time'))
'Eastern Standard Time'
参数:

tzname_str -- 从Windows注册表项返回的时区名称字符串。

返回:

如果字符串的格式为,则从tzres.dll返回本地化的时区字符串 @tzres.dll,-offset ,否则返回输入字符串。

class dateutil.tz.win.tzwin(name)[源代码]

从Windows注册表中的区域信息创建的时区对象

这些内容类似于 dateutil.tz.tzrange 对象,因为对于每年0或2个时区转换,以单个偏移规则的格式提供时区数据。

参数:

命名Windows时区键的名称,例如“东部标准时间”。可以使用以下命令检索完整的密钥列表 tzwin.list()

display()

返回时区的显示名称。

static list()

返回系统已知的所有时区的列表。

transitions(year)

对于给定的年份,获取DST的开和关转换时间,始终以标准时间表示。对于没有过渡的区域,此函数返回 None

参数:

year -- 您要查询其过渡的年份。

返回:

返回一个 tupledatetime.datetime 对象, (dston, dstoff) 对于每年DST过渡的区域,或 None 用于固定偏移分区。

class dateutil.tz.win.tzwinlocal[源代码]

类的新实例,该实例表示Windows注册表中的本地时区信息

而当 dateutil.tz.tzlocal 进行系统调用(通过 time 模块)来检索时区信息, tzwinlocal 直接从Windows注册表检索规则,并创建如下对象 dateutil.tz.tzwin

因为Windows没有等效于 time.tzset() ,在Windows上, dateutil.tz.tzlocal 实例将始终反映时区设置 在进程开始时 ,意味着在Windows上运行程序期间更改计算机的时区设置将 not 被反映在 dateutil.tz.tzlocal 。因为 tzwinlocal 直接读取注册表,它不受此问题的影响。

display()

返回时区的显示名称。

transitions(year)

对于给定的年份,获取DST的开和关转换时间,始终以标准时间表示。对于没有过渡的区域,此函数返回 None

参数:

year -- 您要查询其过渡的年份。

返回:

返回一个 tupledatetime.datetime 对象, (dston, dstoff) 对于每年DST过渡的区域,或 None 用于固定偏移分区。