tzset(3) Library Functions Manual tzset(3) NOM tzset, tzname, timezone, daylight - Initialiser des donnees pour les conversions de temps BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include void tzset(void); extern char *tzname[2]; extern long timezone; extern int daylight; Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : tzset() : _POSIX_C_SOURCE tzname : _POSIX_C_SOURCE timezone, daylight : _XOPEN_SOURCE || /* glibc >= 2.19 : */ _DEFAULT_SOURCE || /* glibc <= 2.19 : */ _SVID_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 de temps dependant du fuseau horaire. Dans un environnement de type System V, elle definira egalement les variables timezone (secondes a l'ouest de UTC) et daylight (a 0 si le fuseau n'a pas d'heure d'ete, 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, c'est le fuseau horaire du systeme qui sera utilise. Le fuseau horaire du systeme est configure en copiant ou en liant un fichier au format tzfile(5) vers /etc/localtime. Une base de donnees des fichiers de fuseaux horaires se trouve dans le repertoire des fuseaux horaires du systeme (voir plus bas la section FICHIERS). Si la variable TZ est presente dans l'environnement, alors que sa valeur est vide ou ne peut pas etre interpretee en utilisant les formats indiques plus bas, le temps universel coordonne (UTC) est utilise. La valeur de TZ peut prendre deux formats differents. Le premier est une chaine de caracteres qui represente directement le fuseau horaire a utiliser : std decalage[dst[decalage][,debut[/temps],fin[/temps]]] Ce format ne comporte aucune espace. La chaine std est une abreviation du fuseau horaire et doit comporter au moins trois caracteres alphabetiques. Lorsqu'elle est entouree des symboles inferieur (<) et superieur (>), le jeu de caracteres autorises est etendu pour inclure les caracteres plus (+) et moins (-), ainsi que les chiffres. La chaine decalage immediatement apres std indique la valeur a ajouter a l'heure locale pour obtenir l'heure UTC. La valeur de decalage est positive si l'emplacement local est a l'ouest du meridien de Greenwich, et negative s'il est a l'est. L'heure doit etre entre 0 et 24, les minutes et les secondes entre 00 et 59 : [+|-]hh[:mm[:ss]] Les chaines dst et decalage indiquent le nom et le decalage du fuseau horaire correspondant a l'heure d'ete. Si le decalage est omis, une valeur par defaut est utilisee, correspondant a un decalage de plus une heure par rapport au temps standard. Le champ debut indique la date de debut de l'heure d'ete, et fin 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. Les jours intercalaires ne sont pas comptes. Dans ce format, le 29 fevrier ne peut pas etre represente. Le 28 fevrier est le jour 59, et le 1er mars est toujours le jour 60. n Indique le jour julien a partir de zero, avec n compris entre 0 et 365. Le 29 fevrier est pris en compte pour 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 temps indique l'heure du changement, sous forme d'heure locale courante. Par defaut, la valeur est 02h 00m 00s. 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 02h 00m 00s : TZ="NZST-12:00:00NZDT-13:00:00,M10.1.0,M3.3.0" Le second format indique que les informations de fuseau horaire doivent etre lues depuis un fichier : :[fichier_tz] Si fichier_tz n'est pas indique, ou si son nom ne peut pas etre interprete, c'est le temps UTC qui sera utilise. Si fichier_tz est indique, il doit correspondre a un autre fichier au format tzfile(5) ou on lira les informations de fuseau horaire. Si fichier_tz ne commence pas par un << / >>, le chemin d'acces sera relatif au repertoire systeme des fuseaux horaires. Si le caractere deux-points (:) est omis, chacun des formats TZ ci-dessus sera teste. Voici un exemple, encore une fois pour la Nouvelle-Zelande : TZ=":Pacific/Auckland" ENVIRONNEMENT TZ Si cette variable est definie, sa valeur prend le pas sur la valeur de fuseau horaire configuree sur le systeme. TZDIR Si cette variable est definie, sa valeur prend le pas sur le chemin du repertoire de base de donnees des fuseaux horaires configure sur le systeme. FICHIERS /etc/localtime Fichier de fuseau horaire du systeme /usr/share/zoneinfo/ Repertoire de la base de donnees de fuseaux horaires du systeme. /usr/share/zoneinfo/posixrules Lorsqu'une chaine TZ inclut un fuseau horaire dst sans rien derriere, ce fichier est utilise pour les regles de debut/fin. Il est au format tzfile(5). Par defaut, le Makefile zoneinfo le lie physiquement au fichier tz America/New_York. Vous trouverez ci-dessus les localisations standards actuelles des fichiers, mais ces dernieres sont configurables lors de la compilation de la glibc. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +----------------------+--------------------------+--------------------+ |Interface | Attribut | Valeur | +----------------------+--------------------------+--------------------+ |tzset() | Securite des threads | MT-Safe env locale | +----------------------+--------------------------+--------------------+ STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001, SVr4, 4.3BSD. 4.3BSD avait une routine char *timezone(zone, dst) qui renvoyait le nom du fuseau horaire correspondant a son premier argument (minutes a l'ouest d'UTC). Si le second argument etait 0, le nom standard etait utilise, sinon c'etait le nom avec l'heure d'ete. VOIR AUSSI date(1), gettimeofday(2), time(2), ctime(3), getenv(3), tzfile(5) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Lucien Gentis Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 tzset(3)