Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
2to3.html	70.96 KB	-rw-r--r--
__future__.html	20.75 KB	-rw-r--r--
__main__.html	44.87 KB	-rw-r--r--
_thread.html	30.39 KB	-rw-r--r--
abc.html	46.87 KB	-rw-r--r--
aifc.html	35.56 KB	-rw-r--r--
allos.html	34.33 KB	-rw-r--r--
archiving.html	17 KB	-rw-r--r--
argparse.html	300.89 KB	-rw-r--r--
array.html	37.28 KB	-rw-r--r--
ast.html	293.08 KB	-rw-r--r--
asynchat.html	37.41 KB	-rw-r--r--
asyncio-api-index.html	27.68 KB	-rw-r--r--
asyncio-dev.html	36.1 KB	-rw-r--r--
asyncio-eventloop.html	204.43 KB	-rw-r--r--
asyncio-exceptions.html	17.11 KB	-rw-r--r--
asyncio-future.html	38.23 KB	-rw-r--r--
asyncio-llapi-index.html	61.97 KB	-rw-r--r--
asyncio-platforms.html	21.77 KB	-rw-r--r--
asyncio-policy.html	39.56 KB	-rw-r--r--
asyncio-protocol.html	118.33 KB	-rw-r--r--
asyncio-queue.html	31.86 KB	-rw-r--r--
asyncio-stream.html	69.98 KB	-rw-r--r--
asyncio-subprocess.html	49.25 KB	-rw-r--r--
asyncio-sync.html	42.79 KB	-rw-r--r--
asyncio-task.html	109.14 KB	-rw-r--r--
asyncio.html	17.31 KB	-rw-r--r--
asyncore.html	49.36 KB	-rw-r--r--
atexit.html	22.87 KB	-rw-r--r--
audioop.html	46 KB	-rw-r--r--
audit_events.html	72.85 KB	-rw-r--r--
base64.html	48.09 KB	-rw-r--r--
bdb.html	66 KB	-rw-r--r--
binary.html	15.97 KB	-rw-r--r--
binascii.html	36.3 KB	-rw-r--r--
binhex.html	15.97 KB	-rw-r--r--
bisect.html	43.38 KB	-rw-r--r--
builtins.html	14.87 KB	-rw-r--r--
bz2.html	50.68 KB	-rw-r--r--
calendar.html	69.35 KB	-rw-r--r--
cgi.html	59.95 KB	-rw-r--r--
cgitb.html	19.96 KB	-rw-r--r--
chunk.html	22.21 KB	-rw-r--r--
cmath.html	43.89 KB	-rw-r--r--
cmd.html	50.42 KB	-rw-r--r--
code.html	35.38 KB	-rw-r--r--
codecs.html	157.96 KB	-rw-r--r--
codeop.html	18.26 KB	-rw-r--r--
collections.abc.html	79.17 KB	-rw-r--r--
collections.html	189.43 KB	-rw-r--r--
colorsys.html	17.31 KB	-rw-r--r--
compileall.html	50.68 KB	-rw-r--r--
concurrency.html	24.15 KB	-rw-r--r--
concurrent.futures.html	79.03 KB	-rw-r--r--
concurrent.html	11.56 KB	-rw-r--r--
configparser.html	159.4 KB	-rw-r--r--
constants.html	22.41 KB	-rw-r--r--
contextlib.html	117.2 KB	-rw-r--r--
contextvars.html	38.38 KB	-rw-r--r--
copy.html	17.92 KB	-rw-r--r--
copyreg.html	18.63 KB	-rw-r--r--
crypt.html	28.29 KB	-rw-r--r--
crypto.html	13.93 KB	-rw-r--r--
csv.html	82.89 KB	-rw-r--r--
ctypes.html	295.49 KB	-rw-r--r--
curses.ascii.html	32.04 KB	-rw-r--r--
curses.html	221.24 KB	-rw-r--r--
curses.panel.html	22.16 KB	-rw-r--r--
custominterp.html	11.85 KB	-rw-r--r--
dataclasses.html	113.16 KB	-rw-r--r--
datatypes.html	31.82 KB	-rw-r--r--
datetime.html	374.92 KB	-rw-r--r--
dbm.html	51.16 KB	-rw-r--r--
debug.html	17 KB	-rw-r--r--
decimal.html	270.12 KB	-rw-r--r--
development.html	32.34 KB	-rw-r--r--
devmode.html	31.72 KB	-rw-r--r--
dialog.html	43.03 KB	-rw-r--r--
difflib.html	111.99 KB	-rw-r--r--
dis.html	136.07 KB	-rw-r--r--
distribution.html	13.67 KB	-rw-r--r--
distutils.html	14.73 KB	-rw-r--r--
doctest.html	199.32 KB	-rw-r--r--
email.charset.html	31.92 KB	-rw-r--r--
email.compat32-message.html	97.74 KB	-rw-r--r--
email.contentmanager.html	37.02 KB	-rw-r--r--
email.encoders.html	18.47 KB	-rw-r--r--
email.errors.html	24.45 KB	-rw-r--r--
email.examples.html	60.49 KB	-rw-r--r--
email.generator.html	48.79 KB	-rw-r--r--
email.header.html	37.61 KB	-rw-r--r--
email.headerregistry.html	66.26 KB	-rw-r--r--
email.html	30.75 KB	-rw-r--r--
email.iterators.html	18.23 KB	-rw-r--r--
email.message.html	99.75 KB	-rw-r--r--
email.mime.html	44.89 KB	-rw-r--r--
email.parser.html	57.39 KB	-rw-r--r--
email.policy.html	84.24 KB	-rw-r--r--
email.utils.html	42.57 KB	-rw-r--r--
ensurepip.html	23.9 KB	-rw-r--r--
enum.html	151 KB	-rw-r--r--
errno.html	60.17 KB	-rw-r--r--
exceptions.html	108.44 KB	-rw-r--r--
faulthandler.html	31.5 KB	-rw-r--r--
fcntl.html	36.67 KB	-rw-r--r--
filecmp.html	32.08 KB	-rw-r--r--
fileformats.html	13.52 KB	-rw-r--r--
fileinput.html	40.37 KB	-rw-r--r--
filesys.html	16.78 KB	-rw-r--r--
fnmatch.html	21.02 KB	-rw-r--r--
fractions.html	35.29 KB	-rw-r--r--
frameworks.html	16.15 KB	-rw-r--r--
ftplib.html	71.97 KB	-rw-r--r--
functional.html	12.19 KB	-rw-r--r--
functions.html	260.33 KB	-rw-r--r--
functools.html	92.96 KB	-rw-r--r--
gc.html	40.97 KB	-rw-r--r--
getopt.html	29.4 KB	-rw-r--r--
getpass.html	16.01 KB	-rw-r--r--
gettext.html	98.02 KB	-rw-r--r--
glob.html	27.2 KB	-rw-r--r--
graphlib.html	34.82 KB	-rw-r--r--
grp.html	16.03 KB	-rw-r--r--
gzip.html	45.65 KB	-rw-r--r--
hashlib.html	93.19 KB	-rw-r--r--
heapq.html	42.43 KB	-rw-r--r--
hmac.html	24.74 KB	-rw-r--r--
html.entities.html	14.91 KB	-rw-r--r--
html.html	14.81 KB	-rw-r--r--
html.parser.html	47.7 KB	-rw-r--r--
http.client.html	85.63 KB	-rw-r--r--
http.cookiejar.html	113.94 KB	-rw-r--r--
http.cookies.html	47.64 KB	-rw-r--r--
http.html	45.52 KB	-rw-r--r--
http.server.html	73.05 KB	-rw-r--r--
i18n.html	13.44 KB	-rw-r--r--
idle.html	77.18 KB	-rw-r--r--
imaplib.html	87.08 KB	-rw-r--r--
imghdr.html	17.94 KB	-rw-r--r--
imp.html	54.32 KB	-rw-r--r--
importlib.html	239.96 KB	-rw-r--r--
importlib.metadata.html	43.14 KB	-rw-r--r--
index.html	75.06 KB	-rw-r--r--
inspect.html	168.74 KB	-rw-r--r--
internet.html	29.89 KB	-rw-r--r--
intro.html	13.81 KB	-rw-r--r--
io.html	154.15 KB	-rw-r--r--
ipaddress.html	137.75 KB	-rw-r--r--
ipc.html	12.6 KB	-rw-r--r--
itertools.html	153.27 KB	-rw-r--r--
json.html	98.9 KB	-rw-r--r--
keyword.html	14.88 KB	-rw-r--r--
language.html	16.71 KB	-rw-r--r--
linecache.html	18.09 KB	-rw-r--r--
locale.html	77.35 KB	-rw-r--r--
logging.config.html	100.3 KB	-rw-r--r--
logging.handlers.html	146.28 KB	-rw-r--r--
logging.html	169.67 KB	-rw-r--r--
lzma.html	66.89 KB	-rw-r--r--
mailbox.html	176.34 KB	-rw-r--r--
mailcap.html	20.86 KB	-rw-r--r--
markup.html	22.31 KB	-rw-r--r--
marshal.html	24.43 KB	-rw-r--r--
math.html	85.82 KB	-rw-r--r--
mimetypes.html	40.27 KB	-rw-r--r--
mm.html	11.16 KB	-rw-r--r--
mmap.html	55.53 KB	-rw-r--r--
modulefinder.html	23.67 KB	-rw-r--r--
modules.html	15.88 KB	-rw-r--r--
msilib.html	78.38 KB	-rw-r--r--
msvcrt.html	29.22 KB	-rw-r--r--
multiprocessing.html	405.24 KB	-rw-r--r--
multiprocessing.shared_memory....	60 KB	-rw-r--r--
netdata.html	20.24 KB	-rw-r--r--
netrc.html	20.39 KB	-rw-r--r--
nis.html	16.76 KB	-rw-r--r--
nntplib.html	84.93 KB	-rw-r--r--
numbers.html	45.67 KB	-rw-r--r--
numeric.html	19.29 KB	-rw-r--r--
operator.html	107.32 KB	-rw-r--r--
optparse.html	256.96 KB	-rw-r--r--
os.html	594.39 KB	-rw-r--r--
os.path.html	65.54 KB	-rw-r--r--
ossaudiodev.html	56.35 KB	-rw-r--r--
pathlib.html	170.01 KB	-rw-r--r--
pdb.html	68.67 KB	-rw-r--r--
persistence.html	19.13 KB	-rw-r--r--
pickle.html	154.45 KB	-rw-r--r--
pickletools.html	22.92 KB	-rw-r--r--
pipes.html	21.7 KB	-rw-r--r--
pkgutil.html	42.76 KB	-rw-r--r--
platform.html	45.08 KB	-rw-r--r--
plistlib.html	30.06 KB	-rw-r--r--
poplib.html	41.42 KB	-rw-r--r--
posix.html	20.96 KB	-rw-r--r--
pprint.html	55.35 KB	-rw-r--r--
profile.html	84.63 KB	-rw-r--r--
pty.html	23.7 KB	-rw-r--r--
pwd.html	16.84 KB	-rw-r--r--
py_compile.html	29 KB	-rw-r--r--
pyclbr.html	24.06 KB	-rw-r--r--
pydoc.html	19.59 KB	-rw-r--r--
pyexpat.html	104.38 KB	-rw-r--r--
python.html	22.46 KB	-rw-r--r--
queue.html	43.39 KB	-rw-r--r--
quopri.html	18.64 KB	-rw-r--r--
random.html	86.31 KB	-rw-r--r--
re.html	214.24 KB	-rw-r--r--
readline.html	50.19 KB	-rw-r--r--
reprlib.html	30.85 KB	-rw-r--r--
resource.html	48.26 KB	-rw-r--r--
rlcompleter.html	18.06 KB	-rw-r--r--
runpy.html	30.99 KB	-rw-r--r--
sched.html	27.04 KB	-rw-r--r--
secrets.html	30.2 KB	-rw-r--r--
security_warnings.html	16.21 KB	-rw-r--r--
select.html	74.58 KB	-rw-r--r--
selectors.html	41.91 KB	-rw-r--r--
shelve.html	36.54 KB	-rw-r--r--
shlex.html	61.03 KB	-rw-r--r--
shutil.html	100.13 KB	-rw-r--r--
signal.html	95.39 KB	-rw-r--r--
site.html	38.16 KB	-rw-r--r--
smtpd.html	44.09 KB	-rw-r--r--
smtplib.html	81.4 KB	-rw-r--r--
sndhdr.html	16.4 KB	-rw-r--r--
socket.html	256.95 KB	-rw-r--r--
socketserver.html	91.95 KB	-rw-r--r--
spwd.html	16.71 KB	-rw-r--r--
sqlite3.html	225.51 KB	-rw-r--r--
ssl.html	328.83 KB	-rw-r--r--
stat.html	57.79 KB	-rw-r--r--
statistics.html	123.22 KB	-rw-r--r--
stdtypes.html	615.43 KB	-rw-r--r--
string.html	108.03 KB	-rw-r--r--
stringprep.html	24.94 KB	-rw-r--r--
struct.html	70.58 KB	-rw-r--r--
subprocess.html	199.03 KB	-rw-r--r--
sunau.html	39.84 KB	-rw-r--r--
superseded.html	26.21 KB	-rw-r--r--
symtable.html	33.26 KB	-rw-r--r--
sys.html	198.83 KB	-rw-r--r--
sysconfig.html	39.81 KB	-rw-r--r--
syslog.html	27.36 KB	-rw-r--r--
tabnanny.html	16.18 KB	-rw-r--r--
tarfile.html	161.92 KB	-rw-r--r--
telnetlib.html	38.21 KB	-rw-r--r--
tempfile.html	58.39 KB	-rw-r--r--
termios.html	22.86 KB	-rw-r--r--
test.html	222.85 KB	-rw-r--r--
text.html	16.8 KB	-rw-r--r--
textwrap.html	48.83 KB	-rw-r--r--
threading.html	128.33 KB	-rw-r--r--
time.html	107.46 KB	-rw-r--r--
timeit.html	52.63 KB	-rw-r--r--
tk.html	28.08 KB	-rw-r--r--
tkinter.colorchooser.html	14.49 KB	-rw-r--r--
tkinter.dnd.html	17.09 KB	-rw-r--r--
tkinter.font.html	22.21 KB	-rw-r--r--
tkinter.html	106.85 KB	-rw-r--r--
tkinter.messagebox.html	20.09 KB	-rw-r--r--
tkinter.scrolledtext.html	14.52 KB	-rw-r--r--
tkinter.tix.html	59.69 KB	-rw-r--r--
tkinter.ttk.html	138.37 KB	-rw-r--r--
token.html	45.73 KB	-rw-r--r--
tokenize.html	39.86 KB	-rw-r--r--
trace.html	38.85 KB	-rw-r--r--
traceback.html	75.61 KB	-rw-r--r--
tracemalloc.html	122.33 KB	-rw-r--r--
tty.html	14.46 KB	-rw-r--r--
turtle.html	271.71 KB	-rw-r--r--
types.html	64.85 KB	-rw-r--r--
typing.html	315.69 KB	-rw-r--r--
unicodedata.html	27.3 KB	-rw-r--r--
unittest.html	310.01 KB	-rw-r--r--
unittest.mock-examples.html	177.75 KB	-rw-r--r--
unittest.mock.html	363.51 KB	-rw-r--r--
unix.html	13.46 KB	-rw-r--r--
urllib.error.html	18.56 KB	-rw-r--r--
urllib.html	12.92 KB	-rw-r--r--
urllib.parse.html	104.65 KB	-rw-r--r--
urllib.request.html	208.87 KB	-rw-r--r--
urllib.robotparser.html	22.63 KB	-rw-r--r--
uu.html	18.2 KB	-rw-r--r--
uuid.html	42.88 KB	-rw-r--r--
venv.html	90.43 KB	-rw-r--r--
warnings.html	69.13 KB	-rw-r--r--
wave.html	36.12 KB	-rw-r--r--
weakref.html	73.36 KB	-rw-r--r--
webbrowser.html	33.98 KB	-rw-r--r--
windows.html	12.32 KB	-rw-r--r--
winreg.html	89.48 KB	-rw-r--r--
winsound.html	26.3 KB	-rw-r--r--
wsgiref.html	111.52 KB	-rw-r--r--
xdrlib.html	42.07 KB	-rw-r--r--
xml.dom.html	114.66 KB	-rw-r--r--
xml.dom.minidom.html	49.6 KB	-rw-r--r--
xml.dom.pulldom.html	30.06 KB	-rw-r--r--
xml.etree.elementtree.html	186.49 KB	-rw-r--r--
xml.html	22.34 KB	-rw-r--r--
xml.sax.handler.html	55.78 KB	-rw-r--r--
xml.sax.html	31.74 KB	-rw-r--r--
xml.sax.reader.html	56.23 KB	-rw-r--r--
xml.sax.utils.html	22.28 KB	-rw-r--r--
xmlrpc.client.html	79.73 KB	-rw-r--r--
xmlrpc.html	11.9 KB	-rw-r--r--
xmlrpc.server.html	63.56 KB	-rw-r--r--
zipapp.html	52.45 KB	-rw-r--r--
zipfile.html	116.59 KB	-rw-r--r--
zipimport.html	33.76 KB	-rw-r--r--
zlib.html	42.29 KB	-rw-r--r--
zoneinfo.html	57.25 KB	-rw-r--r--

Code Editor : zoneinfo.html

<!DOCTYPE html>

<title>zoneinfo — IANA time zone support &#8212; Python 3.10.12 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
 <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
 <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?2022.1" />
 
 <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
 <script src="../_static/jquery.js"></script>
 <script src="../_static/underscore.js"></script>
 <script src="../_static/doctools.js"></script>
 
 <script src="../_static/sidebar.js"></script>
 
 <link rel="search" type="application/opensearchdescription+xml"
 title="Search within Python 3.10.12 documentation"
 href="../_static/opensearch.xml"/>
 <link rel="author" title="About these documents" href="../about.html" />
 <link rel="index" title="Index" href="../genindex.html" />
 <link rel="search" title="Search" href="../search.html" />
 <link rel="copyright" title="Copyright" href="../copyright.html" />
 <link rel="next" title="calendar — General calendar-related functions" href="calendar.html" />
 <link rel="prev" title="datetime — Basic date and time types" href="datetime.html" />
 <link rel="canonical" href="file:///usr/share/doc/python3.10/html/library/zoneinfo.html" />

</head>
<body>
<div class="mobile-nav">
 <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"
 aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />
 <label for="menuToggler" class="toggler__label">
 
 </label>
 <nav class="nav-content" role="navigation">
 <a href="https://www.python.org/" class="nav-logo">
 <img src="../_static/py.svg" alt="Logo"/>
 </a>
 <div class="version_switcher_placeholder"></div>
 <form role="search" class="search" action="../search.html" method="get">
 <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">
 <path fill-rule="nonzero"
 d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z" fill="#444"></path>
 </svg>
 <input type="text" name="q" aria-label="Quick search"/>
 <input type="submit" value="Go"/>
 </form>
 </nav>
 <div class="menu-wrapper">
 <nav class="menu" role="navigation" aria-label="main navigation">
 <div class="language_switcher_placeholder"></div>
 <h3><a href="../contents.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate">zoneinfo</code> — IANA time zone support</a><ul>
<li><a class="reference internal" href="#using-zoneinfo">Using <code class="docutils literal notranslate">ZoneInfo</code></a></li>
<li><a class="reference internal" href="#data-sources">Data sources</a><ul>
<li><a class="reference internal" href="#configuring-the-data-sources">Configuring the data sources</a><ul>
<li><a class="reference internal" href="#compile-time-configuration">Compile-time configuration</a></li>
<li><a class="reference internal" href="#environment-configuration">Environment configuration</a></li>
<li><a class="reference internal" href="#runtime-configuration">Runtime configuration</a></li>
</ul>
</li>
</ul>
</li>
<li><a class="reference internal" href="#the-zoneinfo-class">The <code class="docutils literal notranslate">ZoneInfo</code> class</a><ul>
<li><a class="reference internal" href="#string-representations">String representations</a></li>
<li><a class="reference internal" href="#pickle-serialization">Pickle serialization</a></li>
</ul>
</li>
<li><a class="reference internal" href="#functions">Functions</a></li>
<li><a class="reference internal" href="#globals">Globals</a></li>
<li><a class="reference internal" href="#exceptions-and-warnings">Exceptions and warnings</a></li>
</ul>
</li>
</ul>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="../py-modindex.html" title="Python Module Index"
 >modules</a> |</li>
 <li class="right" >
 <a href="calendar.html" title="calendar — General calendar-related functions"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="datetime.html" title="datetime — Basic date and time types"
 accesskey="P">previous</a> |</li>

<li><img src="../_static/py.svg" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
 <li><a href="https://www.python.org/">Python</a> &#187;</li>
 <li class="switchers">
 <div class="language_switcher_placeholder"></div>
 <div class="version_switcher_placeholder"></div>
 </li>
 <li>
 
 </li>
 <li id="cpython-language-and-version">
 <a href="../index.html">3.10.12 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="datatypes.html" accesskey="U">Data Types</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate">zoneinfo</code> — IANA time zone support</a></li>
 <li class="right">

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="module-zoneinfo">
<h1><a class="reference internal" href="#module-zoneinfo" title="zoneinfo: IANA time zone support"><code class="xref py py-mod docutils literal notranslate">zoneinfo</code></a> — IANA time zone support<a class="headerlink" href="#module-zoneinfo" title="Permalink to this headline">¶</a></h1>
<div class="versionadded">
New in version 3.9.
</div>
Source code: <a class="reference external" href="https://github.com/python/cpython/tree/3.10/Lib/zoneinfo">Lib/zoneinfo</a>
<hr class="docutils" />
The <a class="reference internal" href="#module-zoneinfo" title="zoneinfo: IANA time zone support"><code class="xref py py-mod docutils literal notranslate">zoneinfo</code></a> module provides a concrete time zone implementation to
support the IANA time zone database as originally specified in <a class="pep reference external" href="https://www.python.org/dev/peps/pep-0615">PEP 615</a>. By
default, <a class="reference internal" href="#module-zoneinfo" title="zoneinfo: IANA time zone support"><code class="xref py py-mod docutils literal notranslate">zoneinfo</code></a> uses the system’s time zone data if available; if no
system time zone data is available, the library will fall back to using the
first-party <a class="reference external" href="https://pypi.org/project/tzdata/">tzdata</a> package available on PyPI.
<div class="admonition seealso">
See also
<dl class="simple">
<dt>Module: <a class="reference internal" href="datetime.html#module-datetime" title="datetime: Basic date and time types."><code class="xref py py-mod docutils literal notranslate">datetime</code></a></dt><dd>Provides the <a class="reference internal" href="datetime.html#datetime.time" title="datetime.time"><code class="xref py py-class docutils literal notranslate">time</code></a> and <a class="reference internal" href="datetime.html#datetime.datetime" title="datetime.datetime"><code class="xref py py-class docutils literal notranslate">datetime</code></a>
types with which the <a class="reference internal" href="#zoneinfo.ZoneInfo" title="zoneinfo.ZoneInfo"><code class="xref py py-class docutils literal notranslate">ZoneInfo</code></a> class is designed to be used.
</dd>
<dt>Package <a class="reference external" href="https://pypi.org/project/tzdata/">tzdata</a></dt><dd>First-party package maintained by the CPython core developers to supply
time zone data via PyPI.
</dd>
</dl>
</div>
<section id="using-zoneinfo">
<h2>Using <code class="docutils literal notranslate">ZoneInfo</code><a class="headerlink" href="#using-zoneinfo" title="Permalink to this headline">¶</a></h2>
<a class="reference internal" href="#zoneinfo.ZoneInfo" title="zoneinfo.ZoneInfo"><code class="xref py py-class docutils literal notranslate">ZoneInfo</code></a> is a concrete implementation of the <a class="reference internal" href="datetime.html#datetime.tzinfo" title="datetime.tzinfo"><code class="xref py py-class docutils literal notranslate">datetime.tzinfo</code></a>
abstract base class, and is intended to be attached to <code class="docutils literal notranslate">tzinfo</code>, either via
the constructor, the <a class="reference internal" href="datetime.html#datetime.datetime.replace" title="datetime.datetime.replace"><code class="xref py py-meth docutils literal notranslate">datetime.replace</code></a>
method or <a class="reference internal" href="datetime.html#datetime.datetime.astimezone" title="datetime.datetime.astimezone"><code class="xref py py-meth docutils literal notranslate">datetime.astimezone</code></a>:
<div class="highlight-python3 notranslate"><div class="highlight"><pre>&gt;&gt;&gt; from zoneinfo import ZoneInfo
&gt;&gt;&gt; from datetime import datetime, timedelta

&gt;&gt;&gt; dt.tzname()
&#39;PDT&#39;
</pre></div>
</div>
Datetimes constructed in this way are compatible with datetime arithmetic and
handle daylight saving time transitions with no further intervention:
<div class="highlight-python3 notranslate"><div class="highlight"><pre>&gt;&gt;&gt; dt_add = dt + timedelta(days=1)

&gt;&gt;&gt; print(dt_add)
2020-11-01 12:00:00-08:00

&gt;&gt;&gt; dt_add.tzname()
&#39;PST&#39;
</pre></div>
</div>
These time zones also support the <a class="reference internal" href="datetime.html#datetime.datetime.fold" title="datetime.datetime.fold"><code class="xref py py-attr docutils literal notranslate">fold</code></a> attribute
introduced in <a class="pep reference external" href="https://www.python.org/dev/peps/pep-0495">PEP 495</a>. During offset transitions which induce ambiguous
times (such as a daylight saving time to standard time transition), the offset
from before the transition is used when <code class="docutils literal notranslate">fold=0</code>, and the offset after
the transition is used when <code class="docutils literal notranslate">fold=1</code>, for example:
<div class="highlight-python3 notranslate"><div class="highlight"><pre>&gt;&gt;&gt; dt = datetime(2020, 11, 1, 1, tzinfo=ZoneInfo(&quot;America/Los_Angeles&quot;))
&gt;&gt;&gt; print(dt)
2020-11-01 01:00:00-07:00

&gt;&gt;&gt; print(dt.replace(fold=1))
2020-11-01 01:00:00-08:00
</pre></div>
</div>
When converting from another time zone, the fold will be set to the correct
value:
<div class="highlight-python3 notranslate"><div class="highlight"><pre>&gt;&gt;&gt; from datetime import timezone
&gt;&gt;&gt; LOS_ANGELES = ZoneInfo(&quot;America/Los_Angeles&quot;)
&gt;&gt;&gt; dt_utc = datetime(2020, 11, 1, 8, tzinfo=timezone.utc)

&gt;&gt;&gt; # Before the PDT -&gt; PST transition
&gt;&gt;&gt; print(dt_utc.astimezone(LOS_ANGELES))
2020-11-01 01:00:00-07:00

&gt;&gt;&gt; # After the PDT -&gt; PST transition
&gt;&gt;&gt; print((dt_utc + timedelta(hours=1)).astimezone(LOS_ANGELES))
2020-11-01 01:00:00-08:00
</pre></div>
</div>
</section>
<section id="data-sources">
<h2>Data sources<a class="headerlink" href="#data-sources" title="Permalink to this headline">¶</a></h2>
The <code class="docutils literal notranslate">zoneinfo</code> module does not directly provide time zone data, and instead
pulls time zone information from the system time zone database or the
first-party PyPI package <a class="reference external" href="https://pypi.org/project/tzdata/">tzdata</a>, if available. Some systems, including
notably Windows systems, do not have an IANA database available, and so for
projects targeting cross-platform compatibility that require time zone data, it
is recommended to declare a dependency on tzdata. If neither system data nor
tzdata are available, all calls to <a class="reference internal" href="#zoneinfo.ZoneInfo" title="zoneinfo.ZoneInfo"><code class="xref py py-class docutils literal notranslate">ZoneInfo</code></a> will raise
<a class="reference internal" href="#zoneinfo.ZoneInfoNotFoundError" title="zoneinfo.ZoneInfoNotFoundError"><code class="xref py py-exc docutils literal notranslate">ZoneInfoNotFoundError</code></a>.
<section id="configuring-the-data-sources">
<h3>Configuring the data sources<a class="headerlink" href="#configuring-the-data-sources" title="Permalink to this headline">¶</a></h3>
When <code class="docutils literal notranslate">ZoneInfo(key)</code> is called, the constructor first searches the
directories specified in <a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a> for a file matching <code class="docutils literal notranslate">key</code>, and on
failure looks for a match in the tzdata package. This behavior can be
configured in three ways:
<ol class="arabic simple">
<li>The default <a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a> when not otherwise specified can be configured at
<a class="reference internal" href="#zoneinfo-data-compile-time-config">compile time</a>.</li>
<li><a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a> can be configured using <a class="reference internal" href="#zoneinfo-data-environment-var">an environment variable</a>.</li>
<li>At <a class="reference internal" href="#zoneinfo-data-runtime-config">runtime</a>, the search path can be
manipulated using the <a class="reference internal" href="#zoneinfo.reset_tzpath" title="zoneinfo.reset_tzpath"><code class="xref py py-func docutils literal notranslate">reset_tzpath()</code></a> function.</li>
</ol>
<section id="compile-time-configuration">
<h4>Compile-time configuration<a class="headerlink" href="#compile-time-configuration" title="Permalink to this headline">¶</a></h4>
The default <a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a> includes several common deployment locations for the
time zone database (except on Windows, where there are no “well-known”
locations for time zone data). On POSIX systems, downstream distributors and
those building Python from source who know where their system
time zone data is deployed may change the default time zone path by specifying
the compile-time option <code class="docutils literal notranslate">TZPATH</code> (or, more likely, the <a class="reference internal" href="../using/configure.html#cmdoption-with-tzpath"><code class="xref std std-option docutils literal notranslate">configure
flag --with-tzpath</code></a>), which should be a string delimited by
<a class="reference internal" href="os.html#os.pathsep" title="os.pathsep"><code class="xref py py-data docutils literal notranslate">os.pathsep</code></a>.
On all platforms, the configured value is available as the <code class="docutils literal notranslate">TZPATH</code> key in
<a class="reference internal" href="sysconfig.html#sysconfig.get_config_var" title="sysconfig.get_config_var"><code class="xref py py-func docutils literal notranslate">sysconfig.get_config_var()</code></a>.
</section>
<section id="environment-configuration">
<h4>Environment configuration<a class="headerlink" href="#environment-configuration" title="Permalink to this headline">¶</a></h4>
When initializing <a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a> (either at import time or whenever
<a class="reference internal" href="#zoneinfo.reset_tzpath" title="zoneinfo.reset_tzpath"><code class="xref py py-func docutils literal notranslate">reset_tzpath()</code></a> is called with no arguments), the <code class="docutils literal notranslate">zoneinfo</code> module will
use the environment variable <code class="docutils literal notranslate">PYTHONTZPATH</code>, if it exists, to set the search
path.
<dl class="std envvar">
<dt class="sig sig-object std" id="envvar-PYTHONTZPATH">
PYTHONTZPATH<a class="headerlink" href="#envvar-PYTHONTZPATH" title="Permalink to this definition">¶</a></dt>
<dd>This is an <a class="reference internal" href="os.html#os.pathsep" title="os.pathsep"><code class="xref py py-data docutils literal notranslate">os.pathsep</code></a>-separated string containing the time zone
search path to use. It must consist of only absolute rather than relative
paths. Relative components specified in <code class="docutils literal notranslate">PYTHONTZPATH</code> will not be used,
but otherwise the behavior when a relative path is specified is
implementation-defined; CPython will raise <a class="reference internal" href="#zoneinfo.InvalidTZPathWarning" title="zoneinfo.InvalidTZPathWarning"><code class="xref py py-exc docutils literal notranslate">InvalidTZPathWarning</code></a>, but
other implementations are free to silently ignore the erroneous component
or raise an exception.
</dd></dl>

To set the system to ignore the system data and use the tzdata package
instead, set <code class="docutils literal notranslate">PYTHONTZPATH=&quot;&quot;</code>.
</section>
<section id="runtime-configuration">
<h4>Runtime configuration<a class="headerlink" href="#runtime-configuration" title="Permalink to this headline">¶</a></h4>
The TZ search path can also be configured at runtime using the
<a class="reference internal" href="#zoneinfo.reset_tzpath" title="zoneinfo.reset_tzpath"><code class="xref py py-func docutils literal notranslate">reset_tzpath()</code></a> function. This is generally not an advisable operation,
though it is reasonable to use it in test functions that require the use of a
specific time zone path (or require disabling access to the system time zones).
</section>
</section>
</section>
<section id="the-zoneinfo-class">
<h2>The <code class="docutils literal notranslate">ZoneInfo</code> class<a class="headerlink" href="#the-zoneinfo-class" title="Permalink to this headline">¶</a></h2>
<dl class="py class">
<dt class="sig sig-object py" id="zoneinfo.ZoneInfo">
class zoneinfo.ZoneInfo(key)<a class="headerlink" href="#zoneinfo.ZoneInfo" title="Permalink to this definition">¶</a></dt>
<dd>A concrete <a class="reference internal" href="datetime.html#datetime.tzinfo" title="datetime.tzinfo"><code class="xref py py-class docutils literal notranslate">datetime.tzinfo</code></a> subclass that represents an IANA time
zone specified by the string <code class="docutils literal notranslate">key</code>. Calls to the primary constructor will
always return objects that compare identically; put another way, barring
cache invalidation via <a class="reference internal" href="#zoneinfo.ZoneInfo.clear_cache" title="zoneinfo.ZoneInfo.clear_cache"><code class="xref py py-meth docutils literal notranslate">ZoneInfo.clear_cache()</code></a>, for all values of
<code class="docutils literal notranslate">key</code>, the following assertion will always be true:
<div class="highlight-python notranslate"><div class="highlight"><pre>a = ZoneInfo(key)
b = ZoneInfo(key)
assert a is b
</pre></div>
</div>
<code class="docutils literal notranslate">key</code> must be in the form of a relative, normalized POSIX path, with no
up-level references. The constructor will raise <a class="reference internal" href="exceptions.html#ValueError" title="ValueError"><code class="xref py py-exc docutils literal notranslate">ValueError</code></a> if a
non-conforming key is passed.
If no file matching <code class="docutils literal notranslate">key</code> is found, the constructor will raise
<a class="reference internal" href="#zoneinfo.ZoneInfoNotFoundError" title="zoneinfo.ZoneInfoNotFoundError"><code class="xref py py-exc docutils literal notranslate">ZoneInfoNotFoundError</code></a>.
</dd></dl>

The <code class="docutils literal notranslate">ZoneInfo</code> class has two alternate constructors:
<dl class="py method">
<dt class="sig sig-object py" id="zoneinfo.ZoneInfo.from_file">
classmethod ZoneInfo.from_file(fobj, /, key=None)<a class="headerlink" href="#zoneinfo.ZoneInfo.from_file" title="Permalink to this definition">¶</a></dt>
<dd>Constructs a <code class="docutils literal notranslate">ZoneInfo</code> object from a file-like object returning bytes
(e.g. a file opened in binary mode or an <a class="reference internal" href="io.html#io.BytesIO" title="io.BytesIO"><code class="xref py py-class docutils literal notranslate">io.BytesIO</code></a> object).
Unlike the primary constructor, this always constructs a new object.
The <code class="docutils literal notranslate">key</code> parameter sets the name of the zone for the purposes of
<a class="reference internal" href="../reference/datamodel.html#object.__str__" title="object.__str__"><code class="xref py py-meth docutils literal notranslate">__str__()</code></a> and <a class="reference internal" href="../reference/datamodel.html#object.__repr__" title="object.__repr__"><code class="xref py py-meth docutils literal notranslate">__repr__()</code></a>.
Objects created via this constructor cannot be pickled (see <a class="reference internal" href="#pickling">pickling</a>).
</dd></dl>

<dl class="py method">
<dt class="sig sig-object py" id="zoneinfo.ZoneInfo.no_cache">
classmethod ZoneInfo.no_cache(key)<a class="headerlink" href="#zoneinfo.ZoneInfo.no_cache" title="Permalink to this definition">¶</a></dt>
<dd>An alternate constructor that bypasses the constructor’s cache. It is
identical to the primary constructor, but returns a new object on each
call. This is most likely to be useful for testing or demonstration
purposes, but it can also be used to create a system with a different cache
invalidation strategy.
Objects created via this constructor will also bypass the cache of a
deserializing process when unpickled.
<div class="admonition caution">
Caution
Using this constructor may change the semantics of your datetimes in
surprising ways, only use it if you know that you need to.
</div>
</dd></dl>

The following class methods are also available:
<dl class="py method">
<dt class="sig sig-object py" id="zoneinfo.ZoneInfo.clear_cache">
classmethod ZoneInfo.clear_cache(*, only_keys=None)<a class="headerlink" href="#zoneinfo.ZoneInfo.clear_cache" title="Permalink to this definition">¶</a></dt>
<dd>A method for invalidating the cache on the <code class="docutils literal notranslate">ZoneInfo</code> class. If no
arguments are passed, all caches are invalidated and the next call to
the primary constructor for each key will return a new instance.
If an iterable of key names is passed to the <code class="docutils literal notranslate">only_keys</code> parameter, only
the specified keys will be removed from the cache. Keys passed to
<code class="docutils literal notranslate">only_keys</code> but not found in the cache are ignored.
<div class="admonition warning">
Warning
Invoking this function may change the semantics of datetimes using
<code class="docutils literal notranslate">ZoneInfo</code> in surprising ways; this modifies process-wide global state
and thus may have wide-ranging effects. Only use it if you know that you
need to.
</div>
</dd></dl>

The class has one attribute:
<dl class="py attribute">
<dt class="sig sig-object py" id="zoneinfo.ZoneInfo.key">
ZoneInfo.key<a class="headerlink" href="#zoneinfo.ZoneInfo.key" title="Permalink to this definition">¶</a></dt>
<dd>This is a read-only <a class="reference internal" href="../glossary.html#term-attribute">attribute</a> that returns the value of <code class="docutils literal notranslate">key</code>
passed to the constructor, which should be a lookup key in the IANA time
zone database (e.g. <code class="docutils literal notranslate">America/New_York</code>, <code class="docutils literal notranslate">Europe/Paris</code> or
<code class="docutils literal notranslate">Asia/Tokyo</code>).
For zones constructed from file without specifying a <code class="docutils literal notranslate">key</code> parameter,
this will be set to <code class="docutils literal notranslate">None</code>.
<div class="admonition note">
Note
Although it is a somewhat common practice to expose these to end users,
these values are designed to be primary keys for representing the
relevant zones and not necessarily user-facing elements. Projects like
CLDR (the Unicode Common Locale Data Repository) can be used to get
more user-friendly strings from these keys.
</div>
</dd></dl>

<section id="string-representations">
<h3>String representations<a class="headerlink" href="#string-representations" title="Permalink to this headline">¶</a></h3>
The string representation returned when calling <a class="reference internal" href="stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate">str</code></a> on a
<a class="reference internal" href="#zoneinfo.ZoneInfo" title="zoneinfo.ZoneInfo"><code class="xref py py-class docutils literal notranslate">ZoneInfo</code></a> object defaults to using the <a class="reference internal" href="#zoneinfo.ZoneInfo.key" title="zoneinfo.ZoneInfo.key"><code class="xref py py-attr docutils literal notranslate">ZoneInfo.key</code></a> attribute (see
the note on usage in the attribute documentation):
<div class="highlight-python3 notranslate"><div class="highlight"><pre>&gt;&gt;&gt; zone = ZoneInfo(&quot;Pacific/Kwajalein&quot;)
&gt;&gt;&gt; str(zone)
&#39;Pacific/Kwajalein&#39;

&gt;&gt;&gt; dt = datetime(2020, 4, 1, 3, 15, tzinfo=zone)
&gt;&gt;&gt; f&quot;{dt.isoformat()} [{dt.tzinfo}]&quot;
&#39;2020-04-01T03:15:00+12:00 [Pacific/Kwajalein]&#39;
</pre></div>
</div>
For objects constructed from a file without specifying a <code class="docutils literal notranslate">key</code> parameter,
<code class="docutils literal notranslate">str</code> falls back to calling <a class="reference internal" href="functions.html#repr" title="repr"><code class="xref py py-func docutils literal notranslate">repr()</code></a>. <code class="docutils literal notranslate">ZoneInfo</code>’s <code class="docutils literal notranslate">repr</code> is
implementation-defined and not necessarily stable between versions, but it is
guaranteed not to be a valid <code class="docutils literal notranslate">ZoneInfo</code> key.
</section>
<section id="pickle-serialization">
<h3>Pickle serialization<a class="headerlink" href="#pickle-serialization" title="Permalink to this headline">¶</a></h3>
Rather than serializing all transition data, <code class="docutils literal notranslate">ZoneInfo</code> objects are
serialized by key, and <code class="docutils literal notranslate">ZoneInfo</code> objects constructed from files (even those
with a value for <code class="docutils literal notranslate">key</code> specified) cannot be pickled.
The behavior of a <code class="docutils literal notranslate">ZoneInfo</code> file depends on how it was constructed:
<ol class="arabic">
<li><code class="docutils literal notranslate">ZoneInfo(key)</code>: When constructed with the primary constructor, a
<code class="docutils literal notranslate">ZoneInfo</code> object is serialized by key, and when deserialized, the
deserializing process uses the primary and thus it is expected that these
are expected to be the same object as other references to the same time
zone. For example, if <code class="docutils literal notranslate">europe_berlin_pkl</code> is a string containing a pickle
constructed from <code class="docutils literal notranslate">ZoneInfo(&quot;Europe/Berlin&quot;)</code>, one would expect the
following behavior:
<div class="highlight-pycon notranslate"><div class="highlight"><pre>&gt;&gt;&gt; a = ZoneInfo(&quot;Europe/Berlin&quot;)
&gt;&gt;&gt; b = pickle.loads(europe_berlin_pkl)
&gt;&gt;&gt; a is b
True
</pre></div>
</div>
</li>
<li><code class="docutils literal notranslate">ZoneInfo.no_cache(key)</code>: When constructed from the cache-bypassing
constructor, the <code class="docutils literal notranslate">ZoneInfo</code> object is also serialized by key, but when
deserialized, the deserializing process uses the cache bypassing
constructor. If <code class="docutils literal notranslate">europe_berlin_pkl_nc</code> is a string containing a pickle
constructed from <code class="docutils literal notranslate">ZoneInfo.no_cache(&quot;Europe/Berlin&quot;)</code>, one would expect
the following behavior:
<div class="highlight-pycon notranslate"><div class="highlight"><pre>&gt;&gt;&gt; a = ZoneInfo(&quot;Europe/Berlin&quot;)
&gt;&gt;&gt; b = pickle.loads(europe_berlin_pkl_nc)
&gt;&gt;&gt; a is b
False
</pre></div>
</div>
</li>
<li><code class="docutils literal notranslate">ZoneInfo.from_file(fobj, /, key=None)</code>: When constructed from a file, the
<code class="docutils literal notranslate">ZoneInfo</code> object raises an exception on pickling. If an end user wants to
pickle a <code class="docutils literal notranslate">ZoneInfo</code> constructed from a file, it is recommended that they
use a wrapper type or a custom serialization function: either serializing by
key or storing the contents of the file object and serializing that.</li>
</ol>
This method of serialization requires that the time zone data for the required
key be available on both the serializing and deserializing side, similar to the
way that references to classes and functions are expected to exist in both the
serializing and deserializing environments. It also means that no guarantees
are made about the consistency of results when unpickling a <code class="docutils literal notranslate">ZoneInfo</code>
pickled in an environment with a different version of the time zone data.
</section>
</section>
<section id="functions">
<h2>Functions<a class="headerlink" href="#functions" title="Permalink to this headline">¶</a></h2>
<dl class="py function">
<dt class="sig sig-object py" id="zoneinfo.available_timezones">
zoneinfo.available_timezones()<a class="headerlink" href="#zoneinfo.available_timezones" title="Permalink to this definition">¶</a></dt>
<dd>Get a set containing all the valid keys for IANA time zones available
anywhere on the time zone path. This is recalculated on every call to the
function.
This function only includes canonical zone names and does not include
“special” zones such as those under the <code class="docutils literal notranslate">posix/</code> and <code class="docutils literal notranslate">right/</code>
directories, or the <code class="docutils literal notranslate">posixrules</code> zone.
<div class="admonition caution">
Caution
This function may open a large number of files, as the best way to
determine if a file on the time zone path is a valid time zone is to
read the “magic string” at the beginning.
</div>
<div class="admonition note">
Note
These values are not designed to be exposed to end-users; for user
facing elements, applications should use something like CLDR (the
Unicode Common Locale Data Repository) to get more user-friendly
strings. See also the cautionary note on <a class="reference internal" href="#zoneinfo.ZoneInfo.key" title="zoneinfo.ZoneInfo.key"><code class="xref py py-attr docutils literal notranslate">ZoneInfo.key</code></a>.
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="zoneinfo.reset_tzpath">
zoneinfo.reset_tzpath(to=None)<a class="headerlink" href="#zoneinfo.reset_tzpath" title="Permalink to this definition">¶</a></dt>
<dd>Sets or resets the time zone search path (<a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a>) for the module.
When called with no arguments, <a class="reference internal" href="#zoneinfo.TZPATH" title="zoneinfo.TZPATH"><code class="xref py py-data docutils literal notranslate">TZPATH</code></a> is set to the default value.
Calling <code class="docutils literal notranslate">reset_tzpath</code> will not invalidate the <a class="reference internal" href="#zoneinfo.ZoneInfo" title="zoneinfo.ZoneInfo"><code class="xref py py-class docutils literal notranslate">ZoneInfo</code></a> cache,
and so calls to the primary <code class="docutils literal notranslate">ZoneInfo</code> constructor will only use the new
<code class="docutils literal notranslate">TZPATH</code> in the case of a cache miss.
The <code class="docutils literal notranslate">to</code> parameter must be a <a class="reference internal" href="../glossary.html#term-sequence">sequence</a> of strings or
<a class="reference internal" href="os.html#os.PathLike" title="os.PathLike"><code class="xref py py-class docutils literal notranslate">os.PathLike</code></a> and not a string, all of which must be absolute paths.
<a class="reference internal" href="exceptions.html#ValueError" title="ValueError"><code class="xref py py-exc docutils literal notranslate">ValueError</code></a> will be raised if something other than an absolute path
is passed.
</dd></dl>

</section>
<section id="globals">
<h2>Globals<a class="headerlink" href="#globals" title="Permalink to this headline">¶</a></h2>
<dl class="py data">
<dt class="sig sig-object py" id="zoneinfo.TZPATH">
zoneinfo.TZPATH<a class="headerlink" href="#zoneinfo.TZPATH" title="Permalink to this definition">¶</a></dt>
<dd>A read-only sequence representing the time zone search path – when
constructing a <code class="docutils literal notranslate">ZoneInfo</code> from a key, the key is joined to each entry in
the <code class="docutils literal notranslate">TZPATH</code>, and the first file found is used.
<code class="docutils literal notranslate">TZPATH</code> may contain only absolute paths, never relative paths,
regardless of how it is configured.
The object that <code class="docutils literal notranslate">zoneinfo.TZPATH</code> points to may change in response to a
call to <a class="reference internal" href="#zoneinfo.reset_tzpath" title="zoneinfo.reset_tzpath"><code class="xref py py-func docutils literal notranslate">reset_tzpath()</code></a>, so it is recommended to use
<code class="docutils literal notranslate">zoneinfo.TZPATH</code> rather than importing <code class="docutils literal notranslate">TZPATH</code> from <code class="docutils literal notranslate">zoneinfo</code> or
assigning a long-lived variable to <code class="docutils literal notranslate">zoneinfo.TZPATH</code>.
For more information on configuring the time zone search path, see
<a class="reference internal" href="#zoneinfo-data-configuration">Configuring the data sources</a>.
</dd></dl>

</section>
<section id="exceptions-and-warnings">
<h2>Exceptions and warnings<a class="headerlink" href="#exceptions-and-warnings" title="Permalink to this headline">¶</a></h2>
<dl class="py exception">
<dt class="sig sig-object py" id="zoneinfo.ZoneInfoNotFoundError">
exception zoneinfo.ZoneInfoNotFoundError<a class="headerlink" href="#zoneinfo.ZoneInfoNotFoundError" title="Permalink to this definition">¶</a></dt>
<dd>Raised when construction of a <a class="reference internal" href="#zoneinfo.ZoneInfo" title="zoneinfo.ZoneInfo"><code class="xref py py-class docutils literal notranslate">ZoneInfo</code></a> object fails because the
specified key could not be found on the system. This is a subclass of
<a class="reference internal" href="exceptions.html#KeyError" title="KeyError"><code class="xref py py-exc docutils literal notranslate">KeyError</code></a>.
</dd></dl>

<dl class="py exception">
<dt class="sig sig-object py" id="zoneinfo.InvalidTZPathWarning">
exception zoneinfo.InvalidTZPathWarning<a class="headerlink" href="#zoneinfo.InvalidTZPathWarning" title="Permalink to this definition">¶</a></dt>
<dd>Raised when <a class="reference internal" href="#envvar-PYTHONTZPATH"><code class="xref std std-envvar docutils literal notranslate">PYTHONTZPATH</code></a> contains an invalid component that will
be filtered out, such as a relative path.
</dd></dl>

</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <h3><a href="../contents.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate">zoneinfo</code> — IANA time zone support</a><ul>
<li><a class="reference internal" href="#using-zoneinfo">Using <code class="docutils literal notranslate">ZoneInfo</code></a></li>
<li><a class="reference internal" href="#data-sources">Data sources</a><ul>
<li><a class="reference internal" href="#configuring-the-data-sources">Configuring the data sources</a><ul>
<li><a class="reference internal" href="#compile-time-configuration">Compile-time configuration</a></li>
<li><a class="reference internal" href="#environment-configuration">Environment configuration</a></li>
<li><a class="reference internal" href="#runtime-configuration">Runtime configuration</a></li>
</ul>
</li>
</ul>
</li>
<li><a class="reference internal" href="#the-zoneinfo-class">The <code class="docutils literal notranslate">ZoneInfo</code> class</a><ul>
<li><a class="reference internal" href="#string-representations">String representations</a></li>
<li><a class="reference internal" href="#pickle-serialization">Pickle serialization</a></li>
</ul>
</li>
<li><a class="reference internal" href="#functions">Functions</a></li>
<li><a class="reference internal" href="#globals">Globals</a></li>
<li><a class="reference internal" href="#exceptions-and-warnings">Exceptions and warnings</a></li>
</ul>
</li>
</ul>

<h4>Previous topic</h4>
 <a href="datetime.html"
 title="previous chapter"><code class="xref py py-mod docutils literal notranslate">datetime</code> — Basic date and time types</a>
 <h4>Next topic</h4>
 <a href="calendar.html"
 title="next chapter"><code class="xref py py-mod docutils literal notranslate">calendar</code> — General calendar-related functions</a>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../bugs.html">Report a Bug</a></li>
 <li>
 <a href="https://github.com/python/cpython/blob/3.10/Doc/library/zoneinfo.rst"
 rel="nofollow">Show Source
 </a>
 </li>
 </ul>
 </div>
 </div>
 </div>
 <div class="clearer"></div>
 </div> 
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="../py-modindex.html" title="Python Module Index"
 >modules</a> |</li>
 <li class="right" >
 <a href="calendar.html" title="calendar — General calendar-related functions"
 >next</a> |</li>
 <li class="right" >
 <a href="datetime.html" title="datetime — Basic date and time types"
 >previous</a> |</li>

<li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="datatypes.html" >Data Types</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate">zoneinfo</code> — IANA time zone support</a></li>
 <li class="right">

<div class="inline-search" role="search">
 <form class="inline-search" action="../search.html" method="get">
 <input placeholder="Quick search" aria-label="Quick search" type="text" name="q" />
 <input type="submit" value="Go" />
 <input type="hidden" name="check_keywords" value="yes" />
 <input type="hidden" name="area" value="default" />
 </form>
 </div>
 |
 </li>
 
 </ul>
 </div> 
 <div class="footer">
 &copy; <a href="../copyright.html">Copyright</a> 2001-2026, Python Software Foundation.
 
 This page is licensed under the Python Software Foundation License Version 2.
 
 Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
 
 See <a href="/license.html">History and License</a> for more information.

The Python Software Foundation is a non-profit corporation.
<a href="https://www.python.org/psf/donations/">Please donate.</a>

Last updated on January 26, 2026.
 <a href="/bugs.html">Found a bug</a>?

Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.3.2.
 </div>

</body>
</html>

${this.title}

Code Editor : zoneinfo.html