This document is for an old version of Python that is no longer supported. You should upgrade and read the documentação do Python para versão estável atual.

# Objetos DateTime

Vários objetos de data e hora são fornecidos pelo módulo `datetime`. Antes de usar qualquer uma dessas funções, o arquivo de cabeçalho `datetime.h` deve ser incluído na sua fonte (observe que isso não é incluído por `Python.h`) e a macro `PyDateTime_IMPORT` deve ser chamada, geralmente como parte da função de inicialização do módulo. A macro coloca um ponteiro para uma estrutura C em uma variável estática, `PyDateTimeAPI`, usada pelas macros a seguir.

Macros de verificação de tipo:

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.

  Novo na versão 2.4.

int `PyDate_CheckExact`(PyObject *ob)

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

  Novo na versão 2.4.

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.

  Novo na versão 2.4.

int `PyDateTime_CheckExact`(PyObject *ob)

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

  Novo na versão 2.4.

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.

  Novo na versão 2.4.

int `PyTime_CheckExact`(PyObject *ob)

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

  Novo na versão 2.4.

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.

  Novo na versão 2.4.

int `PyDelta_CheckExact`(PyObject *ob)

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

  Novo na versão 2.4.

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.

  Novo na versão 2.4.

int `PyTZInfo_CheckExact`(PyObject *ob)

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

  Novo na versão 2.4.

Macros para criar objetos:

PyObject* `PyDate_FromDate`(int year, int month, int day)
  Return value: New reference.

  Return a `datetime.date` object with the specified year, month and day.

  Novo na versão 2.4.

PyObject* `PyDateTime_FromDateAndTime`(int year, int month, int day, int hour, int minute, int second, int usecond)
  Return value: New reference.

  Return a `datetime.datetime` object with the specified year, month, day, hour, minute, second and microsecond.

  Novo na versão 2.4.

PyObject* `PyTime_FromTime`(int hour, int minute, int second, int usecond)
  Return value: New reference.

  Return a `datetime.time` object with the specified hour, minute, second and microsecond.

  Novo na versão 2.4.

PyObject* `PyDelta_FromDSU`(int days, int seconds, int useconds)
  Return value: New reference.

  Return a `datetime.timedelta` object representing the given number of days, seconds and microseconds. Normalization is performed so that the resulting number of microseconds and seconds lie in the ranges documented for `datetime.timedelta` objects.

  Novo na versão 2.4.

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)

  Retorna o ano, como um inteiro positivo.

  Novo na versão 2.4.

int `PyDateTime_GET_MONTH`(PyDateTime_Date *o)

  Retorna o mês, como um inteiro de 1 a 12.

  Novo na versão 2.4.

int `PyDateTime_GET_DAY`(PyDateTime_Date *o)

  Retorna o dia, como um inteiro de 1 a 31.

  Novo na versão 2.4.

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)

  Retorna a hora, como um inteiro de 0 a 23.

  Novo na versão 2.4.

int `PyDateTime_DATE_GET_MINUTE`(PyDateTime_DateTime *o)

  Retorna o minuto, como um inteiro de 0 a 59.

  Novo na versão 2.4.

int `PyDateTime_DATE_GET_SECOND`(PyDateTime_DateTime *o)

  Retorna o segundo, como um inteiro de 0 a 59.

  Novo na versão 2.4.

int `PyDateTime_DATE_GET_MICROSECOND`(PyDateTime_DateTime *o)

  Retorna o microssegundo, como um inteiro de 0 a 999999.

  Novo na versão 2.4.

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)

  Retorna a hora, como um inteiro de 0 a 23.

  Novo na versão 2.4.

int `PyDateTime_TIME_GET_MINUTE`(PyDateTime_Time *o)

  Retorna o minuto, como um inteiro de 0 a 59.

  Novo na versão 2.4.

int `PyDateTime_TIME_GET_SECOND`(PyDateTime_Time *o)

  Retorna o segundo, como um inteiro de 0 a 59.

  Novo na versão 2.4.

int `PyDateTime_TIME_GET_MICROSECOND`(PyDateTime_Time *o)

  Retorna o microssegundo, como um inteiro de 0 a 999999.

  Novo na versão 2.4.

Macros para a conveniência de módulos implementando a API de DB:

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()`.

  Novo na versão 2.4.

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()`.

  Novo na versão 2.4.