区域信息¶
- dateutil.zoneinfo.get_zonefile_instance(new_instance=False)[源代码]¶
这是一个方便的函数,它提供了
ZoneInfoFile
方法提供的数据使用dateutil
包裹。默认情况下,它缓存ZoneInfoFile对象的单个实例并返回该实例。- 参数:
new_instance -- 如果
True
,一个新的实例ZoneInfoFile
被实例化并用作下一次调用的缓存实例。否则,仅在必要时创建新实例。- 返回:
返回一个
ZoneInfoFile
对象。
在 2.6 版本加入.
- dateutil.zoneinfo.gettz(name)[源代码]¶
这将从与dateutil打包的本地zoneinfo tarball中检索时区。
- 参数:
name -- 在zoneinfo文件中找到的IANA样式时区名称。
- 返回:
返回一个
dateutil.tz.tzfile
时区对象。
警告
一般不建议使用此函数,仅为与早期版本的API兼容而提供。这是 not 相当于
dateutil.tz.gettz()
,它根据输入选择合适的时区,支持系统zoneinfo。这仅用于访问特定于dateutil的zoneinfo(与系统zoneinfo相比,该zoneinfo可能已过时)。自 2.6 版本弃用: 如果需要在系统zoneinfo上使用特定的zoneinfo文件,请实例化
dateutil.zoneinfo.ZoneInfoFile
对象和调用dateutil.zoneinfo.ZoneInfoFile.get(name)()
取而代之的是。使用
get_zonefile_instance()
检索dateutil提供的zoneinfo的实例。
- dateutil.zoneinfo.gettz_db_metadata()[源代码]¶
获取区域文件元数据
- 返回:
包含数据库元数据的字典
自 2.6 版本弃用: 请参阅中的弃用警告
zoneinfo.gettz()
。要获取元数据,请查询属性zoneinfo.ZoneInfoFile.metadata
。
- dateutil.zoneinfo.rebuild.rebuild(filename, tag=None, format='gz', zonegroups=[], metadata=None)[源代码]¶
在dateutil/zoneinfo/zoneinfo中重建内部时区信息 tar
filename是来自的时区tarball
ftp.iana.org/tz
。
zonefile_metadata¶
zonefile元数据定义要下载的时区数据库的版本和确切位置。它用于 updatezinfo.py
脚本。源代码中包含一个json编码的文件,并包含在我们生成的每个tar文件中。json文件附在这里:
{
"metadata_version": 2.0,
"releases_url": [
"https://dateutil.github.io/tzdata/tzdata/",
"ftp://ftp.iana.org/tz/releases/"
],
"tzdata_file": "tzdata2021a.tar.gz",
"tzdata_file_sha512": "7cdd762ec90ce12a30fa36b1d66d1ea82d9fa21e514e2b9c7fcbe2541514ee0fadf30843ff352c65512fb270857b51d1517b45e1232b89c6f954ba9ff1833bb3",
"tzversion": "2021a",
"zonegroups": [
"africa",
"antarctica",
"asia",
"australasia",
"europe",
"northamerica",
"southamerica",
"etcetera",
"factory",
"backzone",
"backward"
]
}