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 -- 您要查询其过渡的年份。
- 返回:
返回一个
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 -- 您要查询其过渡的年份。
- 返回:
返回一个
tuple
的datetime.datetime
对象,(dston, dstoff)
对于每年DST过渡的区域,或None
用于固定偏移分区。