zic(8)

NOM
zic - Compilation des informations de fuseau horaire

SYNOPSIS
zic [ option ... ] [ fichier ... ]

DESCRIPTION
The zic program reads text from the file(s) named on the command line and creates the timezone information format (TZif) files specified in this input. If a filename is l’entrée standard est lue

OPTIONS

--version
    afficher les informations de version et quitter.

--help
    Afficher un bref message d'aide et terminer.

-b bloat
    Output backward-compatibility data as specified by bloat. If bloat is fat, generate additional data entries that work around potential bugs or incompatibilities in older software, such as software that mishandles a TZif file's 64-bit data or proleptic TZ string. If bloat is slim, keep the output files small; this can help check for the bugs and incompatibilities. The default is slim, as the fat workarounds are typically good only until the year 2038 anyway. Also see the -r option for another way to alter output size.

-D  Do not create ancestor directories of output files, For example, for a zone named America/Los_Angeles the directory America should already exist. By default, the directory and its ancestors are created if they do not already exist. -d directory Create time conversion information files in the named directory rather than in the standard directory named below.

-l fuseau_horaire
    Utiliser le fuseau horaire indiqué comme heure locale. zic agira comme si l'entrée contenait une ligne de lien de la forme :

    Link    fuseau_horaire    heure_locale

    Si fuseau_horaire est -, tout lien déjà existant est supprimé.

-L fichier_secondes_intercalaire
    Lire les informations concernant les secondes intercalaires à partir du fichier indiqué. Si cette option n'est pas indiquée, aucune seconde intercalaire ne sera prise en compte dans les fichiers de sortie.

-p fuseau_horaire
    Agir comme si l'entrée contenait une ligne de lien de la forme :

    Link    fuseau_horaire    règles_posix

    Si fuseau_horaire est (valeur par défaut), tout lien déjà existant est supprimé.

    à moins que fuseau_horaire soit this option is obsolete and is no longer supported by most runtimes. Among other things it should not be used for timestamps after the year 2037, and it should not be combined with -b slim if timezone's transitions are at standard time or Universal Time (UT) instead of local time. The option is present only to support obsolete runtimes that used timezone's rules when handling obsolescent TZ strings like "AST4ADT" that lack transition rules; modern runtimes that support these TZ strings typically just use current US rules as the TZ strings were mainly used in the US. Similarly, any Zone or Link named "posixrules" is obsolete and problematic.

-m mode
    Create TZif files with the given file mode bits. By default the files are created with mode 644 as modified by the umask. With this option they are created with the given mode instead. For portability the mode should be an unsigned octal integer, typically 644 or 444; some platforms also support chmod(1)-style symbolic modes. This option does not affect created ancestor directories, which have mode 755 as modified by the umask. The option is ignored on platforms lacking the notion of file mode bits.

-r [@bas][/@haut]
    Limit the applicability of output files to timestamps in the range from lo (inclusive) to hi (exclusive), where lo and hi are possibly signed decimal counts of seconds since the Epoch (1970-01-01 00:00:00 UTC). Omitted counts default to extreme values. The output files use UT offset 0 and abbreviation in place of the omitted timestamp data. For example, omet les données pour des estampilles temporelles négatives (c'est-à-dire, avant l’Époque) et produit des données pour des estampilles temporelles non négatives qui tiennent dans des entiers signés de 31 bits. Sur les plateformes avec date de GNU, omits data intended for past timestamps. Although this option typically reduces the output file's size, the size can increase due to the need to represent the timestamp range boundaries, particularly if hi causes a TZif file to contain explicit entries for pre-hi transitions rather than concisely representing them with a proleptic TZ string. Also see the -b slim option for another way to shrink output size.

-R @hi
    Generate redundant trailing explicit transitions for timestamps that occur less than hi seconds since the Epoch, even though the transitions could be more concisely represented via the proleptic TZ string. This option does not affect the represented timestamps. Although it accommodates nonstandard TZif readers that ignore the proleptic TZ string, it increases the size of the altered output files.

-t fichier
    Lors de la création des informations de temps local, mettre le lien de configuration dans le fichier indiqué plutôt que dans l’emplacement standard.

-u owner[:group]
    Change the output regular files' owner and group to those specified. The owner is either a user name, or an unsigned decimal integer user ID, or an empty string meaning no change to the owner. The group is similar for group names and IDs. This option does not affect directories or hard or symbolic links. It typically needs special privileges to change ownership, and is ignored on platforms that lack the notions of owners and groups.

-v  Être prolixe et dénoncer les situations suivantes :

    The input specifies a link to a link, something not supported by some older parsers, including zic itself through release 2022e.

    Une année apparaissant dans un fichier de données est en dehors de l’intervalle représentable.

    Un temps de 24:00 ou plus apparaît dans l’entrée. Les versions avant 1998 de zic interdisaient 24:00 et celles avant 2007 un temps de plus de 24:00.

    Une règle conduit avant le début du mois ou après sa fin. Les versions avant 2004 de zic interdisaient cela.

    Une abréviation de fuseau horaire utilise le format %z. Les versions avant 2015 de zic ne le prennent pas en charge.

    Une estampille temporelle contient des fractions de seconde. Les versions avant 2018 de zic ne les prennent pas en charge.

    L’entrée contient des abréviations qui sont mal gérées par les versions avant 2018 de zic à cause d’un vieux bogue de code. Ces abréviations incluent pour pour pour et pour

    The output file does not contain all the information about the long-term future of a timezone, because the future cannot be summarized as a proleptic TZ string. For example, as of 2023 this problem occurs for Morocco's daylight-saving rules, as these rules are based on predictions for when Ramadan will be observed, something that a proleptic TZ string cannot represent.

    La sortie contient des données qui ne peuvent être gérées correctement par le code du client, conçu pour les anciens formats de sortie de zic. Ces problèmes de compatibilité affectent seulement les estampilles temporelles d’avant 1970 ou d’après le début de 2038.

    The output contains a truncated leap second table, which can cause some older TZif readers to misbehave. This can occur if the -L option is used, and either an Expires line is present or the -r option is also used.

    Le fichier de sortie contient plus de 1200 transitions, qui pourraient être mal gérées par quelques clients. Le client de référence actuel gère au plus 2000 transitions. Les versions d’avant 2014 du client de référence gèrent au plus 1200 transitions.

    Une abréviation de fuseau horaire est de moins de trois caractères ou de plus de six caractères. POSIX en requiert au moins trois et requiert que les implémentations en gèrent au moins six.

    Un nom de fichier contient un octet qui n’est pas une lettre ASCII. ou ou il contient un composant de nom de plus de 14 octets ou commençant par

FICHIERS
Les fichiers d’entrée utilisent le format décrit dans cette section. Les fichiers de sortie utilisent le format de tzfile(5).

Input files should be text files, that is, they should be a series of zero or more lines, each ending in a newline byte and containing at most 2048 bytes counting the newline, and without any NUL bytes. The input text's encoding is typically UTF-8 or ASCII; it should have a unibyte representation for the POSIX Portable Character Set (PPCS) (https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap06.html) and the encoding's non-unibyte characters should consist entirely of non-PPCS bytes. Non-PPCS characters typically occur only in comments: although output file names and time zone abbreviations can contain nearly any character, other software will work better if these are limited to the restricted syntax described under the -v option.

Les lignes d'entrées sont composées de champs, séparés les uns des autres par un ou plusieurs caractères blancs. Les caractères blancs sont : espace, saut de page, retour chariot, nouvelle ligne, tabulation et tabulation verticale. Les espaces en début et fin de ligne sont ignorées. Un caractère dièse « # » non protégé en entrée introduit un commentaire qui s'étend jusqu'à la fin de la ligne où il apparaît. Les caractères blancs et les dièses peuvent être inclus entre guillemets « " » lorsqu'ils doivent faire partie d'un champ. Toute ligne vide (après suppression des commentaires) est ignorée. Les lignes non vides peuvent être de trois types : les lignes de règle, de zone et de lien.

Les noms doivent être en anglais et sont indifférents à la casse. Ils apparaissent dans plusieurs contextes et incluent les noms de mois, de fin de semaine et des mots-clés tels que maximum, only, Rolling et Zone. Un nom peut être abrégé par son commencement, mais toute abréviation ne doit pas être ambiguë pour le contexte.

Une ligne de règle est de la forme :

Rule	NAME	FROM	TO	-	IN	ON	AT	SAVE	LETTER/S

Par exemple :

Rule	US	1967	1973	-	Apr	lastSun	2:00w	1:00d	D

Les champs composant une ligne de règle sont :

NAME (NOM)
    Nom de l’ensemble de règles contenant cette ligne. Le nom doit débuter par un caractère qui n’est ni un chiffre ASCII ni ni Pour permettre des extensions futures, un nom non protégé ne doit pas contenir des caractères de l’ensemble

FROM
    Gives the first year in which the rule applies. Any signed integer year can be supplied; the proleptic Gregorian calendar is assumed, with year 0 preceding year 1. Rules can describe times that are not representable as time values, with the unrepresentable times ignored; this allows rules to be portable among hosts with differing time value types.

TO  Gives the final year in which the rule applies. The word maximum (or an abbreviation) means the indefinite future, and the word only (or an abbreviation) may be used to repeat the value of the FROM field.

-   C’est un champ réservé et il doit toujours contenir pour une compatibilité avec les anciennes versions de zic. Il était connu précédemment comme champ TYPE qui pouvait contenir des valeurs pour permettre à un script particulier une autre restriction dans laquelle la règle s’appliquerait pour d’années.

IN  Names the month in which the rule takes effect. Month names may be abbreviated as mentioned previously; for example, January can appear as ou but not as which would be ambiguous with both June and July.

ON  Jour auquel la règle prend effet. Les formes acceptées comprennent :

    5	Le 5 du mois
    lastSun	Le dernier dimanche du mois
    lastMon	Le dernier lundi du mois
    Sun>=8	Le premier dimanche après ou le 8
    Sun<=25	Le dernier dimanche avant ou le 25

    Un nom de jour (par exemple, Sunday) ou un nom précédé par (e.g., lastSunday) may be abbreviated as mentioned previously, e.g., for Sunday and for the last Saturday. There must be no white space characters within the ON field. The et peuvent aboutir à un jour dans le mois voisin. Par exemple, la combinaison IN-ON positionne au premier dimanche suivant ou après le 31 octobre même si ce dimanche arrive en novembre.

AT  Heure du jour à laquelle la règle prend effet, relativement à 00:00, le début d’une journée calendaire. Les formes acceptées sont :

    2	temps en heures
    2:00	temps en heures et minutes
    01:28:14	temps en heures, minutes et secondes
    00:19:32.13	temps avec des secondes fractionnaires
    12:00	midi, 12 heures après 00:00
    15:00	3 après-midi, 15 heures après 00:00
    24:00	fin du jour, 24 heures après 00:00
    260:00	260 heures après 00:00
    -2:30	2,5 heures avant 00:00
    -	équivalent à 0

    Bien que zic arrondisse les temps à la seconde entière la plus proche, (en cas d’égalité à la valeur entière paire), les fractions peuvent être utiles pour des applications nécessitant une précision supérieure. Le format du source ne spécifie aucune précision maximale. Toutes ses formes peuvent être suivies par la lettre w si le temps indiqué est local ou de s si le temps indiqué est le temps standard sans ajustement pour l’heure d’été ou u (ou g ou z) si le temps indiqué est le temps universel. En l’absence d’indicateur, l’heure locale (horloge) est supposée. Ces formes ignorent les secondes additionnelles. Par exemple, si une seconde intercalaire est ajoutée à l’heure locale 00:59:60, correspond à 3601 secondes après le minuit local au lieu des 3600 secondes habituelles. Le but est que la ligne de règle décrive l’instant auquel une horloge ou un calendrier définis pour le type de temps précisé dans le champ AT afficherait la date et l’heure du jour.

SAVE
    Montant du temps à ajouter au temps local standard quand la règle est appliquée et si le temps résultant est standard ou à l’heure d’été. Ce champ a le même format que le champ AT à l’exception d’un ensemble différent de lettres de suffixe : s pour le temps standard et d pour l’heure d’été. La lettre de suffixe est classiquement omise, et par défaut vaut s si le décalage est zéro et d autrement. Les décalages négatifs sont autorisés. En Irlande, par exemple, l’heure d’été est respectée en hiver et a un décalage négatif par rapport à l’heure d’été irlandaise standard. Le décalage est simplement ajouté au temps standard. Par exemple, zic ne fait pas la distinction entre un temps standard de 10:30 plus un SAVE de 0:30 d’un temps standard de 10:00 plus un SAVE de 1:00.

LETTER/S
    Affectation de la (par exemple, ou dans ou des abréviations de fuseau horaire à utiliser quand cette règle est appliquée. Si ce champ est la part variable est nulle

Une ligne de zone est de la forme :

Zone	NAME	STDOFF	RULES	FORMAT	[UNTIL]

Par exemple :

Zone	Asia/Amman	2:00	Jordan	EE%sT	2017 Oct 27 01:00

Les champs constituant une ligne de zone sont les suivants :

NAME (NOM)
    Nom du fuseau horaire. Il s'agit du nom utilisé pour la création du fichier de données de conversions horaires pour cette zone. Il ne doit pas contenir un composant de nom de fichier ou Un composant de nom de fichier est une sous-chaîne maximale qui ne contient pas

STDOFF
    The amount of time to add to UT to get standard time, without any adjustment for daylight saving. This field has the same format as the AT and SAVE fields of rule lines, except without suffix letters; begin the field with a minus sign if time must be subtracted from UT.

RULES
    The name of the rules that apply in the timezone or, alternatively, a field in the same format as a rule-line SAVE field, giving the amount of time to be added to local standard time and whether the resulting time is standard or daylight saving. Standard time applies if this field is - or for timestamps occurring before any rule takes effect. When an amount of time is given, only the sum of standard time and this amount matters.

FORMAT
    The format for time zone abbreviations. The pair of characters %s shows where to put the time zone abbreviation's variable part, which is taken from the LETTER/S field of the corresponding rule; any timestamps that precede the earliest rule use the LETTER/S of the earliest standard-time rule (which in this case must exist). Alternatively, a format can use the pair of characters %z to stand for the UT offset in the form ±hh, ±hhmm, or ±hhmmss, using the shortest form that does not lose information, where hh, mm, and ss are the hours, minutes, and seconds east (+) or west (-) of UT. Alternatively, a slash (/) separates standard and daylight abbreviations. To conform to POSIX, a time zone abbreviation should contain only alphanumeric ASCII characters, et By convention, the time zone abbreviation is a placeholder that means local time is unspecified.

UNTIL
    Moment où changent le décalage par rapport à l'UTC ou les règles pour le lieu. Ce moment est indiqué sous la forme d’un des quatre champs YEAR [MONTH [DAY [TIME]]]. Si cela est spécifié, les informations pour le fuseau horaire seront créées à partir de la modification de la règle ou du décalage UTC jusqu'au moment indiqué, interprété en utilisant la règle appliquée juste avant la transition. Les mois, jour et heure du jour ont le même format que pour les champs IN, ON et AT d'une règle. Les colonnes qui suivent peuvent être omises, leur valeurs par défaut étant les premières valeurs possibles.

    La ligne suivante doit être une ligne de Elle a la même forme qu’une ligne de zone excepté que la chaîne et le nom sont omis, car la ligne de continuation placera les informations débutant au temps indiqué comme l’information dans la ligne précédente dans le fichier utilisé par la ligne précédente. Les lignes de continuation peuvent contenir des informations tout comme les lignes de zone le font, indiquant que la ligne suivante est une continuation supplémentaire.

Si une zone change au même moment qu’une règle aurait pris effet dans la zone précédente ou dans la ligne de continuation, la règle est ignorée. Une zone ou une ligne de continuation L avec un ensemble de règles nommé débute avec le temps standard par défaut : c'est-à-dire, n’importe quelle estampille temporelle de L précédant la règle de L précédente utilise la règle en usage après la première transition de L dans le temps standard. Dans une même zone, c’est une erreur si deux règles prennent effet au même moment ou si deux modifications de zone se produisent au même moment.

Si une ligne de continuation soustrait N secondes du décalage de temps universel après une transition qui serait interprétée postérieure en utilisant le décalage et les règles de la ligne de continuation, le temps de la zone précédente ou de la ligne de continuation est interprété selon le décalage et les règles de temps universel de la ligne de continuation, et toute règle qui autrement prendrait effet dans les N secondes suivantes est à la place considérée comme prenant effet simultanément. Par exemple :

# Rule	NAME	FROM	TO	-	IN	ON	AT	SAVE	LETTER/S
Rule	US	1967	2006	-	Oct	lastSun	2:00	0	S
Rule	US	1967	1973	-	Apr	lastSun	2:00	1:00	D
# Zone	NAME	STDOFF	RULES	FORMAT	[UNTIL]
Zone	America/Menominee	-5:00	-	EST	1973 Apr 29 2:00
		-6:00	US	C%sT

Here, an incorrect reading would be there were two clock changes on 1973-04-29, the first from 02:00 EST (-05) to 01:00 CST (-06) according to the value in the zone line, and the second an hour later from 02:00 CST (-06) to 03:00 CDT (-05) according to the values in the April rule line. However, zic interprets this more sensibly as a single transition from 02:00 EST (-05) to 02:00 CDT (-05).

Une ligne de lien est de la forme :

Link	CIBLE	NOM-LIEN

Par exemple :

Link	Europe/Istanbul	Asia/Istanbul

The TARGET field should appear as the NAME field in some zone line or as the LINK-NAME field in some link line. The LINK-NAME field is used as an alternative name for that zone; it has the same syntax as a zone line's NAME field. Links can chain together, although the behavior is unspecified if a chain of one or more links does not terminate in a Zone name. A link line can appear before the line that defines the link target. For example:

Link	Greenwich	G_M_T
Link	Etc/GMT	Greenwich
Zone	Etc/GMT  0  -  GMT

The two links are chained together, and G_M_T, Greenwich, and Etc/GMT all name the same zone.

Except for continuation lines, lines may appear in any order in the input. However, the behavior is unspecified if multiple zone or link lines define the same name.

Le fichier décrivant les secondes intercalaires périodique peut comporter une ligne de saut et une ligne d’expiration. Les lignes de rattrapage ont la forme suivante :

Leap	YEAR	MONTH	DAY	HH:MM:SS	CORR	R/S

Par exemple :

Leap	2016	Dec	31	23:59:60	+	S

Les champs YEAR, MONTH, DAY et HH:MM:SS indiquent quand la seconde intercalaire se produit. Le champ CORR doit être si une seconde a été ajoutée ou si une seconde a été sautée. Le champ R/S doit être (une abréviation de) si le temps de la seconde intercalaire indiqué par les autres champs doit être interprété comme UTC ou (une abréviation de) si le temps de la seconde de intercalaire par les autres champs doit être interprété comme celui local (horloge).

Rolling leap seconds would let one see Times Square ball drops where there'd be a countdown, placing the leap second at midnight New York time rather than midnight UTC. Although stationary leap seconds are the common practice, rolling leap seconds can be useful in specialized applications like SMPTE timecodes that may prefer to put leap second discontinuities at the end of a local broadcast day. However, rolling leap seconds are not supported if the -r option is used.

Une ligne d’expiration, si elle existe, est de la forme :

Expires	YEAR	MONTH	DAY	HH:MM:SS

Par exemple :

Expires	2020	Dec	28	00:00:00

The YEAR, MONTH, DAY, and HH:MM:SS fields give the expiration timestamp in UTC for the leap second table.

EXEMPLE APPROFONDI
Here is an extended example of zic input, intended to illustrate many of its features.

# Rule	NAME	FROM	TO	-	IN	ON	AT	SAVE	LETTER/S
Rule	Swiss	1941	1942	-	May	Mon>=1	1:00	1:00	S
Rule	Swiss	1941	1942	-	Oct	Mon>=1	2:00	0	-

Rule	EU	1977	1980	-	Apr	Sun>=1	1:00u	1:00	S
Rule	EU	1977	only	-	Sep	lastSun	1:00u	0	-
Rule	EU	1978	only	-	Oct	 1	1:00u	0	-
Rule	EU	1979	1995	-	Sep	lastSun	1:00u	0	-
Rule	EU	1981	max	-	Mar	lastSun	1:00u	1:00	S
Rule	EU	1996	max	-	Oct	lastSun	1:00u	0	-

# Zone	NAME	STDOFF	RULES	FORMAT	[UNTIL]
Zone	Europe/Zurich	0:34:08	-	LMT	1853 Jul 16
		0:29:45.50	-	BMT	1894 Jun
		1:00	Swiss	CE%sT	1981
		1:00	EU	CE%sT

Link	Europe/Zurich	Europe/Vaduz

In this example, the EU rules are for the European Union and for its predecessor organization, the European Communities. The timezone is named Europe/Zurich and it has the alias Europe/Vaduz. This example says that Zurich was 34 minutes and 8 seconds east of UT until 1853-07-16 at 00:00, when the legal offset was changed to 7degrés26minutes22.50secondes, which works out to 0:29:45.50; zic treats this by rounding it to 0:29:46. After 1894-06-01 at 00:00 the UT offset became one hour and Swiss daylight saving rules (defined with lines beginning with ont été appliquées. De 1981 à maintenant, les règles d’heure d’été de l’EU ont été appliquées et le décalage de TU est demeuré d’une heure.

En 1941 et 1942, l’heure d’été s’est appliquée du premier lundi de mai à 01:00 jusqu’au premier lundi d’octobre à 02:00. Les règles d’heure d’été de l’UE avant 1981 n’ont aucun effet ici mais sont incluses pour complétude. Depuis 1981, l’heure d’été commence le dernier dimanche de mars à 01:00 UTC et se terminait le dernier dimanche de septembre à 01:00 UTC, mais cela a changé pour le dernier dimanche d’octobre depuis 1996.

Dans un but d’affichage, et ont été initialement utilisés respectivement. Depuis que les règles suisses et plus tard les règles de l’UE ont été appliquées, l’abréviation de fuseau horaire a été CET pour le temps standard et CEST pour l’heure d’été.

FICHIERS

/etc/localtime
    Fichier par défaut du fichier de fuseau horaire.

/usr/share/zoneinfo
    Répertoire par défaut d’information de fuseau horaire.

NOTES
Pour les zones ayant plus de deux types d'heure locale, il peut être nécessaire d'utiliser l'heure locale standard dans le champ AT de la première règle de transition pour s'assurer que la première heure de transition du fichier compilé soit correcte.

Si, pour une zone horaire, une avance d’horloge provoquée par le début de l’heure d’été coïncide et est égal avec un recul d’horloge provoqué par un changement de décalage de TU, zic produit une transition unique vers l’heure d’été au nouveau décalage de TU sans modification du temps local (horloge). Pour obtenir des transitions séparées, plusieurs lignes de continuation de zone, précisant les moments de transition au temps universel, sont à utiliser.

VOIR AUSSI
tzfile(5), zdump(8)

TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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 à debian-l10n-french@lists.debian.org.