Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       tzset, tzname, timezone, daylight - Initialiser des données 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   fonctionnalités   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  appelée  automatiquement par les autres fonctions de conversion
       dépendant du fuseau horaire. Dans un environnement type System V, elle remplira  également
       les variables timezone (secondes à l'ouest de Greenwich) et daylight (à 0 si le fuseau n'a
       pas de changement d'heure saisonnier, ou à une valeur non nulle  s'il  y  a  des  périodes
       durant l'année où le changement horaire s'applique).

       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
       localtime,  au  format  tzfile(5),  se  trouvant  dans  le  répertoire système des fuseaux
       horaires (voir plus bas). (on  utilise  souvent  /etc/localtime  ici,  en  tant  que  lien
       symbolique vers le répertoire système des fuseaux horaires).

       Si la variable TZ est présente dans l'environnement, mais que sa valeur est vide, ou si sa
       valeur ne peut pas être interprétée en utilisant le format indiqué plus  bas,  l'heure  TU
       (temps universel, ou UTC) 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  offset 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 des heures d'hiver et 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
       chaînes  dst  et  offset  indiquent  le  fuseau  et le décalage de la zone correspondant à
       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é, 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 pendant 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 la dernière où le jour j apparaît. Le jour 0 est Dimanche.

       Le champ time indique l'heure du changement,  sous  forme  d'heure  locale  courante.  Par
       défaut, la valeur est 02h00m00s.

       L'exemple  suivant  correspond  à  la  Nouvelle-Zélande.  Son  fuseau  horaire  (NZST) est
       12 heures en avance sur le temps universel (UTC). L'heure d'été (NZDT)  est  13 heures  en
       avance sur UTC et débute le premier dimanche d'octobre pour finir le troisième dimanche de
       mars. Le changement d'heure s'effectue à 02h00m00s.

           TZ="NZST-12.00:00NZDT-13:00:00,M10.1.0,M3.3.0"

       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 dans le fichier
       localtime se trouvant dans le répertoire  système  des  fuseaux  horaires,  habituellement
       /usr/share/zoneinfo.  Ce fichier est au format tzfile(5). Si filespec est indique, il doit
       correspondre à un autre fichier au format  tzfile(5)  où  on  lira  les  informations.  Si
       filespec  ne  commence  pas  par  un  « / »,  le  chemin d'accès est considéré à partir du
       répertoire système des fuseaux horaires.

       Voici un exemple, encore une fois pour la Nouvelle-Zélande :

           TZ=":Pacific/Auckland"

FICHIERS

       Le répertoire système employé pour les  fuseaux  horaires  dépend  de  la  version  de  la
       bibliothèque  C.  Les  libc4  et libc5 utilisaient /usr/lib/zoneinfo, puis, à partir de la
       libc-5.4.6 le répertoire /usr/share/zoneinfo si le premier n'existait pas. La bibliothèque
       glibc  2  utilise  le contenu de la variable d'environnement TZDIR lorsqu'elle existe. Par
       défaut, c'est normalement /usr/share/zoneinfo.

       Les fichiers se trouvant dans le répertoire sont :
       localtime      fichier d'information horaire locale
       posixrules     règles pour les TZ au format POSIX

       Souvent, /etc/localtime est un lien symbolique vers localtime ou vers le  fichier  correct
       dans le répertoire système des fuseaux horaires.

CONFORMITÉ

       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 numéro d'un algorithme  (voyez
       la  variable  tz_dsttime  dans  gettimeofday(2)).  C'est  obsolète  depuis longtemps, mais
       obligatoire avec SUSv2.

       BSD 4.3 a une routine char *timezone(zone, dst) qui  renvoie  le  nom  du  fuseau  horaire
       correspondant  à  son  premier  argument  (minutes  à  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.32 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <URL:http://po4a.alioth.debian.org/> par l'équipe 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 François et l'équipe francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».

                                         25 février 2010                                 TZSET(3)