time() - Unix 和 Linux 系統呼叫

名稱

time - 獲取以秒為單位的時間

語法

#include <time.h>

time_t time(time_t *t);

描述

time() 返回自紀元（1970年1月1日，協調世界時00:00:00）以來的時間，以秒為單位。

如果 t 非空，則返回值也會儲存在 t 指向的記憶體中。

返回值

成功時，返回自紀元以來的時間（以秒為單位）。發生錯誤時，返回 ((time_t)-1)，並且 errno 被相應地設定。

錯誤

標籤	描述
EFAULT	t 指向您可訪問的地址空間之外。

備註

POSIX.1 將自紀元以來的秒數定義為一個值，該值應解釋為指定時間與紀元之間以秒為單位的時間差，根據從 UTC 轉換的公式，等同於基於忽略閏秒並且所有能被 4 整除的年份都是閏年的簡單轉換。此值與時間與紀元之間的實際秒數不同，因為存在閏秒，並且時鐘不需要與標準參考同步。目的是使自紀元以來的秒數值的解釋保持一致；有關更多基本原理，請參閱 POSIX.1 附錄 B 2.2.2。

符合標準

SVr4、4.3BSD、POSIX.1-2001。
在 4.3BSD 下，此呼叫被gettimeofday(2) 取代。POSIX 未指定任何錯誤條件。

參見

列印頁面