[Python-checkins] [3.11] gh-90359: Unify documentation style for datetime.rst (gh-94836) (gh-94838)
corona10
webhook-mailer at python.org
Wed Jul 13 20:52:57 EDT 2022
https://github.com/python/cpython/commit/0a51204cd02b9fbee0616fdbdd9139526b32aeab
commit: 0a51204cd02b9fbee0616fdbdd9139526b32aeab
branch: 3.11
author: Dong-hee Na <donghee.na at python.org>
committer: corona10 <donghee.na92 at gmail.com>
date: 2022-07-14T09:52:53+09:00
summary:
[3.11] gh-90359: Unify documentation style for datetime.rst (gh-94836) (gh-94838)
(cherry picked from commit 967da5febbc77b36a5b14863e61db3a2d441a940)
Co-authored-by: Dong-hee Na <donghee.na at python.org>
files:
M Doc/c-api/datetime.rst
diff --git a/Doc/c-api/datetime.rst b/Doc/c-api/datetime.rst
index d650f5569d238..72fc07afbf1f4 100644
--- a/Doc/c-api/datetime.rst
+++ b/Doc/c-api/datetime.rst
@@ -132,6 +132,7 @@ Macros to create objects:
resulting number of microseconds and seconds lie in the ranges documented for
:class:`datetime.timedelta` objects.
+
.. c:function:: PyObject* PyTimeZone_FromOffset(PyDateTime_DeltaType* offset)
Return a :class:`datetime.timezone` object with an unnamed fixed offset
@@ -139,6 +140,7 @@ Macros to create objects:
.. versionadded:: 3.7
+
.. c:function:: PyObject* PyTimeZone_FromOffsetAndName(PyDateTime_DeltaType* offset, PyUnicode* name)
Return a :class:`datetime.timezone` object with a fixed offset represented
@@ -190,18 +192,21 @@ must not be ``NULL``, and the type is not checked:
Return the microsecond, as an int from 0 through 999999.
+
.. c:function:: int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)
Return the fold, as an int from 0 through 1.
.. versionadded:: 3.6
+
.. c:function:: PyObject* PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)
Return the tzinfo (which may be ``None``).
.. versionadded:: 3.10
+
Macros to extract fields from time objects. The argument must be an instance of
:c:data:`PyDateTime_Time`, including subclasses. The argument must not be ``NULL``,
and the type is not checked:
@@ -225,12 +230,14 @@ and the type is not checked:
Return the microsecond, as an int from 0 through 999999.
+
.. c:function:: int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)
Return the fold, as an int from 0 through 1.
.. versionadded:: 3.6
+
.. c:function:: PyObject* PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)
Return the tzinfo (which may be ``None``).
More information about the Python-checkins
mailing list