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

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.32 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)