std::localtime

std::tm* localtime( const std::time_t* time );

Преобразует заданное время с момента эпохи как std::time_t значение в календарное время, выраженное в местном времени.

Параметры

Возвращаемое значение

Указатель на статический внутренний std::tm объект при успешном выполнении или нулевой указатель в противном случае. Структура может быть общей для std::gmtime, std::localtime, и std::ctime, и может быть перезаписана при каждом вызове.

Примечания

Эта функция может быть небезопасной для многопоточного использования.

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-specific
 
    std::tm tm{}; // Zero initialise
    tm.tm_year = 2020 - 1900; // 2020
    tm.tm_mon = 2 - 1; // February
    tm.tm_mday = 15; // 15th
    tm.tm_hour = 10;
    tm.tm_min = 15;
    tm.tm_isdst = 0; // Not daylight saving
    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

См. также