Об’єкти 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.

type PyDateTime_Date

This subtype of PyObject represents a Python date object.

type PyDateTime_DateTime

This subtype of PyObject represents a Python datetime object.

type PyDateTime_Time

This subtype of PyObject represents a Python time object.

type PyDateTime_Delta

This subtype of PyObject represents the difference between two datetime values.

PyTypeObject PyDateTime_DateType

This instance of PyTypeObject represents the Python date type; it is the same object as datetime.date in the Python layer.

PyTypeObject PyDateTime_DateTimeType

This instance of PyTypeObject represents the Python datetime type; it is the same object as datetime.datetime in the Python layer.

PyTypeObject PyDateTime_TimeType

This instance of PyTypeObject represents the Python time type; it is the same object as datetime.time in the Python layer.

PyTypeObject PyDateTime_DeltaType

This instance of PyTypeObject represents Python type for the difference between two datetime values; it is the same object as datetime.timedelta in the Python layer.

PyTypeObject PyDateTime_TZInfoType

This instance of PyTypeObject represents the Python time zone info type; it is the same object as datetime.tzinfo in the Python layer.

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

PyObject *PyDateTime_TimeZone_UTC

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

Added in version 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. This function always succeeds.

int PyDate_CheckExact(PyObject *ob)

Повертає true, якщо ob має тип PyDateTime_DateType. ob не має бути 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. This function always succeeds.

int PyDateTime_CheckExact(PyObject *ob)

Повертає true, якщо ob має тип PyDateTime_DateTimeType. ob не має бути 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. This function always succeeds.

int PyTime_CheckExact(PyObject *ob)

Повертає true, якщо ob має тип PyDateTime_TimeType. ob не має бути 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. This function always succeeds.

int PyDelta_CheckExact(PyObject *ob)

Повертає true, якщо ob має тип PyDateTime_DeltaType. ob не має бути 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. This function always succeeds.

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 із вказаним роком, місяцем, днем, годиною, хвилиною, секундою, мікросекундою та кратністю.

Added in version 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 із вказаною годиною, хвилиною, секундою, мікросекундою та кратністю.

Added in version 3.6.

PyObject *PyDelta_FromDSU(int days, int seconds, int useconds)

Return value: New reference.

Повертає об’єкт datetime.timedelta, що представляє задану кількість днів, секунд і мікросекунд. Нормалізація виконується таким чином, щоб результуюча кількість мікросекунд і секунд лежала в діапазонах, задокументованих для об’єктів datetime.timedelta.

PyObject *PyTimeZone_FromOffset(PyObject *offset)

Return value: New reference.

Повертає об’єкт datetime.timezone із фіксованим зсувом без назви, представленим аргументом offset.

Added in version 3.7.

PyObject *PyTimeZone_FromOffsetAndName(PyObject *offset, PyObject *name)

Return value: New reference.

Повертає об’єкт datetime.timezone із фіксованим зсувом, представленим аргументом offset, і з tzname name.

Added in version 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.

Added in version 3.6.

PyObject *PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)

Повертає tzinfo (яка може бути None).

Added in version 3.10.

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.

Added in version 3.6.

PyObject *PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)

Повертає tzinfo (яка може бути None).

Added in version 3.10.

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.

Added in version 3.3.

int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)

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

Added in version 3.3.

int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)

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

Added in version 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().