# 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)

  Retorna verdadeiro se ob é do tipo `PyDateTime_DateType` ou um subtipo de `PyDateTime_DateType`. ob não deve ser NULL.

int `PyDate_CheckExact`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_DateType`. ob não deve ser NULL.

int `PyDateTime_Check`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_DateTimeType` ou um subtipo de `PyDateTime_DateTimeType`. ob não deve ser NULL.

int `PyDateTime_CheckExact`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_DateTimeType`. ob não deve ser NULL.

int `PyTime_Check`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_TimeType` ou um subtipo de `PyDateTime_TimeType`. ob não deve ser NULL.

int `PyTime_CheckExact`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_TimeType`. ob não deve ser NULL.

int `PyDelta_Check`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_DeltaType` ou um subtipo de `PyDateTime_DeltaType`. ob não deve ser NULL.

int `PyDelta_CheckExact`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_DeltaType`. ob não deve ser NULL.

int `PyTZInfo_Check`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_TZInfoType` ou um subtipe de `PyDateTime_TZInfoType`. ob não deve ser NULL.

int `PyTZInfo_CheckExact`(PyObject *ob)

  Retorna verdadeiro se ob é do tipo `PyDateTime_TZInfoType`. ob não deve ser NULL.

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.

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.

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.

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.

Macros para extrair campos de objetos date. O argumento deve ser uma instância de `PyDateTime_Date`, incluindo subclasses (tal qual `PyDateTime_DateTime`). O argumento não deve ser NULL, e o tipo não é checado:

int `PyDateTime_GET_YEAR`(PyDateTime_Date *o)

  Retorna o ano, como um inteiro positivo.

int `PyDateTime_GET_MONTH`(PyDateTime_Date *o)

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

int `PyDateTime_GET_DAY`(PyDateTime_Date *o)

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

Macros para extrair campos de objetos datetime. O argumento deve ser uma instância de `PyDateTime_DateTime`, incluindo subclasses. O argumento não deve ser NULL, e o tipo não é checado:

int `PyDateTime_DATE_GET_HOUR`(PyDateTime_DateTime *o)

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

int `PyDateTime_DATE_GET_MINUTE`(PyDateTime_DateTime *o)

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

int `PyDateTime_DATE_GET_SECOND`(PyDateTime_DateTime *o)

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

int `PyDateTime_DATE_GET_MICROSECOND`(PyDateTime_DateTime *o)

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

Macros para extrair campos de objetos time. O argumento deve ser uma instância de `PyDateTime_Time`, incluindo subclasses. O argumento não deve ser NULL, e o tipo não é checado:

int `PyDateTime_TIME_GET_HOUR`(PyDateTime_Time *o)

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

int `PyDateTime_TIME_GET_MINUTE`(PyDateTime_Time *o)

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

int `PyDateTime_TIME_GET_SECOND`(PyDateTime_Time *o)

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

int `PyDateTime_TIME_GET_MICROSECOND`(PyDateTime_Time *o)

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

Macros para extrair campos de objetos time delta. O argumento deve ser uma instância de `PyDateTime_Delta`, incluindo subclasses. O argumento não deve ser NULL, e o tipo não é checado:

int `PyDateTime_DELTA_GET_DAYS`(PyDateTime_Delta *o)

  Retorna o número de dias, como um inteiro de -999999999 a 999999999.

  Novo na versão 3.3.

int `PyDateTime_DELTA_GET_SECONDS`(PyDateTime_Delta *o)

  Retorna o número de segundos, como um inteiro de 0 a 86399.

  Novo na versão 3.3.

int `PyDateTime_DELTA_GET_MICROSECONDS`(PyDateTime_Delta *o)

  Retorna o número de microssegundos, como um inteiro de 0 a 999999.

  Novo na versão 3.3.

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

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