Man Timezone en français
TZSET(3)                  Manuel du programmeur Linux                 TZSET(3)



 

NOM


       tzset, tzname, timezone, daylight - Initialisation des donnees pour les
       conversions de temps.

 

SYNOPSIS


       #include 

       void tzset (void);

       extern char *tzname[2]
       extern long timezone;
       extern int daylight;

 

DESCRIPTION






       La fonction tzset() initialise la variable tzname en utilisant la vari-
       able d'environnement TZ. Cette fonction est appelee automatiquement par
       les autres fonctions de conversion dependant du fuseau  horaire.   Dans
       un  environnement type Systeme V, elle remplira egalement les variables
       timezone (secondes a l'ouest de Greenwich) et daylight (0 si le  fuseau
       n'a pas de changement d'heure saisonnier, 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  ini-
       tialisee  avec  la  meilleure approximation possible de l'heure locale,
       comme indique dans le fichier localtime, au format tzfile(5), se  trou-
       vant  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) est utilisee.

       La  valeur de TZ peut prendre trois formats differents. Le premier cor-
       respond 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 02:00:00.

       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.

 

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.

 

CONFORMITE


       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 sim-
       plement le numero d'un algorithme (voyez la  variable  tz_dsttime  dans
       gettimeofday(2)).   C'est  obsolete  depuis longtemps, mais obligatoire
       avec SUSv2.

       BSD4.3 a une fonction 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)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le 11 decembre 1996  et  revisee  le
       14 aot 2006.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est   toujours  consultable  via  la  commande :   LANG=C man 3 tzset .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



LDP                            13 novembre 2001                       TZSET(3)