datetime モジュールでは、様々な日付オブジェクトや時刻オブジェクトを提供しています。以下に示す関数を使う場合には、あらかじめヘッダファイル datetime.h をソースに include し (Python.h はこのファイルを include しません)、 PyDateTime_IMPORT マクロを、通常はモジュール初期化関数から、起動しておく必要があります。このマクロは以下のマクロで使われる静的変数 PyDateTimeAPI に C 構造体へのポインタを入れます。
以下は型チェックマクロです:
ob が PyDateTime_DateType 型か PyDateTime_DateType 型のサブタイプのオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_DateType 型のオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_DateTimeType 型か PyDateTime_DateTimeType 型のサブタイプのオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_DateTimeType 型のオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_TimeType 型か PyDateTime_TimeType 型のサブタイプのオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_TimeType 型のオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_DeltaType 型か PyDateTime_DeltaType 型のサブタイプのオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_DeltaType 型のオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_TZInfoType 型か PyDateTime_TZInfoType 型のサブタイプのオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
ob が PyDateTime_TZInfoType 型のオブジェクトの場合に真を返します; ob は NULL であってはなりません。
バージョン 2.4 で追加.
以下はオブジェクトを作成するためのマクロです:
指定された年、月、日の datetime.date オブジェクトを返します。
バージョン 2.4 で追加.
指定された年、月、日、時、分、秒、マイクロ秒の datetime.datetime オブジェクトを返します。
バージョン 2.4 で追加.
指定された時、分、秒、マイクロ秒の datetime.time オブジェクトを返します。
バージョン 2.4 で追加.
指定された日、秒、マイクロ秒の datetime.timedelta オブジェクトを返します。マイクロ秒と秒が datetime.timedelta オブジェクトで定義されている範囲に入るように正規化を行います。
バージョン 2.4 で追加.
以下のマクロは date オブジェクトからフィールド値を取り出すためのものです。引数は PyDateTime_Date またはそのサブクラス (例えば PyDateTime_DateTime)の インスタンスでなければなりません。引数を NULL にしてはならず、型チェックは行いません:
年を正の整数で返します。
バージョン 2.4 で追加.
月を 1 から 12 の間の整数で返します。
バージョン 2.4 で追加.
日を 1 から 31 の間の整数で返します。
バージョン 2.4 で追加.
以下のマクロは datetime オブジェクトからフィールド値を取り出すためのものです。引数は PyDateTime_DateTime またはそのサブクラスのインスタンスでなければなりません。引数を NULL にしてはならず、型チェックは行いません:
時を 0 から 23 の間の整数で返します。
バージョン 2.4 で追加.
分を 0 から 59 の間の整数で返します。
バージョン 2.4 で追加.
秒を 0 から 59 の間の整数で返します。
バージョン 2.4 で追加.
マイクロ秒を 0 から 999999 の間の整数で返します。
バージョン 2.4 で追加.
以下のマクロは time オブジェクトからフィールド値を取り出すためのものです。引数は PyDateTime_Time またはそのサブクラスのインスタンスでなければなりません。引数を NULL にしてはならず、型チェックは行いません:
時を 0 から 23 の間の整数で返します。
バージョン 2.4 で追加.
分を 0 から 59 の間の整数で返します。
バージョン 2.4 で追加.
秒を 0 から 59 の間の整数で返します。
バージョン 2.4 で追加.
マイクロ秒を 0 から 999999 の間の整数で返します。
バージョン 2.4 で追加.
以下のマクロは DB API を実装する上での便宜用です: