ctime_s, wctime_s
Remonter à Time.h - Index
Fichier en-tête
time.h
Catégorie
Routines date et heure
Prototype
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);
Description
Remplace ctime, _wctime en ajoutant des améliorations relatives à la sécurité.
Convertit une date et heure en une chaîne.
ctime_s convertit la valeur du calendrier pointée par timer (la valeur renvoyée par la fonction time) en une chaîne de 26 caractères au format suivant, se terminant par un caractère nouvelle ligne et un caractère null :
Lun Nov 21 11:31:54 1983\n\0
ctime_s est équivalente à asctime_s, wasctime_s comme suit :
asctime_s(s, maxsize, localtime_s(timer));
Tous les champs ont une largeur constante.
La variable longue globale _timezone contient la différence en secondes entre GMT et l'heure standard locale (dans PST, _timezone vaut 8*60*60). La variable globale _daylight est utilisée pour indiquer aux fonctions RTL (mktime et localtime) si elles doivent prendre en compte l'heure d'été si une date qui devrait normalement tombé dans cette catégorie est rencontrée. Elle est définie sur 1 si la conversion de l'heure d'été doit être appliquée. Ces variables sont définies par la fonction tzset, et non directement par le programme utilisateur.
Valeur renvoyée
ctime_s renvoie zéro en cas de succès. Sinon, une valeur différente de zéro est renvoyée.
Exemple
#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é
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
ctime_s |
+ |
+ |
+ |
+ |
wctime_s |
+ |