Объекты DateTime¶
Различные объекты даты и времени предоставляются модулем datetime
. Перед использованием любой из этих функций в исходный текст должен быть включен заголовочный файл datetime.h
(обратите внимание, что он не включается в Python.h
) и вызван макрос PyDateTime_IMPORT
, обычно как часть функции инициализации модуля. Макрос помещает указатель на структуру C в статическую переменную PyDateTimeAPI
, которая используется следующими макросами.
-
PyTypeObject PyDateTime_DateType¶
Этот экземпляр
PyTypeObject
представляет тип даты Python; это тот же объект, что иdatetime.date
в слое Python.
-
PyTypeObject PyDateTime_DateTimeType¶
Этот экземпляр
PyTypeObject
представляет тип Python datetime; это тот же объект, что иdatetime.datetime
в слое Python.
-
PyTypeObject PyDateTime_TimeType¶
Этот экземпляр
PyTypeObject
представляет тип времени Python; это тот же объект, что иdatetime.time
в слое Python.
-
PyTypeObject PyDateTime_DeltaType¶
Этот экземпляр
PyTypeObject
представляет тип Python для разницы между двумя значениями времени даты; это тот же объект, что иdatetime.timedelta
в слое Python.
-
PyTypeObject PyDateTime_TZInfoType¶
Этот экземпляр
PyTypeObject
представляет тип информации о часовом поясе Python; это тот же объект, что иdatetime.tzinfo
в слое Python.
Макрос для доступа к синглтону UTC:
-
PyObject *PyDateTime_TimeZone_UTC¶
Возвращает синглтон часового пояса, представляющий UTC, тот же объект, что и
datetime.timezone.utc
.Added in version 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)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.date
с указанными годом, месяцем и днем.
-
PyObject *PyDateTime_FromDateAndTime(int year, int month, int day, int hour, int minute, int second, int usecond)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.datetime
с указанными годом, месяцем, днем, часом, минутой, секундой и микросекундой.
-
PyObject *PyDateTime_FromDateAndTimeAndFold(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.datetime
с указанными годом, месяцем, днем, часом, минутой, секундой, микросекундой и сгибом.Added in version 3.6.
-
PyObject *PyTime_FromTime(int hour, int minute, int second, int usecond)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.time
с указанными часами, минутами, секундами и микросекундами.
-
PyObject *PyTime_FromTimeAndFold(int hour, int minute, int second, int usecond, int fold)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.time
с указанными часами, минутами, секундами, микросекундами и складками.Added in version 3.6.
-
PyObject *PyDelta_FromDSU(int days, int seconds, int useconds)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.timedelta
, представляющий заданное количество дней, секунд и микросекунд. Нормализация выполняется таким образом, чтобы полученное количество микросекунд и секунд находилось в диапазонах, задокументированных для объектовdatetime.timedelta
.
-
PyObject *PyTimeZone_FromOffset(PyObject *offset)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.timezone
с неименованным фиксированным смещением, представленным аргументом offset.Added in version 3.7.
-
PyObject *PyTimeZone_FromOffsetAndName(PyObject *offset, PyObject *name)¶
- Возвращаемое значение: Новая ссылка.
Возвращает объект
datetime.timezone
с фиксированным смещением, представленным аргументом offset, и с tzname name.Added in version 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)¶
Возвращает значение секунды в виде числа от 0 до 59.
-
int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime *o)¶
Возвращает значение микросекунды в виде числа от 0 до 999999.
-
int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)¶
Возвращает значение складки в виде числа int от 0 до 1.
Added in version 3.6.
-
PyObject *PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)¶
Возвращает информацию о tzinfo (которая может быть
None
).Added in version 3.10.
Макросы для извлечения полей из объектов времени. Аргумент должен быть экземпляром 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)¶
Возвращает значение секунды в виде числа от 0 до 59.
-
int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time *o)¶
Возвращает значение микросекунды в виде числа от 0 до 999999.
-
int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)¶
Возвращает значение складки в виде числа int от 0 до 1.
Added in version 3.6.
-
PyObject *PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)¶
Возвращает информацию о tzinfo (которая может быть
None
).Added in version 3.10.
Макросы для извлечения полей из объектов временных дельт. Аргумент должен быть экземпляром PyDateTime_Delta
, включая подклассы. Аргумент не должен быть NULL
, тип не проверяется:
-
int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)¶
Возвращает количество дней в формате int от -999999999 до 999999999.
Added in version 3.3.
-
int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)¶
Возвращает количество секунд в формате int от 0 до 86399.
Added in version 3.3.
-
int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)¶
Возвращает количество микросекунд в виде числа int от 0 до 999999.
Added in version 3.3.
Макросы для удобства модулей, реализующих DB API:
-
PyObject *PyDateTime_FromTimestamp(PyObject *args)¶
- Возвращаемое значение: Новая ссылка.
Создает и возвращает новый объект
datetime.datetime
с кортежем аргументов, пригодным для передачи вdatetime.datetime.fromtimestamp()
.
-
PyObject *PyDate_FromTimestamp(PyObject *args)¶
- Возвращаемое значение: Новая ссылка.
Создает и возвращает новый объект
datetime.date
с кортежем аргументов, пригодным для передачи вdatetime.date.fromtimestamp()
.