PyTime C API¶
在 3.13 版被加入.
時鐘 C API 提供對系統時鐘的存取。它類似於 Python 的 time 模組。
對於與 datetime 模組相關的 C API，請參閱 DateTime 物件。
型別¶
-
type PyTime_t¶
以奈秒為單位的時間戳記或持續時長，以有符號的 64 位元整數表示。
時間戳記的參照點取決於所使用的時鐘。例如
PyTime_Time()回傳相對於 UNIX 紀元 (UNIX epoch) 的時間戳記。支援的範圍約為 [-292.3 年；+292.3 年]。以 Unix 紀元 (1970 年 1 月 1 日) 為參照，支援的日期範圍約為 [1677-09-21; 2262-04-11]。確切的限制是以常數的形式公開出來：
時鐘函式¶
以下的函式接受一個指向 PyTime_t 的指標，並將其設定為特定時鐘的值。每個時鐘的詳細資訊紀錄在相對應的 Python 函式說明文件中。
函式成功時會回傳 0 或在失敗時回傳 -1（並設定一個例外）。
在整數溢位時，它們會設定 PyExc_OverflowError 例外，並將 *result 設定為夾在 [PyTime_MIN; PyTime_MAX] 範圍內的值。（在目前的系統上，整數溢位很可能是由於錯誤設定的系統時間所造成。）
As any other C API (unless otherwise specified), the functions must be called with an attached thread state.
-
int PyTime_Monotonic(PyTime_t *result)¶
讀取單調時鐘。請參閱
time.monotonic()取得此時鐘的重要詳細資訊。
-
int PyTime_PerfCounter(PyTime_t *result)¶
讀取效能計數器。請參閱
time.perf_counter()以取得此時鐘的重要詳細資訊。
-
int PyTime_Time(PyTime_t *result)¶
讀取「牆上時鐘 (wall clock)」的時間。請參閱
time.time()以取得詳細資訊。
原始時鐘函式¶
Similar to clock functions, but don't set an exception on error and don't require the caller to have an attached thread state.
成功時函式會回傳 0。
On failure, they set *result to 0 and return -1, without setting
an exception. To get the cause of the error, attach a thread state,
and call the regular (non-Raw) function. Note that the regular function may succeed after
the Raw one failed.
-
int PyTime_MonotonicRaw(PyTime_t *result)¶
Similar to
PyTime_Monotonic(), but don't set an exception on error and don't require an attached thread state.
-
int PyTime_PerfCounterRaw(PyTime_t *result)¶
Similar to
PyTime_PerfCounter(), but don't set an exception on error and don't require an attached thread state.
-
int PyTime_TimeRaw(PyTime_t *result)¶
Similar to
PyTime_Time(), but don't set an exception on error and don't require an attached thread state.