ctime64_r, localtime64_r, gmtime64_rou asctime64_r Sous-routine

Objectif

Convertit les formats des représentations de date et d'heure.

Bibliothèque

Bibliothèque C à sécurité thread ( libc_r.a )

Syntaxe

#include <time.h>


char *ctime64_r(Timer, BufferPointer)
const time64_t * Timer;
char * BufferPointer;

struct tm *localtime64_r(Timer, CurrentTime)
const time64_t * Timer;
struct tm * CurrentTime;

struct tm *gmtime64_r (Timer, XTime)
const time64_t * Timer;
struct tm * XTime;

char *asctime64_r (TimePointer, BufferPointer)
const struct tm * TimePointer;
char * BufferPointer;

Descriptif

La sous-routine ctime64_r convertit une valeur d'heure indiquée par le paramètre Timer , qui représente l'heure en secondes depuis 00:00:00 UTC (Coordinated Universal Time), le 1er janvier 1970, en tableau de caractères indiqué par le paramètre BufferPointer . Le tableau de caractères doit avoir une longueur d'au moins 26 caractères pour que la valeur de temps convertie corresponde sans troncature. La chaîne de valeur de temps convertie prend la forme de l'exemple suivant:

Sun Sept 16 01:03:52 1973\n\0

La largeur de chaque champ est toujours la même que celle indiquée ici. Par conséquent, ctime ne renverra que les dates jusqu'au 31 décembre 9999.

La sous-routine ctime64_r s'ajuste au fuseau horaire et à l'heure d'été, si elle est activée.

La sous-routine localtime64_r convertit la structure time64_t pointée par le paramètre Timer , qui contient le temps en secondes depuis 00:00:00 UTC, 1er janvier 1970, en structure tm pointée par le paramètre CurrentTime . La sous-routine localtime64_r s'ajuste au fuseau horaire et à l'heure d'été, si elle est active.

La sous-routine gmtime64_r convertit la structure time64_t pointée par le paramètre Timer en structure tm pointée par le paramètre XTime .

La structure tm est définie dans le fichier d'en-tête time.h . Le fichier time.h contient les déclarations de ces sous-routines, des éléments externes et de la structure tm .

La sous-routine asctime64_r convertit la structure tm indiquée par le paramètre TimePointer en une chaîne de 26 caractères au même format que la sous-routine ctime64_r . Les résultats sont placés dans le tableau de caractères BufferPointer. Le paramètre BufferPointer pointe vers le tableau de caractères résultant, qui prend la forme de l'exemple suivant:

Sun Sept 16 01:03:52 1973\n\0

Les programmes qui utilisent cette sous-routine doivent être liés à la bibliothèque libpthreads.a .

Paramètres

Valeurs renvoyées

Les sous-routines localtime64_r et gmtime64_r renvoient un pointeur vers la structure tm . asctime64_r renvoie NULL si TimePointer ou BufferPointer est NULL.

Les sous-routines ctime64_r et asctime64_r renvoient un pointeur vers une chaîne de 26 caractères. La sous-routine ctime64_r renvoie NULL si BufferPointer est NULL.

La sous-routine difftime64 renvoie la différence exprimée en secondes sous la forme d'une valeur de type long double.

Fichiers