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个时区转换的单个偏移规则的格式提供。

Param

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

display()

返回时区的显示名称。

static list()

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

transitions(year)

对于给定的一年,获取DST的开启和关闭转换时间,通常在标准时间一侧表示。对于没有转换的区域,此函数返回 None .

参数

year -- 要查询其转换的年份。

返回

返回A tuple 属于 datetime.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 -- 要查询其转换的年份。

返回

返回A tuple 属于 datetime.datetime 物体, (dston, dstoff) 对于具有年度DST过渡的区域,或 None 对于固定偏移区域。