Namespaces
Variants

std:: time

From cppreference.net
< cpp ‎ | chrono ‎ | c
定义于头文件 <ctime>

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

目录

参数

arg - 指向 std::time_t 对象的指针,用于存储时间值;或为空指针

返回值

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

注释

std::time_t 中日历时间的编码方式未作规定,但大多数系统遵循 POSIX 规范 ,返回一个整型值,该值保存自 纪元 以来的日历天数乘以 86400 加上自上次 UTC 午夜以来经过的秒数。最值得注意的是,POSIX 时间不会(且无法)考虑闰秒,因此该整数值不等于自纪元以来经过的 S.I. 秒 数,而是减去自纪元以来发生的闰秒数。在 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

参见

基于给定时间基准返回以秒和纳秒表示的日历时间
(函数)
将纪元起计时转换为本地时间表示的日历时间
(函数)
将纪元起计时转换为协调世界时表示的日历时间
(函数)
来自系统全局实时时钟的挂钟时间
(类)
C 文档 关于 time