std::asctime

 

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* asctime( const std::tm* time_ptr );

Wandelt die angegebene Kalenderzeit std::tm in eine Textdarstellung des folgenden festen 25-Zeichen-Formats um: Www Mmm dd hh:mm:ss yyyy\n.

• Www - dreibuchstabige englische Abkürzung des Wochentags aus time_ptr->tm_wday, einer von Mon, Tue, Wed, Thu, Fri, Sat, Sun.
• Mmm - dreibuchstabige englische Abkürzung des Monatsnamens aus time_ptr->tm_mon, einer von Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.
• dd - zweistelliger Tag des Monats aus timeptr->tm_mday, als ob er von sprintf mit %2d ausgegeben würde.
• hh - zweistellige Stunde aus timeptr->tm_hour, als ob sie von sprintf mit %.2d ausgegeben würde.
• mm - zweistellige Minute aus timeptr->tm_min, als ob sie von sprintf mit %.2d ausgegeben würde.
• ss - zweistellige Sekunde aus timeptr->tm_sec, als ob sie von sprintf mit %.2d ausgegeben würde.
• yyyy - vierstellige Jahreszahl aus timeptr->tm_year + 1900, als ob sie von sprintf mit %4d ausgegeben würde.

Das Verhalten ist undefiniert, wenn ein Element von *time_ptr außerhalb seines normalen Bereichs liegt.

Das Verhalten ist undefiniert, wenn das durch time_ptr->tm_year angegebene Kalenderjahr mehr als 4 Ziffern hat oder kleiner als das Jahr 1000 ist.

Die Funktion unterstützt keine Lokalisierung, und das Zeilenumbruchzeichen kann nicht entfernt werden.

Die Funktion modifiziert statischen Speicher und ist nicht threadsicher.

Parameter

time_ptr

-

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

Rückgabewert

Zeiger auf einen statischen, nullterminierten Zeichenstring, der die Textdarstellung des Datums und der Uhrzeit enthält. Der String kann zwischen std::asctime und std::ctime geteilt werden und kann bei jeder Ausführung einer dieser Funktionen überschrieben werden.

Hinweise

Diese Funktion gibt einen Zeiger auf statische Daten zurück und ist nicht threadsicher. POSIX stuft diese Funktion als veraltet ein und empfiehlt stattdessen die lokalitätsabhängige Funktion std::strftime. In std::locale("C") ist die Formatierungszeichenkette "%c\n" für std::strftime eine exakte Übereinstimmung mit der Ausgabe von std::asctime, während in anderen Lokalen die Formatierungszeichenkette "%a %b %e %H:%M:%S %Y\n" eine potenziell engere, aber nicht immer exakte Übereinstimmung darstellt.

POSIX schränkt undefinierte Verhaltensweisen nur auf Fälle ein, in denen der Ausgabestring länger als 25 Zeichen wäre, wenn timeptr->tm_wday oder timeptr->tm_mon außerhalb der erwarteten Bereiche liegen, oder wenn timeptr->tm_year INT_MAX-1990 überschreitet.

Einige Implementierungen behandeln timeptr->tm_mday == 0 als letzter Tag des Vormonats.

Beispiel

Führen Sie diesen Code aus

#include <ctime>
#include <iomanip>
#include <iostream>
 
int main()
{
    const std::time_t now = std::time(nullptr);
 
    for (const char* localeName : {"C", "en_US.utf8", "de_DE.utf8", "ja_JP.utf8"})
    {
        std::cout << "locale " << localeName << ":\n" << std::left;
        std::locale::global(std::locale(localeName));
 
        std::cout << std::setw(40) << "    asctime" << std::asctime(std::localtime(&now));
 
        // strftime output for comparison:
        char buf[64];
        if (strftime(buf, sizeof buf, "%c\n", std::localtime(&now)))
            std::cout << std::setw(40) << "    strftime %c" << buf;
 
        if (strftime(buf, sizeof buf, "%a %b %e %H:%M:%S %Y\n", std::localtime(&now)))
            std::cout << std::setw(40) << "    strftime %a %b %e %H:%M:%S %Y" << buf;
 
        std::cout << '\n';
    }
}

Mögliche Ausgabe

locale C:
    asctime                             Wed Nov  4 00:45:01 2020
    strftime %c                         Wed Nov  4 00:45:01 2020
    strftime %a %b %e %H:%M:%S %Y       Wed Nov  4 00:45:01 2020
 
locale en_US.utf8:
    asctime                             Wed Nov  4 00:45:01 2020
    strftime %c                         Wed 04 Nov 2020 12:45:01 AM UTC
    strftime %a %b %e %H:%M:%S %Y       Wed Nov  4 00:45:01 2020
 
locale de_DE.utf8:
    asctime                             Wed Nov  4 00:45:01 2020
    strftime %c                         Mi 04 Nov 2020 00:45:01 UTC
    strftime %a %b %e %H:%M:%S %Y       Mi Nov  4 00:45:01 2020
 
locale ja_JP.utf8:
    asctime                             Wed Nov  4 00:45:01 2020
    strftime %c                         2020年11月04日 00時45分01秒
    strftime %a %b %e %H:%M:%S %Y       水 11月  4 00:45:01 2020

Siehe auch

ctime	konvertiert ein std::time_t-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 asctime