標準庫標頭檔案 <time.h>

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

標準庫標頭檔案

<assert.h> <complex.h> (C99) <ctype.h> <errno.h> <fenv.h> (C99) <float.h> <inttypes.h> (C99)     <iso646.h> (C95) <limits.h> <locale.h> <math.h>

<setjmp.h> <signal.h> <stdalign.h> (C11*) <stdarg.h> <stdatomic.h> (C11)     <stdbit.h> (C23) <stdbool.h> (C99*) <stdckdint.h> (C23) <stddef.h> <stdint.h> (C99) <stdio.h>

<stdlib.h> <stdmchar.h> (C29) <stdnoreturn.h> (C11*) <string.h> <tgmath.h> (C99) <threads.h> (C11) <time.h> <uchar.h> (C11) <wchar.h> (C95) <wctype.h> (C95)

 

此標頭檔案是日期和時間工具庫的一部分。

函式

時間操作
difftime	計算時間差 (函式)
time	返回系統當前日曆時間，自紀元起的時間 (函式)
clock	返回程式啟動以來原始處理器時鐘時間 (函式)
timespec_get (C11)	根據給定時間基準返回以秒和納秒錶示的日曆時間 (函式)
timespec_getres (C23)	根據給定時間基準返回日曆時間的解析度 (函式)
格式轉換
asctimeasctime_s (C23 中已廢棄)(C11)	將 tm 物件轉換為文字表示 (函式)
ctimectime_s (C23 中已廢棄)(C11)	將 time_t 物件轉換為文字表示形式 (函式)
strftime	將 tm 物件轉換為自定義文字表示形式 (函式)
gmtimegmtime_rgmtime_s (C23)(C11)	將自紀元以來的時間轉換為協調世界時 (UTC) 表示的日曆時間 (函式)
localtimelocaltime_rlocaltime_s (C23)(C11)	將自紀元以來的時間轉換為以本地時間表示的日曆時間 (函式)
mktime	將日曆時間轉換為自紀元以來的時間 (函式)

常量

CLOCKS_PER_SEC

每秒的處理器時鐘節拍數 (宏常量)

型別

tm	日曆時間型別 (結構體)
time_t	自紀元以來的日曆時間型別 (型別定義)
clock_t	自紀元以來的處理器時間型別 (型別定義)
timespec (C11)	秒和納秒時間 (結構體)

概要

#define __STDC_VERSION_TIME_H__ 202311L
 
#define NULL           /* see description */
#define CLOCKS_PER_SEC /* see description */
#define TIME_UTC       /* see description */
 
typedef /* see description */ clock_t;
typedef /* see description */ size_t;
typedef /* see description */ time_t;
 
struct timespec { /* see description */ };
struct tm { /* see description */ };
 
clock_t clock(void);
double difftime(time_t time1, time_t time0);
time_t mktime(struct tm* timeptr);
time_t timegm(struct tm* timeptr);
time_t time(time_t* timer);
int timespec_get(struct timespec* ts, int base);
int timespec_getres(struct timespec* ts, int base);
[[deprecated]] char* asctime(const struct tm* timeptr);
[[deprecated]] char* ctime(const time_t* timer);
struct tm* gmtime(const time_t* timer);
struct tm* gmtime_r(const time_t* timer, struct tm* buf);
struct tm* localtime(const time_t* timer);
struct tm* localtime_r(const time_t* timer, struct tm* buf);
size_t strftime(char* restrict s, size_t maxsize, const char* restrict format,
const struct tm* restrict timeptr);

僅當實現支援時

#define TIME_MONOTONIC /* see description */
#define TIME_ACTIVE    /* see description */

僅當支援執行緒且實現支援時

#define TIME_THREAD_ACTIVE /* see description */

僅當實現定義了 __STDC_LIB_EXT1__ 且使用者程式碼在包含 <time.h> 之前定義了 __STDC_WANT_LIB_EXT1__ 時

#ifdef __STDC_WANT_LIB_EXT1__
typedef /* see description */ errno_t;
typedef /* see description */ rsize_t;
 
errno_t asctime_s(char* s, rsize_t maxsize, const struct tm* timeptr);
errno_t ctime_s(char* s, rsize_t maxsize, const time_t* timer);
struct tm* gmtime_s(const time_t* restrict timer, struct tm* restrict result);
struct tm* localtime_s(const time_t* restrict timer, struct tm* restrict result);
#endif