localtime_s

Nach oben zu time.h - Index

Header-Datei

time.h

Kategorie

Uhrzeit- und Datumsroutinen

Prototyp

struct tm *localtime_s(const time_t * _RESTRICT clock, struct tm * _RESTRICT result);

Beschreibung

Konvertiert Datum und Zeit in eine Struktur.

localtime_s akzeptiert die Adresse eines von time zurückgegebenen Werts und gibt einen Zeiger auf die Struktur des Typs tm zurück, die Zeitelemente enthält. Die Funktion berücksichtigt die Zeitzone und gegebenenfalls die Sommerzeit.

Einzelheiten zur tm-Struktur finden Sie unter localtime.

Rückgabewert

localtime_s gibt bei Erfolg result, ansonsten Null zurück.

Beispiel

#include <time.h> 
#include <stdio.h> 
int main(void) 
{ 
   time_t timer; 
   struct tm tblock; 
   /* gets time of day */ 
   timer = time(NULL); 
   /* converts date/time to a structure */ 
   localtime_s(&timer, &tblock); 
   printf("Local time is: %s", asctime(&tblock)); 
   return 0;
}

Portabilität

POSIX	Win32	ANSI C	ANSI C++
+	+	+	+