Объекты DateTime¶
Различные объекты даты и времени предоставляются модулем datetime
. Перед
использованием любой из этих функций должен быть подключен datetime.h
заголовочный
файл в исходник (обратите внимание, что он не подключен к Python.h
), и
макрос PyDateTime_IMPORT
должен быть вызван, как правило, как часть функции
инициализации модуля. Макрос помещает указатель на структуру C в статическую
переменную PyDateTimeAPI
, используемый следующими макросами.
Макрос для доступа к UTC синглетону:
-
PyObject*
PyDateTime_TimeZone_UTC
¶ Возвращает синглтон часового пояса, представляющий UTC, тот же объект, что и
datetime.timezone.utc
.Добавлено в версии 3.7.
Макросы проверки типа:
-
int
PyDate_Check
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_DateType
или подтипPyDateTime_DateType
. ob не должен бытьNULL
.
-
int
PyDate_CheckExact
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_DateType
. ob не должен бытьNULL
.
-
int
PyDateTime_Check
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_DateTimeType
или подтипPyDateTime_DateTimeType
. ob не должен бытьNULL
.
-
int
PyDateTime_CheckExact
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_DateTimeType
. ob не должен бытьNULL
.
-
int
PyTime_Check
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_TimeType
или подтипPyDateTime_TimeType
. ob не должен бытьNULL
.
-
int
PyTime_CheckExact
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_TimeType
. ob не должны бытьNULL
.
-
int
PyDelta_Check
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_DeltaType
или подтипPyDateTime_DeltaType
. ob не должен бытьNULL
.
-
int
PyDelta_CheckExact
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_DeltaType
. ob не должны бытьNULL
.
-
int
PyTZInfo_Check
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_TZInfoType
или подтипPyDateTime_TZInfoType
. ob не должен бытьNULL
.
-
int
PyTZInfo_CheckExact
(PyObject *ob)¶ Возвращает true, если ob имеет тип
PyDateTime_TZInfoType
. ob не должны бытьNULL
.
Макросы для создания объектов:
-
PyObject*
PyDate_FromDate
(int year, int month, int day)¶ - Return value: New reference.
Возвращает объект
datetime.date
с указанными годом, месяцем и днем.
-
PyObject*
PyDateTime_FromDateAndTime
(int year, int month, int day, int hour, int minute, int second, int usecond)¶ - Return value: New reference.
Возвращает объект
datetime.datetime
с указанным годом, месяцем, днем, часом, минутой, секундой и микросекундой.
-
PyObject*
PyDateTime_FromDateAndTimeAndFold
(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)¶ - Return value: New reference.
Возвращает объект
datetime.datetime
с указанным годом, месяцем, днем, часом, минутой, секундой, микросекундой и сложением.Добавлено в версии 3.6.
-
PyObject*
PyTime_FromTime
(int hour, int minute, int second, int usecond)¶ - Return value: New reference.
Возвращает объект
datetime.time
с указанными часами, минутами, секундами и микросекундами.
-
PyObject*
PyTime_FromTimeAndFold
(int hour, int minute, int second, int usecond, int fold)¶ - Return value: New reference.
Возвращает объект
datetime.time
с указанными часом, минутой, секундой, микросекундой и сложением.Добавлено в версии 3.6.
-
PyObject*
PyDelta_FromDSU
(int days, int seconds, int useconds)¶ - Return value: New reference.
Возвращает объект
datetime.timedelta
, представляющий заданное количество дней, секунд и микросекунд. Нормализация выполняется таким образом, чтобы результирующее количество микросекунд и секунд находящихся в диапазонах, задокументированных дляdatetime.timedelta
объектов.
-
PyObject*
PyTimeZone_FromOffset
(PyDateTime_DeltaType* offset)¶ - Return value: New reference.
Возвращает объект
datetime.timezone
с неименованным фиксированным смещением, представленным аргументом offset.Добавлено в версии 3.7.
-
PyObject*
PyTimeZone_FromOffsetAndName
(PyDateTime_DeltaType* offset, PyUnicode* name)¶ - Return value: New reference.
Возвращает объект
datetime.timezone
с фиксированным смещением, представленным аргументом offset и tzname name.Добавлено в версии 3.7.
Макросы для извлечения полей из объектов даты. Аргумент должен быть сущностью
PyDateTime_Date
, включая подклассы (например, PyDateTime_DateTime
). Аргумент не должен быть
NULL
, и тип не проверяется:
-
int
PyDateTime_GET_YEAR
(PyDateTime_Date *o)¶ Возвращает год, как положительный int.
-
int
PyDateTime_GET_MONTH
(PyDateTime_Date *o)¶ Возвращает месяц, как int от 1 до 12.
-
int
PyDateTime_GET_DAY
(PyDateTime_Date *o)¶ Возвращает день, как int от 1 до 31.
Макросы для извлечения полей из datetime объектов. Аргумент должен быть
сущностью PyDateTime_DateTime
, включая подклассы. Аргумент не должен быть
NULL
, и тип не проверяется:
-
int
PyDateTime_DATE_GET_HOUR
(PyDateTime_DateTime *o)¶ Возвращает час, как int от 0 до 23.
-
int
PyDateTime_DATE_GET_MINUTE
(PyDateTime_DateTime *o)¶ Возвращает минуту, как int от 0 до 59.
-
int
PyDateTime_DATE_GET_SECOND
(PyDateTime_DateTime *o)¶ Возвращает второй, как int от 0 до 59.
-
int
PyDateTime_DATE_GET_MICROSECOND
(PyDateTime_DateTime *o)¶ Возвращает микросекунду, как int от 0 до 999999.
Макросы для извлечения полей из объектов времени. Аргумент должен быть
сущностью PyDateTime_Time
, включая подклассы. Аргумент не должен быть
NULL
, и тип не проверяется:
-
int
PyDateTime_TIME_GET_HOUR
(PyDateTime_Time *o)¶ Возвращает час, как int от 0 до 23.
-
int
PyDateTime_TIME_GET_MINUTE
(PyDateTime_Time *o)¶ Возвращает минуту, как int от 0 до 59.
-
int
PyDateTime_TIME_GET_SECOND
(PyDateTime_Time *o)¶ Возвращает второй, как int от 0 до 59.
-
int
PyDateTime_TIME_GET_MICROSECOND
(PyDateTime_Time *o)¶ Возвращает микросекунду, как int от 0 до 999999.
Макросы для извлечения полей из дельта-объектов времени. Аргумент должен быть
сущность PyDateTime_Delta
, включая подклассы. Аргумент не должен быть
NULL
, и тип не проверяется:
-
int
PyDateTime_DELTA_GET_DAYS
(PyDateTime_Delta *o)¶ Возвращает количество дней, от -999999999 до 999999999.
Добавлено в версии 3.3.
-
int
PyDateTime_DELTA_GET_SECONDS
(PyDateTime_Delta *o)¶ Возвращает количество секунд от 0 до 86399.
Добавлено в версии 3.3.
-
int
PyDateTime_DELTA_GET_MICROSECONDS
(PyDateTime_Delta *o)¶ Возвращает число микросекунд, как int от 0 до 999999.
Добавлено в версии 3.3.
Макросы для удобства модулей, реализующих DB API:
-
PyObject*
PyDateTime_FromTimestamp
(PyObject *args)¶ - Return value: New reference.
Создаёт и возвращает новый объект
datetime.datetime
с помощью кортежа аргументов, подходящего для передачиdatetime.datetime.fromtimestamp()
.
-
PyObject*
PyDate_FromTimestamp
(PyObject *args)¶ - Return value: New reference.
Создаёт и возвращает новый объект
datetime.date
с помощью кортежа аргументов, подходящего для передачиdatetime.date.fromtimestamp()
.