#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 (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
Si la variable TZ n'apparaît pas dans l'environnement, c'est le fuseau horaire du système qui sera utilisé. Le fuseau horaire du système est configuré en copiant ou en liant un fichier au format tzfile(5) vers /etc/localtime. Une base de données des fichiers de fuseaux horaires se trouve dans le répertoire des fuseaux horaires du système (voir plus bas la section FICHIERS).
Si la variable TZ est présente dans l'environnement, alors que sa valeur est vide ou ne peut pas être interprétée en utilisant les formats indiqués plus bas, le temps universel coordonné (UTC) est utilisé.
La valeur de TZ peut prendre deux formats différents. Le premier est une chaîne de caractères qui représente directement le fuseau horaire à utiliser :
std décalage[dst[décalage][,début[/temps],fin[/temps]]]
Ce format ne comporte aucune espace. La chaîne std est une abréviation du fuseau horaire et doit comporter au moins trois caractères alphabétiques. Lorsqu'elle est entourée des symboles inférieur (<) et supérieur (>), le jeu de caractères autorisés est étendu pour inclure les caractères plus (+) et moins (-), ainsi que les chiffres. La chaîne décalage immédiatement après std indique la valeur à ajouter à l'heure locale pour obtenir l'heure UTC. La valeur de décalage est positive si l'emplacement local est à l'ouest du méridien de Greenwich, et négative s'il est à l'est. L'heure doit être entre 0 et 24, les minutes et les secondes entre 00 et 59 :
[+|-]hh[:mm[:ss]]
Les chaînes dst et décalage indiquent le nom et le décalage du fuseau horaire correspondant à l'heure d'été. Si le décalage est omis, une valeur par défaut est utilisée, correspondant à un décalage de plus une heure par rapport au temps standard.
Le champ début indique la date de début de l'heure d'été, et fin indique la date de retour à l'heure d'hiver. Ces deux champs utilisent l'un des formats suivants :
Le champ temps indique l'heure du changement, sous forme d'heure locale courante. Par défaut, la valeur est 02h 00m 00s.
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 à 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 être lues depuis un fichier :
:[fichier_tz]
Si fichier_tz n'est pas indiqué, ou si son nom ne peut pas être interprété, c'est le temps UTC qui sera utilisé. Si fichier_tz est indiqué, il doit correspondre à un autre fichier au format tzfile(5) où on lira les informations de fuseau horaire. Si fichier_tz ne commence pas par un « / », le chemin d'accès sera relatif au répertoire système des fuseaux horaires. Si le caractère deux-points (:) est omis, chacun des formats TZ ci-dessus sera testé.
Voici un exemple, encore une fois pour la Nouvelle-Zélande :
Vous trouverez ci-dessus les localisations standards actuelles des fichiers, mais ces dernières sont configurables lors de la compilation de la glibc.
Interface | Attribut | Valeur |
tzset() | Sécurité des threads | MT-Safe env locale |
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à