Docs4dev
Docs
python / 2.7.15 / all / c-api-datetime.html

DateTime Objects

datetime模块提供了各种日期和时间对象。在使用任何这些Function之前，必须将头文件datetime.h包含在您的源代码中(请注意Python.h不包括此文件)，并且必须调用PyDateTime_IMPORT宏，通常将其作为模块初始化Function的一部分。该宏将指向 C 结构的指针放入静态变量PyDateTimeAPI，该变量由以下宏使用。

Type-check macros:

  • int PyDate_Check(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_DateType或子类型PyDateTime_DateType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyDate_CheckExact(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_DateType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyDateTime_Check(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_DateTimeType或子类型PyDateTime_DateTimeType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyDateTime_CheckExact(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_DateTimeType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyTime_Check(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_TimeType或子类型PyDateTime_TimeType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyTime_CheckExact(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_TimeType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyDelta_Check(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_DeltaType或子类型PyDateTime_DeltaType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyDelta_CheckExact(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_DeltaType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyTZInfo_Check(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_TZInfoType或子类型PyDateTime_TZInfoType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

  • int PyTZInfo_CheckExact(PyObject ** ob *)
    • 如果* ob *类型为PyDateTime_TZInfoType，则返回 true。 * ob 不能为 NULL *。

2.4 版的新Function。

创建对象的宏：

  • PyObject * PyDate_FromDate(int 年，int 月，int 天)
    • 返回值：新参考.

返回具有指定年，月和日的datetime.date对象。

2.4 版的新Function。

  • PyObject * PyDateTime_FromDateAndTime(int * year *，int * month *，int * day *，int * hour *，int * minute *，int * second *，int * usecond *)
    • 返回值：新参考.

返回具有指定的年，月，日，小时，分钟，秒和微秒的datetime.datetime对象。

2.4 版的新Function。

  • PyObject * PyTime_FromTime(int * hour *，int * minute *，int * second *，int * usecond *)
    • 返回值：新参考.

返回具有指定的小时，分钟，秒和微秒的datetime.time对象。

2.4 版的新Function。

  • PyObject * PyDelta_FromDSU(int * days *，int * seconds *，int * useconds *)
    • 返回值：新参考.

返回代表给定天数，秒和微秒的datetime.timedelta对象。执行归一化，以使finally的微秒和秒数位于为datetime.timedelta个对象记录的范围内。

2.4 版的新Function。

从日期对象提取字段的宏。参数必须是PyDateTime_Date的实例，包括子类(例如PyDateTime_DateTime)。参数不能为* NULL *，并且不检查类型：

  • int PyDateTime_GET_YEAR(PyDateTime_Date ** o *)
    • 返回年份，作为一个正整数。

2.4 版的新Function。

  • int PyDateTime_GET_MONTH(PyDateTime_Date ** o *)
    • 以 1 到 12 之间的整数形式返回月份。

2.4 版的新Function。

  • int PyDateTime_GET_DAY(PyDateTime_Date ** o *)
    • 以 1 到 31 之间的整数形式返回日期。

2.4 版的新Function。

从日期时间对象提取字段的宏。参数必须是PyDateTime_DateTime的实例，包括子类。参数不能为* NULL *，并且不检查类型：

  • int PyDateTime_DATE_GET_HOUR(PyDateTime_DateTime ** o *)
    • 以 0 到 23 之间的整数形式返回小时。

2.4 版的新Function。

  • int PyDateTime_DATE_GET_MINUTE(PyDateTime_DateTime ** o *)
    • 以 0 到 59 之间的整数形式返回分钟。

2.4 版的新Function。

  • int PyDateTime_DATE_GET_SECOND(PyDateTime_DateTime ** o *)
    • 以 0 到 59 之间的整数形式返回第二个。

2.4 版的新Function。

  • int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime ** o *)
    • 返回微秒，作为一个从 0 到 999999 的整数。

2.4 版的新Function。

从时间对象中提取字段的宏。参数必须是PyDateTime_Time的实例，包括子类。参数不能为* NULL *，并且不检查类型：

  • int PyDateTime_TIME_GET_HOUR(PyDateTime_Time ** o *)
    • 以 0 到 23 之间的整数形式返回小时。

2.4 版的新Function。

  • int PyDateTime_TIME_GET_MINUTE(PyDateTime_Time ** o *)
    • 以 0 到 59 之间的整数形式返回分钟。

2.4 版的新Function。

  • int PyDateTime_TIME_GET_SECOND(PyDateTime_Time ** o *)
    • 以 0 到 59 之间的整数形式返回第二个。

2.4 版的新Function。

  • int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time ** o *)
    • 返回微秒，作为一个从 0 到 999999 的整数。

2.4 版的新Function。

宏，以方便实现 DB API 的模块：

  • PyObject * PyDateTime_FromTimestamp(PyObject ** args *)
    • 返回值：新参考.

给定一个适合传递给datetime.datetime.fromtimestamp()的参数 Tuples，创建并返回一个新的datetime.datetime对象。

2.4 版的新Function。

给定一个适合传递给datetime.date.fromtimestamp()的参数 Tuples，创建并返回一个新的datetime.date对象。

2.4 版的新Function。