std::tm

 

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>
struct tm;

Struktur, die ein Kalenderdatum und eine Kalenderzeit enthält, aufgeteilt in ihre Komponenten.

Member-Objekte

int tm_sec	Sekunden nach der Minute – [​0​, 61](bis C++11) [​0​, 60](seit C++11) (öffentliches Mitgliedsobjekt)
int tm_min	Minuten nach der Stunde – [​0​, 59] (öffentliches Mitgliedsobjekt)
int tm_hour	Stunden seit Mitternacht – [​0​, 23] (öffentliches Mitgliedsobjekt)
int tm_mday	Tag des Monats – [1, 31] (öffentliches Mitgliedsobjekt)
int tm_mon	Monate seit Januar – [​0​, 11] (öffentliches Mitgliedsobjekt)
int tm_year	Jahre seit 1900 (öffentliches Mitgliedsobjekt)
int tm_wday	Tage seit Sonntag – [​0​, 6] (öffentliches Mitgliedsobjekt)
int tm_yday	Tage seit dem 1. Januar – [​0​, 365] (öffentliches Mitgliedsobjekt)
int tm_isdst	Flag für Sommerzeit. Der Wert ist positiv, wenn DST aktiv ist, null, wenn nicht, und negativ, wenn keine Informationen verfügbar sind. (öffentliches Mitgliedsobjekt)

Anmerkungen

BSD, GNU und musl C-Bibliotheken unterstützen zwei zusätzliche Member, die in POSIX.1-2024 standardisiert sind.

long tm_gmtoff	Sekunden östlich von UTC (öffentliches Mitgliedsobjekt)
const char* tm_zone	Zeitzonenabkürzung (öffentliches Mitgliedsobjekt)

Beispiel

Führen Sie diesen Code aus

#include <ctime>
#include <iostream>
 
int main()
{
    std::tm tm{};
    tm.tm_year = 2022 - 1900;
    tm.tm_mday = 1;
    std::mktime(&tm);
 
    std::cout << std::asctime(&tm); // note implicit trailing '\n'
}

Mögliche Ausgabe

Sat Jan  1 00:00:00 2022

Siehe auch

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