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
См. также
|
(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