std::mktime

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Datums- und Zeitbibliothek

Zeitpunkt time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) Dauer duration (C++11) Uhren system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) Tageszeit is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

Kalender day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono E/A parse (C++20)

Zeitzone tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C-Stil Datums- und Zeitfunktionen

 

C-Stil Datums- und Zeitwerkzeuge

Funktionen

Zeitmanipulation

difftime

time

clock

timespec_get (C++17)

Formatkonvertierungen

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

Konstanten

CLOCKS_PER_SEC

Typen

tm

time_t

clock_t

timespec (C++17)

 

Definiert im Header <ctime>
std::time_t mktime( std::tm* time );

Konvertiert lokale Kalenderzeit in eine Zeit seit Epoche als std::time_t-Objekt. time->tm_wday und time->tm_yday werden ignoriert. Die Werte in time dürfen außerhalb ihrer normalen Bereiche liegen.

Ein negativer Wert von time->tm_isdst veranlasst mktime zu versuchen zu bestimmen, ob die Sommerzeit aktiv war.

Wenn die Konvertierung erfolgreich ist, wird das time-Objekt modifiziert. Alle Felder von time werden aktualisiert, um in ihre korrekten Bereiche zu passen. time->tm_wday und time->tm_yday werden neu berechnet, indem Informationen aus anderen Feldern verwendet werden.

Parameter

time

-

Zeiger auf ein std::tm-Objekt, das die zu konvertierende lokale Kalenderzeit angibt

Rückgabewert

Zeit seit Epoche als std::time_t-Objekt bei Erfolg oder -1, wenn time nicht als std::time_t-Objekt dargestellt werden kann.

Hinweise

Wenn das std::tm-Objekt von std::get_time oder dem POSIX strptime erhalten wurde, ist der Wert von tm_isdst unbestimmt und muss vor dem Aufruf von mktime explizit gesetzt werden.

Beispiel

Lokale Zeit explizit erstellen.

Führen Sie diesen Code aus

#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';
}

Mögliche Ausgabe

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

Siehe auch

localtime	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als lokale Zeit (Funktion)
C-Dokumentation für mktime