std::time

< cpp‎ | chrono‎ | c
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
日期和时间工具
(C++11)
(C++11)
当天时刻
(C++20)



(C++20)(C++20)(C++20)(C++20)
时钟
(C++20)
                                             
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
时区
(C++20)
(C++20)
(C++20)
(C++20)
C 风格日期和时间
 
 
定义于头文件 <ctime>
std::time_t time( std::time_t* arg );

返回编码为 std::time_t 对象的当前日历时间,并将它存储于 arg 所指向的对象,除非 arg 是空指针。

参数

arg - 指向要存储时间的 std::time_t 对象的指针,或空指针

返回值

成功时为编码为 std::time_t 的当前日历时间,错误时为 (std::time_t)(-1) 。若 arg 非空,则亦存储返回值于 arg 所指向的对象。

注意

日历时间在 std::time_t 中的编码是未指定的,但多数系统遵循 POSIX 规定,返回保有从纪元开始至今秒数的整数类型值。 std::time_t 为32位有符号整数的实现(许多历史上的实现)会在 2038 年出错。

示例

#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(nullptr);
    std::cout << std::asctime(std::localtime(&result))
              << result << " seconds since the Epoch\n";
}

输出:

Wed Sep 21 10:27:52 2011
1316615272 seconds since the Epoch

参阅

转换纪元起时间为以本地时间表示的日历时间
(函数)
转换纪元起时间为以协调世界时表示的日历时间
(函数)
来自系统范畴实时时钟的挂钟时间
(类)