#C 语言标准库函数 time

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

说明

获取当前时间。

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

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

参数

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

返回值

• 成功时返回当前时间
• 失败时返回 (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