ef8446f35513a8d6aa2308357a268a7e

Edit file

File name : datetime.html

Content :

<!DOCTYPE html>

<title>DateTime Objects &#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="Objects for Type Hinting" href="typehints.html" />
 <link rel="prev" title="Context Variables Objects" href="contextvars.html" />
 <link rel="canonical" href="file:///usr/share/doc/python3.10/html/c-api/datetime.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>
 <h4>Previous topic</h4>
 <a href="contextvars.html"
 title="previous chapter">Context Variables Objects</a>
 <h4>Next topic</h4>
 <a href="typehints.html"
 title="next chapter">Objects for Type Hinting</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/c-api/datetime.rst"
 rel="nofollow">Show Source
 </a>
 </li>
 </ul>
 </div>
 </nav>
 </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"
 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="typehints.html" title="Objects for Type Hinting"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="contextvars.html" title="Context Variables Objects"
 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" >Python/C API Reference Manual</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="concrete.html" accesskey="U">Concrete Objects Layer</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">DateTime Objects</a></li>
 <li class="right">

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="datetime-objects">
<h1>DateTime Objects<a class="headerlink" href="#datetime-objects" title="Permalink to this headline">¶</a></h1>
Various date and time objects are supplied by the <a class="reference internal" href="../library/datetime.html#module-datetime" title="datetime: Basic date and time types."><code class="xref py py-mod docutils literal notranslate">datetime</code></a> module.
Before using any of these functions, the header file <code class="file docutils literal notranslate">datetime.h</code> must be
included in your source (note that this is not included by <code class="file docutils literal notranslate">Python.h</code>),
and the macro <code class="xref c c-macro docutils literal notranslate">PyDateTime_IMPORT</code> must be invoked, usually as part of
the module initialisation function. The macro puts a pointer to a C structure
into a static variable, <code class="xref c c-data docutils literal notranslate">PyDateTimeAPI</code>, that is used by the following
macros.
Macro for access to the UTC singleton:
<dl class="c var">
<dt class="sig sig-object c" id="c.PyDateTime_TimeZone_UTC">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDateTime_TimeZone_UTC<a class="headerlink" href="#c.PyDateTime_TimeZone_UTC" title="Permalink to this definition">¶</a> </dt>
<dd>Returns the time zone singleton representing UTC, the same object as
<a class="reference internal" href="../library/datetime.html#datetime.timezone.utc" title="datetime.timezone.utc"><code class="xref py py-attr docutils literal notranslate">datetime.timezone.utc</code></a>.
<div class="versionadded">
New in version 3.7.
</div>
</dd></dl>

Type-check macros:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDate_Check">
int PyDate_Check(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyDate_Check" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_DateType</code> or a subtype of
<code class="xref c c-data docutils literal notranslate">PyDateTime_DateType</code>. ob must not be <code class="docutils literal notranslate">NULL</code>. This function always
succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDate_CheckExact">
int PyDate_CheckExact(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyDate_CheckExact" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_DateType</code>. ob must not be
<code class="docutils literal notranslate">NULL</code>. This function always succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_Check">
int PyDateTime_Check(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyDateTime_Check" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_DateTimeType</code> or a subtype of
<code class="xref c c-data docutils literal notranslate">PyDateTime_DateTimeType</code>. ob must not be <code class="docutils literal notranslate">NULL</code>. This function always
succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_CheckExact">
int PyDateTime_CheckExact(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyDateTime_CheckExact" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_DateTimeType</code>. ob must not
be <code class="docutils literal notranslate">NULL</code>. This function always succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTime_Check">
int PyTime_Check(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyTime_Check" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_TimeType</code> or a subtype of
<code class="xref c c-data docutils literal notranslate">PyDateTime_TimeType</code>. ob must not be <code class="docutils literal notranslate">NULL</code>. This function always
succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTime_CheckExact">
int PyTime_CheckExact(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyTime_CheckExact" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_TimeType</code>. ob must not be
<code class="docutils literal notranslate">NULL</code>. This function always succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDelta_Check">
int PyDelta_Check(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyDelta_Check" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_DeltaType</code> or a subtype of
<code class="xref c c-data docutils literal notranslate">PyDateTime_DeltaType</code>. ob must not be <code class="docutils literal notranslate">NULL</code>. This function always
succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDelta_CheckExact">
int PyDelta_CheckExact(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyDelta_CheckExact" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_DeltaType</code>. ob must not be
<code class="docutils literal notranslate">NULL</code>. This function always succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTZInfo_Check">
int PyTZInfo_Check(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyTZInfo_Check" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_TZInfoType</code> or a subtype of
<code class="xref c c-data docutils literal notranslate">PyDateTime_TZInfoType</code>. ob must not be <code class="docutils literal notranslate">NULL</code>. This function always
succeeds.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTZInfo_CheckExact">
int PyTZInfo_CheckExact(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *ob)<a class="headerlink" href="#c.PyTZInfo_CheckExact" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if ob is of type <code class="xref c c-data docutils literal notranslate">PyDateTime_TZInfoType</code>. ob must not be
<code class="docutils literal notranslate">NULL</code>. This function always succeeds.
</dd></dl>

Macros to create objects:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDate_FromDate">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDate_FromDate(int year, int month, int day)<a class="headerlink" href="#c.PyDate_FromDate" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.date" title="datetime.date"><code class="xref py py-class docutils literal notranslate">datetime.date</code></a> object with the specified year, month and day.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_FromDateAndTime">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDateTime_FromDateAndTime(int year, int month, int day, int hour, int minute, int second, int usecond)<a class="headerlink" href="#c.PyDateTime_FromDateAndTime" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.datetime" title="datetime.datetime"><code class="xref py py-class docutils literal notranslate">datetime.datetime</code></a> object with the specified year, month, day, hour,
minute, second and microsecond.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_FromDateAndTimeAndFold">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDateTime_FromDateAndTimeAndFold(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)<a class="headerlink" href="#c.PyDateTime_FromDateAndTimeAndFold" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.datetime" title="datetime.datetime"><code class="xref py py-class docutils literal notranslate">datetime.datetime</code></a> object with the specified year, month, day, hour,
minute, second, microsecond and fold.
<div class="versionadded">
New in version 3.6.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTime_FromTime">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyTime_FromTime(int hour, int minute, int second, int usecond)<a class="headerlink" href="#c.PyTime_FromTime" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.time" title="datetime.time"><code class="xref py py-class docutils literal notranslate">datetime.time</code></a> object with the specified hour, minute, second and
microsecond.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTime_FromTimeAndFold">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyTime_FromTimeAndFold(int hour, int minute, int second, int usecond, int fold)<a class="headerlink" href="#c.PyTime_FromTimeAndFold" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.time" title="datetime.time"><code class="xref py py-class docutils literal notranslate">datetime.time</code></a> object with the specified hour, minute, second,
microsecond and fold.
<div class="versionadded">
New in version 3.6.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDelta_FromDSU">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDelta_FromDSU(int days, int seconds, int useconds)<a class="headerlink" href="#c.PyDelta_FromDSU" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.timedelta" title="datetime.timedelta"><code class="xref py py-class docutils literal notranslate">datetime.timedelta</code></a> object representing the given number
of days, seconds and microseconds. Normalization is performed so that the
resulting number of microseconds and seconds lie in the ranges documented for
<a class="reference internal" href="../library/datetime.html#datetime.timedelta" title="datetime.timedelta"><code class="xref py py-class docutils literal notranslate">datetime.timedelta</code></a> objects.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTimeZone_FromOffset">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyTimeZone_FromOffset(PyDateTime_DeltaType *offset)<a class="headerlink" href="#c.PyTimeZone_FromOffset" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.timezone" title="datetime.timezone"><code class="xref py py-class docutils literal notranslate">datetime.timezone</code></a> object with an unnamed fixed offset
represented by the offset argument.
<div class="versionadded">
New in version 3.7.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyTimeZone_FromOffsetAndName">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyTimeZone_FromOffsetAndName(PyDateTime_DeltaType *offset, PyUnicode *name)<a class="headerlink" href="#c.PyTimeZone_FromOffsetAndName" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Return a <a class="reference internal" href="../library/datetime.html#datetime.timezone" title="datetime.timezone"><code class="xref py py-class docutils literal notranslate">datetime.timezone</code></a> object with a fixed offset represented
by the offset argument and with tzname name.
<div class="versionadded">
New in version 3.7.
</div>
</dd></dl>

Macros to extract fields from date objects. The argument must be an instance of
<code class="xref c c-data docutils literal notranslate">PyDateTime_Date</code>, including subclasses (such as
<code class="xref c c-data docutils literal notranslate">PyDateTime_DateTime</code>). The argument must not be <code class="docutils literal notranslate">NULL</code>, and the type is
not checked:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_GET_YEAR">
int PyDateTime_GET_YEAR(PyDateTime_Date *o)<a class="headerlink" href="#c.PyDateTime_GET_YEAR" title="Permalink to this definition">¶</a> </dt>
<dd>Return the year, as a positive int.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_GET_MONTH">
int PyDateTime_GET_MONTH(PyDateTime_Date *o)<a class="headerlink" href="#c.PyDateTime_GET_MONTH" title="Permalink to this definition">¶</a> </dt>
<dd>Return the month, as an int from 1 through 12.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_GET_DAY">
int PyDateTime_GET_DAY(PyDateTime_Date *o)<a class="headerlink" href="#c.PyDateTime_GET_DAY" title="Permalink to this definition">¶</a> </dt>
<dd>Return the day, as an int from 1 through 31.
</dd></dl>

Macros to extract fields from datetime objects. The argument must be an
instance of <code class="xref c c-data docutils literal notranslate">PyDateTime_DateTime</code>, including subclasses. The argument
must not be <code class="docutils literal notranslate">NULL</code>, and the type is not checked:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DATE_GET_HOUR">
int PyDateTime_DATE_GET_HOUR(PyDateTime_DateTime *o)<a class="headerlink" href="#c.PyDateTime_DATE_GET_HOUR" title="Permalink to this definition">¶</a> </dt>
<dd>Return the hour, as an int from 0 through 23.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DATE_GET_MINUTE">
int PyDateTime_DATE_GET_MINUTE(PyDateTime_DateTime *o)<a class="headerlink" href="#c.PyDateTime_DATE_GET_MINUTE" title="Permalink to this definition">¶</a> </dt>
<dd>Return the minute, as an int from 0 through 59.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DATE_GET_SECOND">
int PyDateTime_DATE_GET_SECOND(PyDateTime_DateTime *o)<a class="headerlink" href="#c.PyDateTime_DATE_GET_SECOND" title="Permalink to this definition">¶</a> </dt>
<dd>Return the second, as an int from 0 through 59.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DATE_GET_MICROSECOND">
int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime *o)<a class="headerlink" href="#c.PyDateTime_DATE_GET_MICROSECOND" title="Permalink to this definition">¶</a> </dt>
<dd>Return the microsecond, as an int from 0 through 999999.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DATE_GET_FOLD">
int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)<a class="headerlink" href="#c.PyDateTime_DATE_GET_FOLD" title="Permalink to this definition">¶</a> </dt>
<dd>Return the fold, as an int from 0 through 1.
<div class="versionadded">
New in version 3.6.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DATE_GET_TZINFO">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)<a class="headerlink" href="#c.PyDateTime_DATE_GET_TZINFO" title="Permalink to this definition">¶</a> </dt>
<dd>Return the tzinfo (which may be <code class="docutils literal notranslate">None</code>).
<div class="versionadded">
New in version 3.10.
</div>
</dd></dl>

Macros to extract fields from time objects. The argument must be an instance of
<code class="xref c c-data docutils literal notranslate">PyDateTime_Time</code>, including subclasses. The argument must not be <code class="docutils literal notranslate">NULL</code>,
and the type is not checked:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_TIME_GET_HOUR">
int PyDateTime_TIME_GET_HOUR(PyDateTime_Time *o)<a class="headerlink" href="#c.PyDateTime_TIME_GET_HOUR" title="Permalink to this definition">¶</a> </dt>
<dd>Return the hour, as an int from 0 through 23.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_TIME_GET_MINUTE">
int PyDateTime_TIME_GET_MINUTE(PyDateTime_Time *o)<a class="headerlink" href="#c.PyDateTime_TIME_GET_MINUTE" title="Permalink to this definition">¶</a> </dt>
<dd>Return the minute, as an int from 0 through 59.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_TIME_GET_SECOND">
int PyDateTime_TIME_GET_SECOND(PyDateTime_Time *o)<a class="headerlink" href="#c.PyDateTime_TIME_GET_SECOND" title="Permalink to this definition">¶</a> </dt>
<dd>Return the second, as an int from 0 through 59.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_TIME_GET_MICROSECOND">
int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time *o)<a class="headerlink" href="#c.PyDateTime_TIME_GET_MICROSECOND" title="Permalink to this definition">¶</a> </dt>
<dd>Return the microsecond, as an int from 0 through 999999.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_TIME_GET_FOLD">
int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)<a class="headerlink" href="#c.PyDateTime_TIME_GET_FOLD" title="Permalink to this definition">¶</a> </dt>
<dd>Return the fold, as an int from 0 through 1.
<div class="versionadded">
New in version 3.6.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_TIME_GET_TZINFO">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)<a class="headerlink" href="#c.PyDateTime_TIME_GET_TZINFO" title="Permalink to this definition">¶</a> </dt>
<dd>Return the tzinfo (which may be <code class="docutils literal notranslate">None</code>).
<div class="versionadded">
New in version 3.10.
</div>
</dd></dl>

Macros to extract fields from time delta objects. The argument must be an
instance of <code class="xref c c-data docutils literal notranslate">PyDateTime_Delta</code>, including subclasses. The argument must
not be <code class="docutils literal notranslate">NULL</code>, and the type is not checked:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DELTA_GET_DAYS">
int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)<a class="headerlink" href="#c.PyDateTime_DELTA_GET_DAYS" title="Permalink to this definition">¶</a> </dt>
<dd>Return the number of days, as an int from -999999999 to 999999999.
<div class="versionadded">
New in version 3.3.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DELTA_GET_SECONDS">
int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)<a class="headerlink" href="#c.PyDateTime_DELTA_GET_SECONDS" title="Permalink to this definition">¶</a> </dt>
<dd>Return the number of seconds, as an int from 0 through 86399.
<div class="versionadded">
New in version 3.3.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_DELTA_GET_MICROSECONDS">
int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)<a class="headerlink" href="#c.PyDateTime_DELTA_GET_MICROSECONDS" title="Permalink to this definition">¶</a> </dt>
<dd>Return the number of microseconds, as an int from 0 through 999999.
<div class="versionadded">
New in version 3.3.
</div>
</dd></dl>

Macros for the convenience of modules implementing the DB API:
<dl class="c function">
<dt class="sig sig-object c" id="c.PyDateTime_FromTimestamp">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDateTime_FromTimestamp(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *args)<a class="headerlink" href="#c.PyDateTime_FromTimestamp" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Create and return a new <a class="reference internal" href="../library/datetime.html#datetime.datetime" title="datetime.datetime"><code class="xref py py-class docutils literal notranslate">datetime.datetime</code></a> object given an argument
tuple suitable for passing to <a class="reference internal" href="../library/datetime.html#datetime.datetime.fromtimestamp" title="datetime.datetime.fromtimestamp"><code class="xref py py-meth docutils literal notranslate">datetime.datetime.fromtimestamp()</code></a>.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyDate_FromTimestamp">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyDate_FromTimestamp(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *args)<a class="headerlink" href="#c.PyDate_FromTimestamp" title="Permalink to this definition">¶</a> </dt>
<dd>Return value: New reference.Create and return a new <a class="reference internal" href="../library/datetime.html#datetime.date" title="datetime.date"><code class="xref py py-class docutils literal notranslate">datetime.date</code></a> object given an argument
tuple suitable for passing to <a class="reference internal" href="../library/datetime.html#datetime.date.fromtimestamp" title="datetime.date.fromtimestamp"><code class="xref py py-meth docutils literal notranslate">datetime.date.fromtimestamp()</code></a>.
</dd></dl>

</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <h4>Previous topic</h4>
 <a href="contextvars.html"
 title="previous chapter">Context Variables Objects</a>
 <h4>Next topic</h4>
 <a href="typehints.html"
 title="next chapter">Objects for Type Hinting</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/c-api/datetime.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="typehints.html" title="Objects for Type Hinting"
 >next</a> |</li>
 <li class="right" >
 <a href="contextvars.html" title="Context Variables Objects"
 >previous</a> |</li>

<li class="nav-item nav-item-1"><a href="index.html" >Python/C API Reference Manual</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="concrete.html" >Concrete Objects Layer</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">DateTime Objects</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-2025, 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 February 04, 2025.
 <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>