☰ Menu Python

☰ Menu

DateTime 객체

다양한 날짜 및 시간 객체는 datetime 모듈에서 제공됩니다. 이 함수들 중 어떤 것을 사용하기 전에, 헤더 파일 datetime.h`가 소스에 포함되어야 합니다(참고: :file:`Python.h`에서는 포함되지 않음). 또한, 일반적으로 모듈 초기화 함수의 일부로 :c:macro:`PyDateTime_IMPORT 매크로를 호출해야 합니다. 이 매크로는 C 구조체에 대한 포인터를 다음 매크로에서 사용되는 정적 변수 :c:data:`PyDateTimeAPI`에 넣습니다.

PyDateTime_IMPORT()

datetime C API 가져오기.

성공하면 PyDateTimeAPI 포인터를 채웁니다. 실패하면 PyDateTimeAPI 를 NULL 로 설정하고 예외를 설정합니다. 호출자는 PyErr_Occurred() 를 통해 오류가 발생했는지 확인해야 합니다:

PyDateTime_IMPORT;
if (PyErr_Occurred()) { /* cleanup */ }

경고

이것은 서브 인터프리터와 호환되지 않습니다.

버전 3.15에서 변경: 이 매크로는 이제 스레드 안전합니다.

type PyDateTime_CAPI

datetime C API용 필드를 포함하는 구조체.

이 구조체의 필드는 비공개이며 변경될 수 있습니다.

이것을 직접 사용하지 마십시오. 대신 PyDateTime_* API를 사용하는 것이 좋습니다.

PyDateTime_CAPI *PyDateTimeAPI

datetime C API를 포함하는 동적으로 할당된 객체.

이 변수는 :c:macro:`PyDateTime_IMPORT`가 성공했을 때만 사용할 수 있습니다.

버전 3.15에서 변경: 이 변수는 직접 접근해서는 안 됩니다. 직접 접근은 스레드 안전하지 않습니다. 대신 :c:func:`PyDateTime_IMPORT`를 사용하세요.

type PyDateTime_Date

:c:type:`PyObject`의 이 서브 타입은 파이썬 날짜 객체를 나타냅니다.

type PyDateTime_DateTime

:c:type:`PyObject`의 이 서브 타입은 파이썬 datetime 객체를 나타냅니다.

type PyDateTime_Time

이 PyObject\의 서브 형은 파이썬 시간 객체를 나타냅니다.

type PyDateTime_Delta

이 PyObject\의 서브 형은 두 datetime 값 사이의 차이를 나타냅니다.

PyTypeObject PyDateTime_DateType

이 PyTypeObject 인스턴스는 파이썬 날짜 형을 나타내며, 파이썬 계층의 datetime.date\와 같은 객체입니다.

PyTypeObject PyDateTime_DateTimeType

이 PyTypeObject 인스턴스는 파이썬 datetime 형을 나타내며, 파이썬 계층의 datetime.datetime\와 같은 객체입니다.

PyTypeObject PyDateTime_TimeType

이 PyTypeObject 인스턴스는 파이썬 시간 형을 나타내며, 파이썬 계층의 datetime.time\와 같은 객체입니다.

PyTypeObject PyDateTime_DeltaType

이 PyTypeObject 인스턴스는 두 datetime 값 사이의 차이를 나타내는 파이썬 타입을 나타내며, 파이썬 계층의 datetime.timedelta\와 같은 객체입니다.

PyTypeObject PyDateTime_TZInfoType

이 PyTypeObject 인스턴스는 파이썬 시간대 정보 타입을 나타내며, 파이썬 계층의 datetime.tzinfo\와 같은 객체입니다.

UTC 싱글톤에 액세스하기 위한 매크로:

PyObject *PyDateTime_TimeZone_UTC

UTC를 나타내는 시간대 싱글톤을 반환합니다, datetime.timezone.utc와 같은 객체입니다.

Added in version 3.7.

형 검사 매크로:

int PyDate_Check(PyObject *ob)

ob가 PyDateTime_DateType 형이거나 PyDateTime_DateType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDate_CheckExact(PyObject *ob)

ob가 PyDateTime_DateType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDateTime_Check(PyObject *ob)

ob가 PyDateTime_DateTimeType 형이거나 PyDateTime_DateTimeType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDateTime_CheckExact(PyObject *ob)

ob가 PyDateTime_DateTimeType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTime_Check(PyObject *ob)

ob가 PyDateTime_TimeType 형이거나 PyDateTime_TimeType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTime_CheckExact(PyObject *ob)

ob가 PyDateTime_TimeType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDelta_Check(PyObject *ob)

ob가 PyDateTime_DeltaType 형이거나 PyDateTime_DeltaType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDelta_CheckExact(PyObject *ob)

ob가 PyDateTime_DeltaType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTZInfo_Check(PyObject *ob)

ob가 PyDateTime_TZInfoType 형이거나 PyDateTime_TZInfoType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTZInfo_CheckExact(PyObject *ob)

ob가 PyDateTime_TZInfoType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

객체를 만드는 매크로:

PyObject *PyDate_FromDate(int year, int month, int day)

반환값: 새 참조.

지정된 년, 월, 일의 datetime.date 객체를 반환합니다.

PyObject *PyDateTime_FromDateAndTime(int year, int month, int day, int hour, int minute, int second, int usecond)

반환값: 새 참조.

지정된 년, 월, 일, 시, 분, 초 및 마이크로초의 datetime.datetime 객체를 반환합니다.

PyObject *PyDateTime_FromDateAndTimeAndFold(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)

반환값: 새 참조.

지정된 년, 월, 일, 시, 분, 초, 마이크로초 및 fold의 datetime.datetime 객체를 반환합니다.

Added in version 3.6.

PyObject *PyTime_FromTime(int hour, int minute, int second, int usecond)

반환값: 새 참조.

지정된 시, 분, 초 및 마이크로초의 datetime.time 객체를 반환합니다.

PyObject *PyTime_FromTimeAndFold(int hour, int minute, int second, int usecond, int fold)

반환값: 새 참조.

지정된 시, 분, 초, 마이크로초 및 fold의 datetime.time 객체를 반환합니다.

Added in version 3.6.

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

반환값: 새 참조.

지정된 일, 초 및 마이크로초 수를 나타내는 datetime.timedelta 객체를 반환합니다. 결과 마이크로초와 초가 datetime.timedelta 객체에 관해 설명된 범위에 있도록 정규화가 수행됩니다.

PyObject *PyTimeZone_FromOffset(PyObject *offset)

반환값: 새 참조.

offset 인자로 나타내지는 이름이 없는 고정 오프셋의 datetime.timezone 객체를 돌려줍니다.

Added in version 3.7.

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

반환값: 새 참조.

offset 인자와 tzname name으로 나타내지는 고정 오프셋의 datetime.timezone 객체를 돌려줍니다.

Added in version 3.7.

날짜 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스(가령 PyDateTime_DateTime)를 포함하여 PyDateTime_Date의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며, 형은 검사하지 않습니다:

int PyDateTime_GET_YEAR(PyDateTime_Date *o)

양의 int로, 년을 반환합니다.

int PyDateTime_GET_MONTH(PyDateTime_Date *o)

1에서 12까지의 int로, 월을 반환합니다.

int PyDateTime_GET_DAY(PyDateTime_Date *o)

1에서 31까지의 int로, 일을 반환합니다.

날짜 시간 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스를 포함하여 PyDateTime_DateTime의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며, 형은 검사하지 않습니다.:

int PyDateTime_DATE_GET_HOUR(PyDateTime_DateTime *o)

0부터 23까지의 int로, 시를 반환합니다.

int PyDateTime_DATE_GET_MINUTE(PyDateTime_DateTime *o)

0부터 59까지의 int로, 분을 반환합니다.

int PyDateTime_DATE_GET_SECOND(PyDateTime_DateTime *o)

0부터 59까지의 int로, 초를 반환합니다.

int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime *o)

0부터 999999까지의 int로, 마이크로초를 반환합니다.

int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)

0에서 1까지의 int로, 폴드를 반환합니다.

Added in version 3.6.

PyObject *PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)

tzinfo(값이 None 일 수 있음)를 반환합니다.

Added in version 3.10.

시간 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스를 포함하여 PyDateTime_Time의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며 형은 검사하지 않습니다:

int PyDateTime_TIME_GET_HOUR(PyDateTime_Time *o)

0부터 23까지의 int로, 시를 반환합니다.

int PyDateTime_TIME_GET_MINUTE(PyDateTime_Time *o)

0부터 59까지의 int로, 분을 반환합니다.

int PyDateTime_TIME_GET_SECOND(PyDateTime_Time *o)

0부터 59까지의 int로, 초를 반환합니다.

int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time *o)

0부터 999999까지의 int로, 마이크로초를 반환합니다.

int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)

0에서 1까지의 int로, 폴드를 반환합니다.

Added in version 3.6.

PyObject *PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)

tzinfo(값이 None 일 수 있음)를 반환합니다.

Added in version 3.10.

시간 델타 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스를 포함하여 PyDateTime_Delta의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며 형은 검사하지 않습니다.:

int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)

-999999999에서 999999999까지의 int로, 일 수를 반환합니다.

Added in version 3.3.

int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)

0부터 86399까지의 int로, 초 수를 반환합니다.

Added in version 3.3.

int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)

0에서 999999까지의 int로, 마이크로초 수를 반환합니다.

Added in version 3.3.

DB API를 구현하는 모듈의 편의를 위한 매크로:

PyObject *PyDateTime_FromTimestamp(PyObject *args)

반환값: 새 참조.

datetime.datetime.fromtimestamp()에 전달하는 데 적합한 인자 튜플로 새 datetime.datetime 객체를 만들고 반환합니다.

PyObject *PyDate_FromTimestamp(PyObject *args)

반환값: 새 참조.

datetime.date.fromtimestamp()에 전달하는 데 적합한 인자 튜플로 새 datetime.date 객체를 만들고 반환합니다.

내부 데이터

다음 심볼들은 C API에서 노출되지만 내부적으로만 간주해야 합니다.

PyDateTime_CAPSULE_NAME

:c:func:`PyCapsule_Import`에 전달할 datetime 캡슐의 이름입니다.

내부 사용 전용입니다. 대신 :c:macro:`PyDateTime_IMPORT`를 사용하십시오.

분실물 보관소