ctime_s, wctime_s

Nach oben zu Time.h - Index

Header-Datei

time.h

Kategorie

Uhrzeit- und Datumsroutinen

Prototyp

errno_t ctime_s(char *s, rsize_t maxsize, const time_t *timer);

errno_t wctime_s(wchar_t *s, rsize_t maxsize, const time_t *timer);

Beschreibung

Ersetzt ctime, _wctime und fügt Sicherheitserweiterungen hinzu.

Konvertiert Datum und Zeit in einen String.

ctime_s konvertiert den Kalenderwert, auf den timer zeigt (der von der Funktion time zurückgegebene Wert), in einen 26 Zeichen langen, durch ein Zeilenwechsel- und ein Null-Zeichen abgeschlossenen String der folgenden Form:

Mon Nov 21 11:31:54 1983\n\0

ctime_s ist folgendermaßen äquivalent zu asctime_s, wasctime_s:

asctime_s(s, maxsize, localtime_s(timer));

Alle Felder haben eine konstante Breite.

Die globale Variable _timezone des Typs long enthält die Differenz zwischen GMT und der lokalen Standardzeit (in PST ist _timezone 8*60*60). Die globale Variable _daylight legt fest, ob die Laufzeitfunktionen (mktime und localtime) die Sommerzeit berücksichtigen müssen, wenn sie einen Datumswert bearbeiten, der normalerweise von dieser Einstellung betroffen ist. Hat diese Variable den Wert 1, muss die Sommerzeit berücksichtigt werden. Diese Variablen werden von der Funktion tzset gesetzt, nicht von einer Anwendung.

Rückgabewert

ctime_s gibt bei Erfolg Null, ansonsten Nicht-Null zurück.

Beispiel

#include <stdio.h> 
#include <time.h> 
int main(void) 
{ 
  struct tm t; 
  unsigned int size = 26; 
  char str[80]; 
  time_t localtime; 
  time(&localtime); 
  ctime_s(str, size, &localtime); 
  printf("%s\n", str); 
  return 0; 
}

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
ctime_s	+	+	+	+
wctime_s		+

Siehe auch

• Sichere C-Bibliothek