Standardbibliothek Header <time.h>

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Standard Library-Header

<assert.h> <complex.h> (C99) <ctype.h> <errno.h> <fenv.h> (C99) <float.h> <inttypes.h> (C99)     <iso646.h> (C95) <limits.h> <locale.h> <math.h>

<setjmp.h> <signal.h> <stdalign.h> (C11*) <stdarg.h> <stdatomic.h> (C11)     <stdbit.h> (C23) <stdbool.h> (C99*) <stdckdint.h> (C23) <stddef.h> <stdint.h> (C99) <stdio.h>

<stdlib.h> <stdmchar.h> (C29) <stdnoreturn.h> (C11*) <string.h> <tgmath.h> (C99) <threads.h> (C11) <time.h> <uchar.h> (C11) <wchar.h> (C95) <wctype.h> (C95)

 

Dieser Header ist Teil der Datum- und Zeit-Dienstprogramme Bibliothek.

Funktionen

Zeitmanipulation
difftime	berechnet die Differenz zwischen Zeiten (Funktion)
time	gibt die aktuelle Kalenderzeit des Systems als Zeit seit der Epoche zurück (Funktion)
clock	gibt die Prozessorzeit seit dem Start des Programms zurück (Funktion)
timespec_get (C11)	gibt die Kalenderzeit in Sekunden und Nanosekunden basierend auf einer gegebenen Zeitbasis zurück (Funktion)
timespec_getres (C23)	gibt die Auflösung der Kalenderzeit basierend auf einer gegebenen Zeitbasis zurück (Funktion)
Formatkonvertierungen
asctimeasctime_s (in C23 veraltet)(C11)	konvertiert ein tm-Objekt in eine Textdarstellung (Funktion)
ctimectime_s (in C23 veraltet)(C11)	konvertiert ein time_t-Objekt in eine Textdarstellung (Funktion)
strftime	konvertiert ein tm-Objekt in eine benutzerdefinierte Textdarstellung (Funktion)
gmtimegmtime_rgmtime_s (C23)(C11)	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als koordinierte Weltzeit (UTC) (Funktion)
localtimelocaltime_rlocaltime_s (C23)(C11)	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als lokale Zeit (Funktion)
mktime	konvertiert Kalenderzeit in Zeit seit Epoche (Funktion)

Konstanten

CLOCKS_PER_SEC

Anzahl der Prozessor-Taktzyklen pro Sekunde (Makrokonstante)

Typen

tm	Typ für Kalenderzeit (Struktur)
time_t	Kalenderzeit seit Epoche Typ (Typedef)
clock_t	Typ für Prozessorzeit seit Epoche (typedef)
timespec (C11)	Zeit in Sekunden und Nanosekunden (Struktur)

Synopsis

#define __STDC_VERSION_TIME_H__ 202311L
 
#define NULL           /* see description */
#define CLOCKS_PER_SEC /* see description */
#define TIME_UTC       /* see description */
 
typedef /* see description */ clock_t;
typedef /* see description */ size_t;
typedef /* see description */ time_t;
 
struct timespec { /* see description */ };
struct tm { /* see description */ };
 
clock_t clock(void);
double difftime(time_t time1, time_t time0);
time_t mktime(struct tm* timeptr);
time_t timegm(struct tm* timeptr);
time_t time(time_t* timer);
int timespec_get(struct timespec* ts, int base);
int timespec_getres(struct timespec* ts, int base);
[[deprecated]] char* asctime(const struct tm* timeptr);
[[deprecated]] char* ctime(const time_t* timer);
struct tm* gmtime(const time_t* timer);
struct tm* gmtime_r(const time_t* timer, struct tm* buf);
struct tm* localtime(const time_t* timer);
struct tm* localtime_r(const time_t* timer, struct tm* buf);
size_t strftime(char* restrict s, size_t maxsize, const char* restrict format,
const struct tm* restrict timeptr);

Nur wenn von der Implementierung unterstützt

#define TIME_MONOTONIC /* see description */
#define TIME_ACTIVE    /* see description */

Nur wenn Threads unterstützt werden und dies von der Implementierung unterstützt wird

#define TIME_THREAD_ACTIVE /* see description */

Nur wenn die Implementierung __STDC_LIB_EXT1__ definiert und zusätzlich der Benutzercode __STDC_WANT_LIB_EXT1__ definiert, bevor irgendwelche Inklusionen von <time.h> erfolgen

#ifdef __STDC_WANT_LIB_EXT1__
typedef /* see description */ errno_t;
typedef /* see description */ rsize_t;
 
errno_t asctime_s(char* s, rsize_t maxsize, const struct tm* timeptr);
errno_t ctime_s(char* s, rsize_t maxsize, const time_t* timer);
struct tm* gmtime_s(const time_t* restrict timer, struct tm* restrict result);
struct tm* localtime_s(const time_t* restrict timer, struct tm* restrict result);
#endif