Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
tzset, tzname, timezone, daylight - Initialiser des donnees pour les
conversions de temps
SYNOPSIS
#include <time.h>
void tzset (void);
extern char *tzname[2]
extern long timezone;
extern int daylight;
Exigences de macros de test de fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
tzset() : _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE
tzname : _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE
timezone : _SVID_SOURCE || _XOPEN_SOURCE
daylight : _SVID_SOURCE || _XOPEN_SOURCE
DESCRIPTION
La fonction tzset() initialise la variable tzname en utilisant la
variable d'environnement TZ. Cette fonction est appelee automatiquement
par les autres fonctions de conversion dependant du fuseau horaire.
Dans un environnement type System V, elle remplira egalement les
variables timezone (secondes a l'ouest de Greenwich) et daylight (a 0
si le fuseau n'a pas de changement d'heure saisonnier, ou a une valeur
non nulle s'il y a des periodes durant l'annee ou le changement horaire
s'applique).
Si la variable TZ n'apparait pas dans l'environnement, tzname est
initialisee avec la meilleure approximation possible de l'heure locale,
comme indique dans le fichier localtime, au format tzfile(5), se
trouvant dans le repertoire systeme des fuseaux horaires (voir plus
bas). (on utilise souvent /etc/localtime ici, en tant que lien
symbolique vers le repertoire systeme des fuseaux horaires).
Si la variable TZ est presente dans l'environnement, mais que sa valeur
est vide, ou si sa valeur ne peut pas etre interpretee en utilisant le
format indique plus bas, l'heure TU (temps universel, ou UTC) est
utilisee.
La valeur de TZ peut prendre trois formats differents. Le premier
correspond a un endroit ou il n'y a pas de decalage heure d'hiver/heure
d'ete :
std offset
la chaine std indique le nom du fuseau horaire, constitue d'au moins
trois caracteres alphabetiques. La chaine offset suivant immediatement
std indique la valeur a ajouter a l'heure locale pour obtenir l'heure
TU. La valeur offset est positive si l'emplacement est a l'ouest du
meridien 0, et negative si elle est a l'est. L'heure doit etre entre 0
et 24, les minutes et les secondes entre 0 et 59.
Le deuxieme format est utilise lorsqu'il existe des heures d'hiver et
d'ete differentes :
std offset dst [offset],start[/time],end[/time]
Les champs std et offset initiaux indiquent le fuseau horaire comme
precise ci-dessus. Les chaines dst et offset indiquent le fuseau et le
decalage de la zone correspondant a l'heure d'ete. Si l'offset est
omis, une valeur par defaut est utilisee, correspondant a une heure de
decalage vers l'avant.
Le champ start indique la date de debut de l'heure d'ete, et end
indique la date de retour a 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
fevrier n'est jamais compte, meme pendant les annees
bissextiles.
n Indique le jour julien, avec n compris entre 1 et 366. Le 29
fevrier est compte pendant les annees 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 premiere semaine du
mois dans laquelle le jour j apparait, et la semaine 5 la
derniere ou le jour j apparait. Le jour 0 est Dimanche.
Le champ time indique l'heure du changement, sous forme d'heure locale
courante. Par defaut, la valeur est 02h00m00s.
L'exemple suivant correspond a la Nouvelle-Zelande. Son fuseau horaire
(NZST) est 12 heures en avance sur le temps universel (UTC). L'heure
d'ete (NZDT) est 13 heures en avance sur UTC et debute le premier
dimanche d'octobre pour finir le troisieme dimanche de mars. Le
changement d'heure s'effectue a 02h00m00s.
TZ="NZST-12.00:00NZDT-13:00:00,M10.1.0,M3.3.0"
Le troisieme format est utilise pour indiquer que les informations de
fuseau horaire doivent etre lues depuis un fichier :
:[filespec]
Si le fichier filespec n'est pas indique, les informations sont lues
dans le fichier localtime se trouvant dans le repertoire systeme des
fuseaux horaires, habituellement /usr/share/zoneinfo. Ce fichier est au
format tzfile(5). Si filespec est indique, il doit correspondre a un
autre fichier au format tzfile(5) ou on lira les informations. Si
filespec ne commence pas par un << / >>, le chemin d'acces est
considere a partir du repertoire systeme des fuseaux horaires.
Voici un exemple, encore une fois pour la Nouvelle-Zelande :
TZ=":Pacific/Auckland"
FICHIERS
Le repertoire systeme employe pour les fuseaux horaires depend de la
version de la bibliotheque C. Les libc4 et libc5 utilisaient
/usr/lib/zoneinfo, puis, a partir de la libc-5.4.6 le repertoire
/usr/share/zoneinfo si le premier n'existait pas. La bibliotheque glibc
2 utilise le contenu de la variable d'environnement TZDIR lorsqu'elle
existe. Par defaut, c'est normalement /usr/share/zoneinfo.
Les fichiers se trouvant dans le repertoire sont :
localtime fichier d'information horaire locale
posixrules regles pour les TZ au format POSIX
Souvent, /etc/localtime est un lien symbolique vers localtime ou vers
le fichier correct dans le repertoire systeme des fuseaux horaires.
CONFORMIT'E
SVr4, POSIX.1-2001, BSD 4.3.
NOTES
Remarquez que la variable daylight n'indique pas si le changement
d'heure saisonnier s'applique au moment de l'appel. Elle indique
simplement le numero d'un algorithme (voyez la variable tz_dsttime dans
gettimeofday(2)). C'est obsolete depuis longtemps, mais obligatoire
avec SUSv2.
BSD 4.3 a une routine char *timezone(zone, dst) qui renvoie le nom du
fuseau horaire correspondant a son premier argument (minutes a l'ouest
de Greenwich). Si le second argument est 0, le nom standard est fourni,
sinon c'est le nom avec changement horaire saisonnier.
VOIR AUSSI
date(1), gettimeofday(2), time(2), ctime(3), getenv(3), tzfile(5)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Nicolas
Francois et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
25 fevrier 2010 TZSET(3)