time_t

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

日期和時間工具

函式

時間操作

difftime

time

clock

timespec_get (C11)

timespec_getres (C23)

格式轉換

asctimeasctime_s (C23 中已廢棄)(C11)

ctimectime_s (C23 中已廢棄)(C11)

strftime

wcsftime (C95)

gmtimegmtime_rgmtime_s (C23)(C11)

localtimelocaltime_rlocaltime_s (C23)(C11)

mktime

常量

CLOCKS_PER_SEC

型別

tm

time_t

clock_t

timespec (C11)

 

定義於標頭檔案 <time.h>
typedef /* 未指定 */ time_t;

能夠表示時間的實際算術型別。

儘管C標準沒有定義，但這幾乎總是一個整數值，表示自1970年1月1日UTC 00:00以來（不計閏秒）的秒數，對應於POSIX時間。

注意

標準使用日曆時間一詞來指代time_t型別的值。

示例

顯示紀元開始。

執行此程式碼

#include <stdio.h>
#include <time.h>
#include <stdint.h>
 
int main(void)
{
    time_t epoch = 0;
    printf("%jd seconds since the epoch began\n", (intmax_t)epoch);
    printf("%s", asctime(gmtime(&epoch)));
}

可能的輸出

0 seconds since the epoch began
Thu Jan  1 00:00:00 1970

參考

• C17 標準 (ISO/IEC 9899:2018)

• 7.27.1/3 時間元件 (p: 284)

• C11 標準 (ISO/IEC 9899:2011)

• 7.27.1/3 時間元件 (p: 388)

• C99 標準 (ISO/IEC 9899:1999)

• 7.23.1/3 時間的組成部分 (p: 338)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.12.1 時間元件

參見

time	返回系統當前日曆時間，自紀元起的時間 (函式)
localtimelocaltime_rlocaltime_s (C23)(C11)	將自紀元以來的時間轉換為以本地時間表示的日曆時間 (函式)
gmtimegmtime_rgmtime_s (C23)(C11)	將自紀元以來的時間轉換為協調世界時 (UTC) 表示的日曆時間 (函式)
C++ documentation for time_t