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.

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.tzfile time zone object.

Warning

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