std::localtime

来自cppreference.com
< cpp‎ | chrono‎ | c
 
C++
 
日期和时间库
时间点
(C++11)
(C++20)  
(C++20)
时长
(C++11)
时钟
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(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++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
chrono I/O
(C++20)

 
C 风格日期和时间工具
函数
时间操作
(C++17)
格式转换
localtime
常量
类型
(C++17)
 
在标头 <ctime> 定义
std::tm* localtime( const std::time_t* time );

转换作为 std::time_t 值的从纪元起时间到以本地时间表达的日历时。

目录

[编辑] 参数

time - 指向要转换的 time_t 对象的指针

[编辑] 返回值

成功时为指向内部静态 std::tm 对象的指针，否则为 NULL。该结构体可能在 std::gmtime、std::localtime 和 std::ctime 之间共享，而且可能在每次调用时被覆盖。

[编辑] 注解

此函数可能不是线程安全的。函数 localtime 可以不是线程安全的。Microsoft CRT 的实现是线程安全的。

POSIX 要求若此函数因实参过大而失败，则设置 errno 为 EOVERFLOW。

POSIX 指定此函数如同以调用 tzset 确定时区信息，该函数调用环境变量 TZ。

[编辑] 示例

运行此代码
#include <ctime>
#include <iomanip>
#include <iostream>
#include <sstream>
 
int main()
{
    setenv("TZ", "/usr/share/zoneinfo/America/Los_Angeles", 1); // POSIX 专有
 
    std::tm tm{}; // 零初始化
    tm.tm_year = 2020 - 1900; // 2020
    tm.tm_mon = 2 - 1; // 二月
    tm.tm_mday = 15; // 15日
    tm.tm_hour = 10;
    tm.tm_min = 15;
    tm.tm_isdst = 0; // 无夏令时
    std::time_t t = std::mktime(&tm); 
 
    std::cout << "UTC:   " << std::put_time(std::gmtime(&t), "%c %Z") << '\n';
    std::cout << "local: " << std::put_time(std::localtime(&t), "%c %Z") << '\n';
}

可能的输出： 

UTC:   Sat Feb 15 18:15:00 2020 GMT
local: Sat Feb 15 10:15:00 2020 PST

[编辑] 参阅

 转换纪元起时间为以协调世界时表示的日历时间
(函数) [编辑]
(C23)(C11)
 将从纪元开始的时间转换成以本地时间表示的日历时间
(函数) [编辑]
localtime 的 C 文档
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/chrono/c/localtime&oldid=101084”