TZSET(3) Manuel du programmeur Linux TZSET(3)
NOM
tzset - Initialisation des données pour les conversions de
temps.
SYNOPSIS
#include <time.h>
void tzset (void);
extern char *tzname[2]
DESCRIPTION
La fonction tzset() initialise la variable tzname en util
isant la variable d'environnement TZ. Cette fonction est
appelée automatiquement par les autres fonctions de con
version dépendant du fuseau horaire.
Si la variable TZ n'apparaît pas dans l'environnement,
tzname est initialisée avec la meilleure approximation
possible de l'heure locale, comme indiqué dans le fichier,
au format tzfile(5), /usr/lib/zoneinfo/localtime.
Si la variable TZ est présente dans l'environnement, mais
que sa valeur est `NULL', ou si sa valeur ne peut pas être
interprétée en utilisant le format indiqué plus bas,
l'heure TU (temps universel) est utilisée.
La valeur de TZ peut prendre trois formats différents. Le
premier correspond à un endroit où il n'y a pas de
décalage heure d'hiver/heure d'été :
std offset
la chaîne std indique le nom du fuseau horaire, constitué
d'au moins trois caractères alphabétiques. La chaîne off
set suivant immédiatement std indique la valeur à ajouter
à l'heure locale pour obtenir l'heure TU. La valeur offset
est positive si l'emplacement est à l'Ouest du méridien 0,
et négative si elle est à l'Est. L'heure doit être entre
0 et 24, les minutes et les secondes entre 0 et 59.
Le deuxième format est utilisé lorsqu'il existe une heure
d'hiver et une heure d'été différentes :
std offset dst [offset],start[/time],end[/time]
Les champs std et offset initiaux indiquent le fuseau
horaire comme précisé ci-dessus. Les chaines dst et off
set indiquent le fuseau et le décalage de la zone corre
spondant à l'heure d'été. Si l'offset est omis, une valeur
par défaut est utilisée, correspondant à une heure de
décalage vers l'avant.
Le champ start indique la date de début de l'heure d'été,
BSD 11 Decembre 1996 1
TZSET(3) Manuel du programmeur Linux TZSET(3)
et end indique la date de retour à l'heure d'hiver. Ces
deux champs utilisent l'un des formats suivants :
Jn Indique le jour Julien, avec n compris entre 1 et
365. Le 29 Février n'est jamais compté, même pen
dant les années bissextiles.
n Indique le jour Julien, avec n compris entre 1 et
366. Le 29 Février est compté pendant les années
bissextiles.
Mm.s.j Indique le jour j (0 <= j <= 6) de la semaine s (1
<= s <= 5) du mois m (1 <= m <= 12). La semaine 1
est la première semaine du mois dans laquelle le
jour j apparaît et la semaine 5 est la dernière
durant laquelle le jour j apparaît. Le jour 0 est
le Dimanche.
Le champ time indique l'heure du changement, sous forme
d'heure locale courante. Par défaut, la valeur est
02:00:00.
Le troisième format est utilisé pour indiquer que les
informations de fuseau horaire doivent être lues depuis un
fichier :
:[filespec]
Si le fichier filespec n'est pas indiqué, les informations
sont lues depuis /usr/lib/zoneinfo/localtime au format
tzfile(5). Si filespec est indique, il doit correspondre
à un autre fichier d'information au format tzfile(5). Si
filespec ne commence pas par un `/', le chemin d'accès est
considéré à partir du répertoire /usr/lib/zoneinfo.
FICHIERS
/usr/lib/zoneinfo répertoire d'information horaire du système
/usr/lib/zoneinfo/localtime fichier d'information horaire locale
/usr/lib/zoneinfo/posixrules règles pour les TZ au format POSIX
CONFORMITÉ
SVID 3, POSIX, BSD 4.3
VOIR AUSSI
date(1), gettimeofday(2), time(2), ctime(3), getenv(3),
tzfile(5)
TRADUCTION
Christophe Blaess, 1997.
BSD 11 Decembre 1996 2