`datetime.md`

162 строк · 9.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.5/c-api/datetime.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Объекты даты и времени89Модуль [`datetime`](https://python-all.ru/3.5/library/datetime.html#module-datetime) предоставляет различные объекты для работы с датой и временем. Перед использованием любой из этих функций в исходный код необходимо включить заголовочный файл `datetime.h` (обратите внимание: он не включается макросом `Python.h`), а также вызвать макрос `PyDateTime_IMPORT`, обычно – в функции инициализации модуля. Этот макрос помещает указатель на C-структуру в статическую переменную `PyDateTimeAPI`, которая используется последующими макросами.1011Макросы проверки типа:1213#### `int PyDate_Check(PyObject *ob)`1415Возвращает true, если *ob* имеет тип `PyDateTime_DateType` или является подтипом `PyDateTime_DateType`. *ob* не должен быть *NULL*.1617#### `int PyDate_CheckExact(PyObject *ob)`1819Возвращает true, если *ob* имеет тип `PyDateTime_DateType`. *ob* не должен быть *NULL*.2021#### `int PyDateTime_Check(PyObject *ob)`2223Возвращает true, если *ob* имеет тип `PyDateTime_DateTimeType` или является подтипом `PyDateTime_DateTimeType`. *ob* не должен быть *NULL*.2425#### `int PyDateTime_CheckExact(PyObject *ob)`2627Возвращает true, если *ob* имеет тип `PyDateTime_DateTimeType`. *ob* не должен быть *NULL*.2829#### `int PyTime_Check(PyObject *ob)`3031Возвращает true, если *ob* имеет тип `PyDateTime_TimeType` или является подтипом `PyDateTime_TimeType`. *ob* не должен быть *NULL*.3233#### `int PyTime_CheckExact(PyObject *ob)`3435Возвращает true, если *ob* имеет тип `PyDateTime_TimeType`. *ob* не должен быть *NULL*.3637#### `int PyDelta_Check(PyObject *ob)`3839Возвращает true, если *ob* имеет тип `PyDateTime_DeltaType` или является подтипом `PyDateTime_DeltaType`. *ob* не должен быть *NULL*.4041#### `int PyDelta_CheckExact(PyObject *ob)`4243Возвращает true, если *ob* имеет тип `PyDateTime_DeltaType`. *ob* не должен быть *NULL*.4445#### `int PyTZInfo_Check(PyObject *ob)`4647Возвращает true, если *ob* имеет тип `PyDateTime_TZInfoType` или является подтипом `PyDateTime_TZInfoType`. *ob* не должен быть *NULL*.4849#### `int PyTZInfo_CheckExact(PyObject *ob)`5051Возвращает true, если *ob* имеет тип `PyDateTime_TZInfoType`. *ob* не должен быть *NULL*.5253Макросы для создания объектов:5455#### `PyObject* PyDate_FromDate(int year, int month, int day)`5657*Возвращаемое значение: новая ссылка.*5859Возвращает объект `datetime.date` с указанными годом, месяцем и днём.6061#### `PyObject* PyDateTime_FromDateAndTime(int year, int month, int day, int hour, int minute, int second, int usecond)`6263*Возвращаемое значение: новая ссылка.*6465Возвращает объект `datetime.datetime` с указанными годом, месяцем, днём, часом, минутой, секундой и микросекундой.6667#### `PyObject* PyTime_FromTime(int hour, int minute, int second, int usecond)`6869*Возвращаемое значение: новая ссылка.*7071Возвращает объект `datetime.time` с указанными часом, минутой, секундой и микросекундой.7273#### `PyObject* PyDelta_FromDSU(int days, int seconds, int useconds)`7475*Возвращаемое значение: новая ссылка.*7677Возвращает объект `datetime.timedelta`, представляющий заданное количество дней, секунд и микросекунд. Нормализация выполняется так, чтобы результирующее количество микросекунд и секунд находилось в диапазонах, задокументированных для объектов `datetime.timedelta`.7879Макросы для извлечения полей из объектов даты. Аргумент должен быть экземпляром `PyDateTime_Date`, включая подклассы (такие как `PyDateTime_DateTime`). Аргумент не должен быть *NULL*, и тип не проверяется:8081#### `int PyDateTime_GET_YEAR(PyDateTime_Date *o)`8283Возвращает год в виде положительного int.8485#### `int PyDateTime_GET_MONTH(PyDateTime_Date *o)`8687Возвращает месяц в виде int от 1 до 12.8889#### `int PyDateTime_GET_DAY(PyDateTime_Date *o)`9091Возвращает день в виде int от 1 до 31.9293Макросы для извлечения полей из объектов datetime. Аргумент должен быть экземпляром `PyDateTime_DateTime`, включая подклассы. Аргумент не должен быть *NULL*, и тип не проверяется:9495#### `int PyDateTime_DATE_GET_HOUR(PyDateTime_DateTime *o)`9697Возвращает часы в виде целого числа от 0 до 23.9899#### `int PyDateTime_DATE_GET_MINUTE(PyDateTime_DateTime *o)`100101Возвращает минуты в виде целого числа от 0 до 59.102103#### `int PyDateTime_DATE_GET_SECOND(PyDateTime_DateTime *o)`104105Возвращает секунды в виде целого числа от 0 до 59.106107#### `int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime *o)`108109Возвращает микросекунды в виде целого числа от 0 до 999999.110111Макросы для извлечения полей из объектов time. Аргумент должен быть экземпляром `PyDateTime_Time`, включая подклассы. Аргумент не должен быть *NULL*, и тип не проверяется:112113#### `int PyDateTime_TIME_GET_HOUR(PyDateTime_Time *o)`114115Возвращает часы в виде целого числа от 0 до 23.116117#### `int PyDateTime_TIME_GET_MINUTE(PyDateTime_Time *o)`118119Возвращает минуты в виде целого числа от 0 до 59.120121#### `int PyDateTime_TIME_GET_SECOND(PyDateTime_Time *o)`122123Возвращает секунды в виде целого числа от 0 до 59.124125#### `int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time *o)`126127Возвращает микросекунды в виде целого числа от 0 до 999999.128129Макросы для извлечения полей из объектов timedelta. Аргумент должен быть экземпляром `PyDateTime_Delta`, включая подклассы. Аргумент не должен быть *NULL*, и тип не проверяется:130131#### `int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)`132133Возвращает количество дней в виде целого числа от -999999999 до 999999999.134135Новое в версии 3.3.136137#### `int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)`138139Возвращает количество секунд в виде целого числа от 0 до 86399.140141Новое в версии 3.3.142143#### `int PyDateTime_DELTA_GET_MICROSECOND(PyDateTime_Delta *o)`144145Возвращает количество микросекунд в виде целого числа от 0 до 999999.146147Новое в версии 3.3.148149Макросы для удобства модулей, реализующих DB API:150151#### `PyObject* PyDateTime_FromTimestamp(PyObject *args)`152153*Возвращаемое значение: новая ссылка.*154155Создаёт и возвращает новый объект `datetime.datetime` на основе кортежа аргументов, подходящего для передачи в `datetime.datetime.fromtimestamp()`.156157#### `PyObject* PyDate_FromTimestamp(PyObject *args)`158159*Возвращаемое значение: новая ссылка.*160161Создаёт и возвращает новый объект `datetime.date` на основе кортежа аргументов, подходящего для передачи в `datetime.date.fromtimestamp()`.162