std:: time
|
Definiert im Header
<ctime>
|
||
|
std::
time_t
time
(
std::
time_t
*
arg
)
;
|
||
Gibt die aktuelle Kalenderzeit kodiert als ein std::time_t Objekt zurück und speichert sie ebenfalls in dem Objekt, auf das arg zeigt, es sei denn, arg ist ein Nullzeiger.
Inhaltsverzeichnis |
Parameter
| arg | - | Zeiger auf ein std::time_t Objekt zum Speichern der Zeit, oder ein Nullzeiger |
Rückgabewert
Aktuelle Kalenderzeit kodiert als std::time_t Objekt bei Erfolg, ( std:: time_t ) ( - 1 ) bei Fehler. Falls arg nicht null ist, wird der Rückgabewert auch in dem Objekt gespeichert, auf das arg zeigt.
Hinweise
Die Kodierung der Kalenderzeit in std::time_t ist nicht spezifiziert, aber die meisten Systeme entsprechen der POSIX-Spezifikation und geben einen Wert eines integralen Typs zurück, der das 86400-fache der Anzahl der Kalendertage seit der Epoche plus der Anzahl der seit dem letzten Mitternacht UTC vergangenen Sekunden enthält. Besonders hervorzuheben ist, dass die POSIX-Zeit keine (und kann keine) Schaltsekunden berücksichtigt, sodass dieser integrale Wert nicht der Anzahl der S.I.-Sekunden entspricht, die seit der Epoche vergangen sind, sondern vielmehr um die Anzahl der seit der Epoche aufgetretenen Schaltsekunden reduziert wird. Implementierungen, in denen std::time_t ein 32-Bit vorzeichenbehafteter Integer ist (viele historische Implementierungen), versagen im Jahr 2038 .
Beispiel
#include <ctime> #include <iostream> int main() { std::time_t result = std::time(nullptr); std::cout << std::asctime(std::localtime(&result)) << result << " seconds since the Epoch\n"; }
Mögliche Ausgabe:
Wed Sep 21 10:27:52 2011 1316615272 seconds since the Epoch
Siehe auch
|
(C++17)
|
gibt die Kalenderzeit in Sekunden und Nanosekunden basierend auf einer gegebenen Zeitbasis zurück
(Funktion) |
|
wandelt die Zeit seit Epoche in Kalenderzeit ausgedrückt als Ortszeit um
(Funktion) |
|
|
wandelt die Zeit seit Epoche in Kalenderzeit ausgedrückt als Koordinierte Weltzeit um
(Funktion) |
|
|
(C++11)
|
Echtzeituhr des Systems
(Klasse) |
|
C-Dokumentation
für
time
|
|