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

См. также

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

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

Spec-Zone.ru

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