This is a convenience function which provides a ZoneInfoFile instance using the data provided by the dateutil package. By default, it caches a single instance of the ZoneInfoFile object and returns that.

Parameters:new_instance – If True, a new instance of ZoneInfoFile is instantiated and used as the cached instance for the next call. Otherwise, new instances are created only as necessary.
Returns:Returns a ZoneInfoFile object.

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 time 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, 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.ZoneInfoFile object and call dateutil.zoneinfo.ZoneInfoFile.get(name)() instead.

Use get_zonefile_instance() to retrieve an instance of the dateutil-provided zoneinfo.


Get the zonefile metadata

See zonefile_metadata

Returns:A dictionary with the database metadata

Deprecated since version 2.6: See deprecation warning in zoneinfo.gettz(). To get metadata, query the attribute zoneinfo.ZoneInfoFile.metadata.


The zonefile metadata defines the version and exact location of the timezone database to download. It is used in the script. A json encoded file is included in the source-code, and within each tar file we produce. The json file is attached here:

    "metadata_version": 2.0,
    "releases_url": [
    "tzdata_file": "tzdata2016i.tar.gz",
    "tzdata_file_sha512": "801059f43c91798cf69fb2ae77c1ffab8d06987325081511d573febde19ae423e7432c2b65c7c256077bbdb1b359e010302955786e18f2697bb263c4e0f1cc91",
    "tzversion": "2016i",
    "zonegroups": [