.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992 .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified by Michael Haardt .\" Modified Sat Jul 24 14:13:40 1993 by Rik Faith .\" Additions by Joseph S. Myers , 970909 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH TIME 2 "15. September 2017" Linux Linux\-Programmierhandbuch .SH BEZEICHNUNG time \- Zeit in Sekunden abfragen .SH ÜBERSICHT \fB#include \fP .PP \fBtime_t time(time_t *\fP\fItloc\fP\fB);\fP .SH BESCHREIBUNG \fBtime\fP() gibt die Zeit als Anzahl der Sekunden seit dem Beginn der Unixzeit am 1.1.1970, 00:00:00 +0000 (UTC) an. .PP Falls \fItloc\fP nicht NULL ist, wird der Rückgabewert auch im Speicher an der Stelle abgelegt, auf die \fItloc\fP zeigt. .SH RÜCKGABEWERT Bei Erfolg wird die Zeit seit Beginn der Unixzeit in Sekunden zurückgegeben. Tritt ein Fehler auf, wird \fI((time_t)\ \-1)\fP zurückgegeben und \fIerrno\fP entsprechend gesetzt. .SH FEHLER .TP \fBEFAULT\fP \fItloc\fP zeigt außerhalb Ihres verfügbaren Adressbereichs (siehe aber auch FEHLER). .IP Auf Systemen, auf denen die C\-Bibliothek\-\fBtime\fP()\-Wrapper\-Funktion eine von \fBvdso\fP(7) bereitgestellte Implementierung aufruft (so dass es keine Verbindung in den Kernel gibt), kann eine ungültige Adresse stattdessen ein \fBSIGSEGV\fP\-Signal auslösen. .SH "KONFORM ZU" .\" Under 4.3BSD, this call is obsoleted by .\" .BR gettimeofday (2). SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. POSIX legt keine Fehlerbedingungen fest. .SH ANMERKUNGEN POSIX.1 definiert die \fISekunden seit Anfang der Unixzeit\fP mittels einer Formel, die die Anzahl der Sekunden zwischen einem bestimmten Zeitpunkt und dem Anfang der »Unixzeit« abschätzt. Diese Formel berücksichtigt die Tatsache, dass alle durch vier ohne Rest teilbaren Jahre Schaltjahre sind. Alle durch 100 ohne Rest teilbaren Jahre sind keine Schaltjahre, es sei denn, sie sind gleichzeitig durch 400 ohne Rest teilbar, dann sind es wiederum Schaltjahre. Dieser Wert entspricht nicht der tatsächlichen Anzahl an Sekunden zwischen dem angegebenen Zeitpunkt und dem Anfang der »Unixzeit«, weil Schaltsekunden nicht berücksichtigt werden und es nicht erforderlich ist, dass Systemuhren mit einer Standardreferenz synchronisiert werden. Das Ziel dieser Festlegung ist eine konsistente Interpretation des Sekundenwertes seit Anfang der »Unixzeit«. Siehe auch POSIX.1\-2008 Rationale A.4.15 für weitere Erläuterungen. .PP Unter Linux kann ein Aufruf von \fBtime\fP() nicht mit dem Fehler \fBEOVERFLOW\fP fehlschlagen, wenn \fItloc\fP als NULL angegeben wurde, auch nicht auf ABIs, bei denen \fItime_t\fP eine vorzeichenbehaftete 32\-Bit\-Ganzzahl ist und die Zeiteinheiten nach dem Zeitpunkt 2**31 liegen (2038\-01\-19 03:14:08 UTC, Schaltsekunden werden ignoriert). (POSIX.1 erlaubt den Fehler \fBEOVERFLOW\fP im Fall, dass die Sekunden seit der Unixzeit nicht in \fItime_t\fP passen, erfordert ihn jedoch nicht.) Stattdessen ist das Verhalten unter Linux nicht definiert, wenn die Systemzeit außerhalt des Bereichs von \fItime_t\fP liegt. Anwendungen, die nach 2038 noch laufen sollen, sollten ABIs verwenden, bei denen \fItime_t\fP größer als 32 Bit ist. .SH FEHLER Fehler, die von diesem Systemaufruf zurückgegeben werden, sind nicht von erfolgreichen Berichten, dass die Zeit ein paar Sekunden \fIvor\fP der Unixzeit liegt, zu unterscheiden. Daher kann die C\-Bibliothek\-Wrapper\-Funktion \fIerrno\fP nie als Ergebnis dieses Aufrufs setzen. .PP .\" Das Argument \fItloc\fP ist veraltet und sollte in neuem Code immer NULL sein. Wenn \fItloc\fP NULL ist, kann der Aufruf nicht fehlschlagen. .SS "Unterschiede C\-Bibliothek/Kernel" Auf einigen Architekturen wird eine Implementierung von \fBtime\fP() in einem \fBvdso\fP(7) bereitgestellt. .SH "SIEHE AUCH" \fBdate\fP(1), \fBgettimeofday\fP(2), \fBctime\fP(3), \fBftime\fP(3), \fBtime\fP(7), \fBvdso\fP(7) .SH KOLOPHON Diese Seite ist Teil der Veröffentlichung 4.16 des Projekts Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man\-pages/. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Michael Haardt , Ralf Demmer , Chris Leick und Helge Kreutzmann erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an .