Provided by: manpages-fr-dev_3.57d1p1-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. Les jours  intercalaires  ne
              sont  pas  comptés.  Dans  ce format, le 29 février ne peut pas être représenté. Le
              28 février est le jour 59, et le 1er mars est toujours le jour 60.

       n      Indique le jour julien, avec n compris entre 0 et 365.  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.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <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 mars 2012                                  TZSET(3)