tm

 

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>
struct tm;

將日曆日期和時間分解為其組成部分的結構體。

成員物件

int tm_sec	分後的秒數 – [​0​, 61](C99 之前)[​0​, 60](C99 起) (公有成員物件)
int tm_min	小時後的分鐘數 – [​0​, 59] (公有成員物件)
int tm_hour	午夜後的小時數 – [​0​, 23] (公有成員物件)
int tm_mday	月份中的日期 – [1, 31] (公有成員物件)
int tm_mon	一月後的月份數 – [​0​, 11] (公有成員物件)
int tm_year	1900 年後的年份數 (公有成員物件)
int tm_wday	週日後的天數 – [​0​, 6] (公有成員物件)
int tm_yday	1 月 1 日後的天數 – [​0​, 365] (公有成員物件)
int tm_isdst	夏令時標誌。如果夏令時生效，則值為正；如果不生效，則為零；如果沒有可用資訊，則為負。 (公有成員物件)

注意

標準僅強制要求上述成員的存在，順序不限。實現通常會向此結構體新增更多資料成員。

示例

執行此程式碼

#include <stdio.h>
#include <time.h>
 
int main(void)
{
    struct tm start = {.tm_year = 2022 - 1900, .tm_mday = 1};
    mktime(&start);
    printf("%s", asctime(&start)); // note implicit trailing '\n'
}

輸出

Sat Jan  1 00:00:00 2022

參考資料

• C23 標準 (ISO/IEC 9899:2024)

• 7.27.1/3 時間的組成部分 (p: 待定)

• 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 時間元件

另請參閱

localtimelocaltime_rlocaltime_s (C23)(C11)	將自紀元以來的時間轉換為以本地時間表示的日曆時間 (函式)
gmtimegmtime_rgmtime_s (C23)(C11)	將自紀元以來的時間轉換為協調世界時 (UTC) 表示的日曆時間 (函式)
C++ 文件 關於 tm