Об’єкти DateTime

Various date and time objects are supplied by the datetime module. Before using any of these functions, the header file datetime.h must be included in your source (note that this is not included by Python.h), and the macro PyDateTime_IMPORT must be invoked, usually as part of the module initialisation function. The macro puts a pointer to a C structure into a static variable, PyDateTimeAPI, that is used by the following macros.

Макрос для доступу до синглтону UTC:

PyObject* PyDateTime_TimeZone_UTC

Повертає синглтон часового поясу, який представляє UTC, той самий об’єкт, що й datetime.timezone.utc.

Нове в версії 3.7.

Макроси перевірки типу:

int PyDate_Check(PyObject *ob)

Return true if ob is of type PyDateTime_DateType or a subtype of PyDateTime_DateType. ob must not be NULL.

int PyDate_CheckExact(PyObject *ob)

Return true if ob is of type PyDateTime_DateType. ob must not be NULL.

int PyDateTime_Check(PyObject *ob)

Return true if ob is of type PyDateTime_DateTimeType or a subtype of PyDateTime_DateTimeType. ob must not be NULL.

int PyDateTime_CheckExact(PyObject *ob)

Return true if ob is of type PyDateTime_DateTimeType. ob must not be NULL.

int PyTime_Check(PyObject *ob)

Return true if ob is of type PyDateTime_TimeType or a subtype of PyDateTime_TimeType. ob must not be NULL.

int PyTime_CheckExact(PyObject *ob)

Return true if ob is of type PyDateTime_TimeType. ob must not be NULL.

int PyDelta_Check(PyObject *ob)

Return true if ob is of type PyDateTime_DeltaType or a subtype of PyDateTime_DeltaType. ob must not be NULL.

int PyDelta_CheckExact(PyObject *ob)

Return true if ob is of type PyDateTime_DeltaType. ob must not be NULL.

int PyTZInfo_Check(PyObject *ob)

Return true if ob is of type PyDateTime_TZInfoType or a subtype of PyDateTime_TZInfoType. ob must not be NULL.

int PyTZInfo_CheckExact(PyObject *ob)

Return true if ob is of type PyDateTime_TZInfoType. ob must not be 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.

Macros to extract fields from date objects. The argument must be an instance of PyDateTime_Date, including subclasses (such as PyDateTime_DateTime). The argument must not be NULL, and the type is not checked:

int PyDateTime_GET_YEAR(PyDateTime_Date *o)

Повернути рік, як позитивне внутр.

int PyDateTime_GET_MONTH(PyDateTime_Date *o)

Повертає місяць як int від 1 до 12.

int PyDateTime_GET_DAY(PyDateTime_Date *o)

Повертає день як int від 1 до 31.

Macros to extract fields from datetime objects. The argument must be an instance of PyDateTime_DateTime, including subclasses. The argument must not be NULL, and the type is not checked:

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.

int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)

Return the fold, as an int from 0 through 1.

Нове в версії 3.6.

Macros to extract fields from time objects. The argument must be an instance of PyDateTime_Time, including subclasses. The argument must not be NULL, and the type is not checked:

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.

int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)

Return the fold, as an int from 0 through 1.

Нове в версії 3.6.

Macros to extract fields from time delta objects. The argument must be an instance of PyDateTime_Delta, including subclasses. The argument must not be NULL, and the type is not checked:

int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)

Повертає кількість днів у вигляді int від -999999999 до 999999999.

Нове в версії 3.3.

int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)

Повертає кількість секунд у вигляді цілого типу від 0 до 86399.

Нове в версії 3.3.

int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)

Повертає кількість мікросекунд у вигляді цілого значення від 0 до 999999.

Нове в версії 3.3.

Макроси для зручності модулів, що реалізують API БД:

PyObject* PyDateTime_FromTimestamp(PyObject *args)

Return value: New reference.

Create and return a new datetime.datetime object given an argument tuple suitable for passing to datetime.datetime.fromtimestamp().

PyObject* PyDate_FromTimestamp(PyObject *args)

Return value: New reference.

Create and return a new datetime.date object given an argument tuple suitable for passing to datetime.date.fromtimestamp().