# C 语言标准库函数 time

/*********************************************
 * @brief 获取当前时间
 * @param arg 返回当前时间
 * @return 当前时间
 ********************************************/
time_t time(time_t* arg);

!subtitle:说明

获取当前时间。

对于时间的具体格式没有定义，大多数系统遵循 POSIX 规范，返回 UNIX 时间戳（自 1970 年 1 月 1 日 00:00:00.000 UTC 以来的秒数）。

time_t 早期被实现为 32 位有符号整数，该实现将 2038 年 1 月 19 日星期二 03:14:07 UTC 失效。

!subtitle:参数

• arg - 返回当前时间，可以为 NULL

!subtitle:返回值

• 成功时返回当前时间

• 失败时返回 (time_t)(-1)

# 示例

#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t now = time(NULL); // 获取当前时间
    if (now != (time_t)(-1))
    {
        printf("当前时间是 %s\n", ctime(&now)); // 格式化
    }

    return 0;
}

运行结果：

当前时间是 Sun Oct 12 01:29:12 2025

# 推荐阅读

• time - cppreference

• time - POSIX

# 参考标准

• C23 standard (ISO/IEC 9899:2024):

  • 7.27.2.4 The time function (p: TBD)

• C17 standard (ISO/IEC 9899:2018):

  • 7.27.2.4 The time function (p: 286)

• C11 standard (ISO/IEC 9899:2011):

  • 7.27.2.4 The time function (p: 391)

• C99 standard (ISO/IEC 9899:1999):

  • 7.23.2.4 The time function (p: 341)

• C89/C90 standard (ISO/IEC 9899:1990):

  • 4.12.2.4 The time function