std::ctime

 

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

Konvertiert die gegebene Zeit seit der Epoche in eine lokale Kalenderzeit und dann in eine Textdarstellung, als ob std::asctime(std::localtime(time)) aufgerufen worden wäre. Der resultierende String hat das folgende Format:

Www Mmm dd hh:mm:ss yyyy\n

• Www - der Wochentag (einer von Mon, Tue, Wed, Thu, Fri, Sat, Sun).
• Mmm - der Monat (einer von Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec).
• dd - der Tag des Monats.
• hh - Stunden.
• mm - Minuten.
• ss - Sekunden.
• yyyy - Jahre.

Die Funktion unterstützt keine Lokalisierung.

Parameter

time

-

Zeiger auf ein std::time_t-Objekt, das die auszugebende Zeit angibt.

Rückgabewert

Zeiger auf einen statischen, nullterminierten Zeichenstring, der die Textdarstellung von Datum und Uhrzeit enthält. Der String kann zwischen std::asctime und std::ctime geteilt werden und kann bei jedem Aufruf einer dieser Funktionen überschrieben werden.

Anmerkungen

Diese Funktion gibt einen Zeiger auf statische Daten zurück und ist nicht threadsicher. Außerdem modifiziert sie das statische std::tm-Objekt, das mit std::gmtime und std::localtime geteilt werden kann. POSIX markiert diese Funktion als veraltet und empfiehlt stattdessen std::strftime.

Das Verhalten kann für Werte von std::time_t, die zu einem String mit mehr als 25 Zeichen führen (z. B. im Jahr 10000), undefiniert sein.

Beispiel

Führen Sie diesen Code aus

#include <cassert>
#include <cstring>
#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(nullptr);
    std::cout << std::ctime(&result);
 
    char buffer[32];
    std::strncpy(buffer, std::ctime(&result), 26);
    assert('\n' == buffer[std::strlen(buffer) - 1]);
    std::cout << buffer;
}

Mögliche Ausgabe

Mon Oct 11 17:10:55 2021
Mon Oct 11 17:10:55 2021

Siehe auch

asctime	konvertiert ein std::tm-Objekt in eine textuelle Darstellung (Funktion)
strftime	konvertiert ein std::tm-Objekt in eine benutzerdefinierte textuelle Darstellung (Funktion)
put_time (C++11)	Formatiert und gibt einen Datums-/Zeitwert gemäß dem angegebenen Format aus (Funktion-Template)
C-Dokumentation für ctime