Provided by:
manpages-fr_1.67.0-1_all 
NOM
getdate, getdate_r - Conversion d’une chaîne de caractères en structure
tm.
SYNOPSIS
#define _XOPEN_SOURCE
#define _XOPEN_SOURCE_EXTENDED
#include <time.h>
struct tm *getdate (const char *string);
extern int getdate_err;
#define _GNU_SOURCE
#include <time.h>
int getdate_r (const char *string, struct tm *res);
DESCRIPTION
La fonction getdate() convertit une chaîne de caractères pointée par
string en une structure tm qu’elle renvoie. Cette structure tm est
susceptible d’être allouée de façon statique et d’être ainsi écrasée
lors du prochain appel.
Contrairement à strptime(3), ( qui a un argument format ), getdate()
utilise les formats présents dans le fichier dont le chemin d’accès
complet est donné par la variable d’environnement DATEMSK. La première
ligne du fichier qui peut être mise en correspondance avec la chaîne
passée en paramètre d’entrée est utilisée pour la conversion.
La correspondance n’est pas sensible à la casse. Les espaces
superflus, qu’ils soient dans le motif ou dans la chaîne à convertir,
sont ignorés.
Les paramètres de conversion qu’un motif peut contenir sont les mêmes
que pour strptime(3). Un indicateur de conversion supplémentaire est
accepté :
%Z Nom du fuseau horaire.
Lorsque %Z est spécifié, la valeur renvoyée est initialisée à l’heure
sous forme structure tm correspondant à l’heure courante sous le fuseau
horaire indiqué. Sinon, elle est initialisée à l’heure sous forme de
structure tm correspondant à l’heure locale actuelle.
Lorsque seul le jour de la semaine est donné, le jour pris en compte
sera le premier jour correspondant à partir d’aujourd’hui inclus.
Lorsque seul le mois est spécifié (et pas l’année), le mois pris en
compte est le premier mois correspondant à partir du mois courant
inclus. Si aucun jour n’est indiqué, le premier jour du mois est pris
par défaut.
Lorsque les heures, minutes et secondes ne sont pas indiquées, l’heure
courante (heures, minutes et secondes) est prise par défaut.
Si aucune date n’est indiquée, mais que l’on connaît l’heure, l’heure
prise en compte sera la première occurrence de l’heure correspondante à
partir de l’heure courante incluse.
VALEUR RENVOYÉE
En cas de succès, cette fonction renvoie un pointeur vers une structure
struct tm. sinon elle renvoie NULL et positionne la variable globale
getdate_err. La modification éventuelle de errno est indéfinie.
getdate_err peut prendre les valeurs suivantes :
1 La variable d’environnement DATEMSK vaut null ou n’est pas définie.
2 Le fichier patron (template) ne peut être ouvert pour être lu.
3 Impossible de lire l’état du fichier.
4 Le fichier patron n’est pas un fichier régulier.
5 Une erreur est survenue en cours de lecture du fichier patron.
6 Echec d’allocation mémoire (pas assez de mémoire disponible).
7 Il n’y a pas de ligne dans le fichier qui puisse être mise en
correspondance avec l’entrée.
8 Paramètres d’entrée invalides.
NOTES
Puisque getdate() n’est pas ré-entrante à cause de l’utilisation de
getdate_err et du tampon statique utilisé pour stocker le résultat
renvoyé, la glibc fournit une variante utilisable en contexte
multithread. La fonctionnalité est la même. Le résultat est renvoyé
dans le tampon pointé par res et, en cas d’erreur, le code de retour
est différent de zéro avec les mêmes valeurs que celles données
précédemment pour getdate_err.
La spécification POSIX 1003.1-2001 pour strptime() contient des
spécifications de conversion utilisant les modificateurs %E ou %O alors
que de tels modificateurs ne sont pas indiqués pour getdate().
L’implantation glibc de getdate() utilise strptime() si bien que les
deux fonctions supportent exactement les mêmes conversions
automatiquement.
L’implantation glibc ne supporte pas l’indicateur de conversion : %Z
ENVIRONNEMENT
DATEMSK
Fichier contenant les motifs de formatage.
TZ, LC_TIME
Variables utilisées par strptime().
CONFORMITÉ
ISO 9899, POSIX 1003.1-2001
VOIR AUSSI
localtime(3), strftime(3), strptime(3), time(3)
TRADUCTION
Stéphan Rafin, 2002.