std::localtime

 

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::tm* localtime( const std::time_t* time );

Konvertiert die gegebene Zeit seit Epoche als std::time_t-Wert in Kalenderzeit, ausgedrückt in lokaler Zeit.

Parameter

time

-

Zeiger auf ein std::time_t-Objekt zur Konvertierung

Rückgabewert

Zeiger auf ein statisches internes std::tm-Objekt bei Erfolg oder Nullzeiger bei Misserfolg. Die Struktur kann zwischen std::gmtime, std::localtime und std::ctime geteilt werden und kann bei jedem Aufruf überschrieben werden.

Hinweise

Diese Funktion ist möglicherweise nicht threadsicher.

POSIX schreibt vor, dass diese Funktion errno auf EOVERFLOW setzt, wenn sie fehlschlägt, weil das Argument zu groß ist.

POSIX spezifiziert, dass die Zeitzoneninformationen von dieser Funktion wie durch Aufruf von tzset ermittelt werden, die die Umgebungsvariable TZ liest.

Beispiel

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

Mögliche Ausgabe

UTC:   Sat Feb 15 18:15:00 2020 GMT
local: Sat Feb 15 10:15:00 2020 PST

Siehe auch

gmtime	Konvertiert die seit der Epoche vergangene Zeit in eine Kalenderzeit, ausgedrückt als Universal Coordinated Time. (Funktion)
localtimelocaltime_rlocaltime_s (C23)(C11)	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als lokale Zeit (Funktion)
C-Dokumentation für localtime