Spec-Zone.ru › C++

std::mktime

Определено в заголовке <ctime>
std::time_t mktime( std::tm* time );

Преобразует локальное время календаря в время с эпохи в виде объекта std::time_t. time->tm_wday и time->tm_yday игнорируются. Значения в time могут быть вне обычных диапазонов.

Отрицательное значение time->tm_isdst заставляет mktime пытаться определить, действовал ли летний пересчет времени.

Если преобразование успешно, объект time изменяется. Все поля time обновляются, чтобы соответствовать их допустимым диапазонам. time->tm_wday и time->tm_yday пересчитываются, используя информацию, доступную в других полях.

Параметры

time - указатель на объект std::tm, определяющий локальное время календаря для преобразования

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

Время с эпохи в виде объекта std::time_t при успешном выполнении или -1, если time не может быть представлен как объект std::time_t.

Примечания

Если объект std::tm был получен из std::get_time или POSIX strptime, значение tm_isdst неопределено и должно быть явно установлено перед вызовом mktime.

Пример

Явно создаём локальное время.

#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::tm local = *std::localtime(&t);
 
    std::cout << "local: " << std::put_time(&local, "%c %Z") << '\n';
}

Возможный вывод:

local: Sat Feb 15 10:15:00 2020 PST

См. также

localtime
преобразует время с эпохи в календарное время, выраженное как местное время
(функция)
C документация для mktime

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/chrono/c/mktime

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API