||This is a convenience function which provides a
||This retrieves a time zone from the local zoneinfo tarball that is packaged|
||Get the zonefile metadata|
ZoneInfoFile.zones.get(). This is a convenience method for retrieving zones from the zone dictionary.
- name – The name of the zone to retrieve. (Generally IANA zone names)
- default – The value to return in the event of a missing key.
New in version 2.6.0.
This is a convenience function which provides a
ZoneInfoFileinstance using the data provided by the
dateutilpackage. By default, it caches a single instance of the ZoneInfoFile object and returns that.
Parameters: new_instance – If
True, a new instance of
ZoneInfoFileis instantiated and used as the cached instance for the next call. Otherwise, new instances are created only as necessary.
Returns: Returns a
New in version 2.6.
This retrieves a time zone from the local zoneinfo tarball that is packaged with dateutil.
Parameters: name – An IANA-style time zone name, as found in the zoneinfo file. Returns: Returns a
dateutil.tz.tzfiletime zone object.
It is generally inadvisable to use this function, and it is only provided for API compatibility with earlier versions. This is not equivalent to
dateutil.tz.gettz(), which selects an appropriate time zone based on the inputs, favoring system zoneinfo. This is ONLY for accessing the dateutil-specific zoneinfo (which may be out of date compared to the system zoneinfo).
Deprecated since version 2.6: If you need to use a specific zoneinfofile over the system zoneinfo, instantiate a
dateutil.zoneinfo.ZoneInfoFileobject and call
get_zonefile_instance()to retrieve an instance of the dateutil-provided zoneinfo.