CHGTIMZON

Modifier descr fuseau horaire

En bref

La commande CHGTIMZON (Modifier descr fuseau horaire) permet de modifier un objet description de fuseau horaire définissant les propriétés du fuseau horaire.

CHGTIMZON se lit CHG (Modifier) + TIMZON. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGTIMZON TIMZON(…)

Paramètres

TIMZON Description de fuseau horaire obligatoire
OFFSET Décalage
STDNAME Heure standard
DSTNAME Période de l'heure d'été (DST)
STDMSG Message d'heure standard
DSTMSG Message période d'heure d'été
MSGF Fichier de messages fichier message
DSTSTR Début période de l'heure d'été
DSTEND Fin période de l'heure d'été
DSTSHIFT Décalage de l'heure d'été
TEXT Texte 'descriptif'
YEAROFS Décalage de l'année
ALTNAME Autre nom

Astuce : dans une session 5250, tapez CHGTIMZON puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Oui

La commande CHGTIMZON (Modifier descr fuseau horaire) permet de modifier un objet description de fuseau horaire définissant les propriétés du fuseau horaire. Ces propriétés permettent d'effectuer des conversions des heures entre le format UTC (Coordinated Universal Time) et les formats locaux. Ces propriétés permettent également d'exprimer l'heure à l'aide de formats locaux.

Restrictions :

Vous devez disposer d'un droit de modification (*CHANGE) sur la description de fuseau horaire à modifier.
Vous devez disposer du droit *EXECUTE sur la bibliothèque QSYS.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
TIMZON	Description de fuseau horaire	Nom	Obligatoire, clé, positionnel 1
OFFSET	Décalage	-840-840, *SAME	Facultatif
STDNAME	Heure standard	Valeurs uniques: SAME, GEN, MSG Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Nom abrégé	Valeur caractère
	Élément 2: Nom complet	Valeur caractère
DSTNAME	Période de l'heure d'été (DST)	Valeurs uniques: SAME, NONE, GEN, MSG Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Nom abrégé	Valeur caractère
	Élément 2: Nom complet	Valeur caractère
STDMSG	Message d'heure standard	Nom, *SAME	Facultatif
DSTMSG	Message période d'heure d'été	Nom, *SAME	Facultatif
MSGF	fichier message	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: fichier message	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
DSTSTR	Début période de l'heure d'été	Liste d'éléments	Facultatif
	Élément 1: Mois	SAME, JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, *DEC
	Élément 2: Jour	SAME, MON, TUE, WED, THU, FRI, SAT, SUN
	Élément 3: Jour relatif du mois	SAME, LAST, 1, 2, 3, 4
	Élément 4: Heure	Heure, *SAME
DSTEND	Fin période de l'heure d'été	Liste d'éléments	Facultatif
	Élément 1: Mois	SAME, JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, *DEC
	Élément 2: Jour	SAME, MON, TUE, WED, THU, FRI, SAT, SUN
	Élément 3: Jour relatif du mois	SAME, LAST, 1, 2, 3, 4
	Élément 4: Heure	Heure, *SAME
DSTSHIFT	Décalage de l'heure d'été	0-120, *SAME	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
YEAROFS	Décalage de l'année	-140-140, *SAME	Facultatif
ALTNAME	Autre nom	Valeur caractère, *SAME	Facultatif

Description de fuseau horaire (TIMZON)

Indique la description de fuseau horaire à modifier.

Ce paramètre est obligatoire.

nom: Indiquez le nom de la description de fuseau horaire.

Décalage (OFFSET)

Indique l'écart horaire, en minutes, entre le fuseau horaire et l'heure UTC (Coordinated Universal Time). Cette valeur est égale à l'heure locale moins l'heure UTC. Si le résultat est négatif, le fuseau horaire se situe à l'ouest de UTC et si le résultat est positif, le fuseau horaire se situe à l'est de UTC.

*SAME: La valeur reste inchangée.
-840 à 840: Indiquez l'écart horaire en minutes. Les valeurs admises sont comprises entre -840 minutes et 840 minutes.

Heure standard (STDNAME)

Indique les noms abrégé et complet du fuseau horaire lorsque l'heure d'été n'est pas appliquée.

Valeurs uniques

*SAME: La valeur reste inchangée.
*GEN: Le système va générer les noms abrégé et complet. Le format du nom abrégé se compose des lettres "UTC" suivies par le décalage et par la lettre "S". Le décalage s'affiche sous la forme d'une valeur heure-minutes. Le nom complet de la description de fuseau horaire est identique au nom abrégé. Par exemple, les noms abrégé et complet d'un fuseau horaire dont le décalage est de -360 minutes sont "UTC-06:00S".
*MSG: Les noms abrégé et complet sont extraits du texte de message de second niveau pour le message indiqué dans le paramètre STDMSG (Message d'heure standard). Lorsque cette valeur est spécifiée, un message d'heure standard et un fichier message doivent être indiqués pour la description de fuseau horaire.

Elément 1 : Nom abrégé

valeur-alphanumérique: Indiquez un nom abrégé ou court pour ce fuseau horaire. Le nom abrégé doit comporter au plus 10 caractères.

Elément 2 : Nom complet

valeur-alphanumérique: Indiquez un nom complet ou long pour ce fuseau horaire. Le nom complet doit comporter au plus 50 caractères.

Période de l'heure d'été (DST) (DSTNAME)

Indique les noms abrégé et complet du fuseau horaire lorsque l'heure d'été est appliquée. Lorsque ce paramètre est modifié pour une valeur autre que *NONE, les informations de début et de fin relatives à l'heure d'été doivent être indiquées pour le fuseau horaire.

Valeurs uniques

*SAME: La valeur reste inchangée.
*NONE: Ce fuseau horaire n'applique pas l'heure d'été.
*GEN: Le système va générer les noms abrégé et complet. Le format du nom abrégé se compose des lettres "UTC" suivies par le décalage et par la lettre "D". Le décalage s'affiche sous la forme d'une valeur heure-minutes. Le nom complet de la description de fuseau horaire est identique au nom abrégé. Par exemple, les noms abrégé et complet d'un fuseau horaire dont le décalage est de -360 minutes sont "UTC-06:00D".
*MSG: Les noms abrégé et complet sont extraits du texte de message de second niveau pour le message indiqué dans le paramètre DSTMSG (Message période d'heure d'été). Lorsque cette valeur est spécifiée, un message de période d'heure d'été et un fichier message doivent être indiqués pour la description de fuseau horaire.

Elément 1 : Nom abrégé

valeur-alphanumérique: Indiquez un nom abrégé ou court pour ce fuseau horaire. Le nom abrégé doit comporter au plus 10 caractères.

Elément 2 : Nom complet

valeur-alphanumérique: Indiquez un nom complet ou long pour ce fuseau horaire. Le nom complet doit comporter au plus 50 caractères.

Message d'heure standard (STDMSG)

Indique le message prédéfini contenant les noms abrégé et complet du fuseau horaire qui sont utilisés lorsque l'heure d'été n'est pas appliquée. Les 10 premiers caractères du message correspondent au nom abrégé et les 50 caractères suivants correspondent au nom complet. Il est possible de spécifier un identificateur de message pour ce paramètre uniquement si *MSG est indiqué pour le nom d'heure standard de la description de fuseau horaire.

*SAME: La valeur reste inchangée.
nom: Indiquez l'identificateur de message.

Message période d'heure d'été (DSTMSG)

Indique le message prédéfini contenant les noms abrégé et complet du fuseau horaire qui sont utilisés lorsque l'heure d'été est appliquée. Les 10 premiers caractères du message correspondent au nom abrégé et les 50 caractères suivants correspondent au nom complet. Il est possible de spécifier un identificateur de message pour ce paramètre uniquement si *MSG est indiqué pour le nom d'heure d'été de la description de fuseau horaire.

*SAME: La valeur reste inchangée.
nom: Indiquez l'identificateur de message.

fichier message (MSGF)

Indique le fichier message à partir duquel sont extraits les messages d'heure standard et d'heure d'été. Le nom de fichier message et le nom de bibliothèque spécifiés sont stockés dans la description de fuseau horaire. Lorsqu'un message est utilisé pour spécifier les noms abrégé et complet, il est extrait en même temps que les noms abrégé et complet. Si le message ne peut pas être extrait du fichier message, les noms sont renvoyés sous la forme *N. Il est possible de spécifier un fichier message pour ce paramètre uniquement si *MSG est indiqué pour le nom d'heure standard ou pour le nom d'heure d'été de la description de fuseau horaire.

Qualificatif 1 : fichier message

*SAME: La valeur reste inchangée.
nom: Indiquez le nom du fichier message.

Qualificatif 2 : Biblio

*LIBL: Lors de l'extraction du message, la recherche du fichier message porte sur toutes les bibliothèques de l'unité d'exécution. La valeur *LIBL est enregistrée dans la description de fuseau horaire et n'est pas résolue dans le nom de bibliothèque par cette commande.
nom: Entrez le nom de la bibliothèque contenant le fichier message.

Début période de l'heure d'été (DSTSTR)

Indique le début de la période d'heure d'été. Ce paramètre comporte quatre éléments : le mois, le jour, le jour relatif du mois et l'heure de début de la période d'heure d'été. Si ce paramètre est spécifié, alors les quatre éléments doivent être indiqués. Il est possible de modifier ce paramètre uniquement si une valeur autre que *NONE est indiquée pour le nom d'heure d'été de la description de fuseau horaire. Les informations de début et de fin relatives à la période d'heure d'été ne peuvent pas être identiques.

Elément 1 : Mois

*SAME: La valeur reste inchangée.
*JAN: La période d'heure d'été commence en janvier.
*FEB: La période d'heure d'été commence en février.
*MAR: La période d'heure d'été commence en mars.
*APR: La période d'heure d'été commence en avril.
*MAY: La période d'heure d'été commence en mai.
*JUN: La période d'heure d'été commence en juin.
*JUL: La période d'heure d'été commence en juillet.
*AUG: La période d'heure d'été commence en août.
*SEP: La période d'heure d'été commence en septembre.
*OCT: La période d'heure d'été commence en octobre.
*NOV: La période d'heure d'été commence en novembre.
*DEC: La période d'heure d'été commence en décembre.

Elément 2 : Jour

*SAME: La valeur reste inchangée.
*MON: La période d'heure d'été commence lundi.
*TUE: La période d'heure d'été commence mardi.
*WED: La période d'heure d'été commence mercredi.
*THU: La période d'heure d'été commence jeudi.
*FRI: La période d'heure d'été commence vendredi.
*SAT: La période d'heure d'été commence samedi.
*SUN: La période d'heure d'été commence dimanche.

Elément 3 : Jour relatif du mois

*SAME: La valeur reste inchangée.
*LAST: La période d'heure d'été commence à la dernière occurrence du jour indiqué de la semaine.
1: La période d'heure d'été commence à la première occurrence du jour indiqué de la semaine.
2: La période d'heure d'été commence à la deuxième occurrence du jour indiqué de la semaine.
3: La période d'heure d'été commence à la troisième occurrence du jour indiqué de la semaine.
4: La période d'heure d'été commence à la quatrième occurrence du jour indiqué de la semaine.

Elément 4 : Heure

*SAME

La valeur reste inchangée.

heure

Indiquez l'heure à laquelle commence la période d'heure d'été. L'heure est indiquée au format 24 heures, avec ou sans séparateur.

Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss) où hh représente les heures, mm, les minutes et ss, les secondes. Les valeurs correctes pour la plage hh vont de 00 à 23. Les valeurs correctes pour les plages mm et ss vont de 00 à 59.
Si vous utilisez un séparateur, entrez une chaîne de 5 ou 8 caractères dans laquelle le séparateur spécifié pour le travail permet de séparer les heures, les minutes et les secondes. Si la commande est entrée depuis une ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un séparateur différent, la commande ne peut pas aboutir.

Fin période de l'heure d'été (DSTEND)

Indique la fin de la période d'heure d'été. Ce paramètre comporte quatre éléments : le mois, le jour, le jour relatif du mois et l'heure de fin de la période d'heure d'été. Si ce paramètre est spécifié, alors les quatre éléments doivent être indiqués. Il est possible de modifier ce paramètre uniquement si une valeur autre que *NONE est indiquée pour le nom d'heure d'été de la description de fuseau horaire. Les informations de début et de fin relatives à la période d'heure d'été ne peuvent pas être identiques.

Elément 1 : Mois

*SAME: La valeur reste inchangée.
*JAN: La période d'heure d'été termine en janvier.
*FEB: La période d'heure d'été termine en février.
*MAR: La période d'heure d'été termine en mars.
*APR: La période d'heure d'été termine en avril.
*MAY: La période d'heure d'été termine en mai.
*JUN: La période d'heure d'été termine en juin.
*JUL: La période d'heure d'été termine en juillet.
*AUG: La période d'heure d'été termine en août.
*SEP: La période d'heure d'été termine en septembre.
*OCT: La période d'heure d'été termine en octobre.
*NOV: La période d'heure d'été termine en novembre.
*DEC: La période d'heure d'été termine en décembre.

Elément 2 : Jour

*SAME: La valeur reste inchangée.
*MON: La période d'heure d'été termine lundi.
*TUE: La période d'heure d'été termine mardi.
*WED: La période d'heure d'été termine mercredi.
*THU: La période d'heure d'été termine jeudi.
*FRI: La période d'heure d'été termine vendredi.
*SAT: La période d'heure d'été termine samedi.
*SUN: La période d'heure d'été termine dimanche.

Elément 3 : Jour relatif du mois

*SAME: La valeur reste inchangée.
*LAST: La période d'heure d'été termine à la dernière occurrence du jour indiqué de la semaine.
1: La période d'heure d'été termine à la première occurrence du jour indiqué de la semaine.
2: La période d'heure d'été termine à la deuxième occurrence du jour indiqué de la semaine.
3: La période d'heure d'été termine à la troisième occurrence du jour indiqué de la semaine.
4: La période d'heure d'été termine à la quatrième occurrence du jour indiqué de la semaine.

Elément 4 : Heure

*SAME

La valeur reste inchangée.

heure

Indiquez l'heure à laquelle termine la période d'heure d'été. L'heure est indiquée au format 24 heures, avec ou sans séparateur.

Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss) où hh représente les heures, mm, les minutes et ss, les secondes. Les valeurs correctes pour la plage hh vont de 00 à 23. Les valeurs correctes pour les plages mm et ss vont de 00 à 59.
Si vous utilisez un séparateur, entrez une chaîne de 5 ou 8 caractères dans laquelle le séparateur spécifié pour le travail permet de séparer les heures, les minutes et les secondes. Si la commande est entrée depuis une ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un séparateur différent, la commande ne peut pas aboutir.

Décalage de l'heure d'été (DSTSHIFT)

Indique le nombre de minutes à ajouter à l'heure locale au début de la période d'heure d'été ou à enlever à la fin de la période d'heure d'été.

*SAME: La valeur reste inchangée.
0 à 120: Indiquez le nombre de minutes qu'il faut ajouter ou enlever à l'heure locale en début ou en fin de période d'heure d'été.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: La valeur reste inchangée.
*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Décalage de l'année (YEAROFS)

Indique la différence (en nombre d'années) entre l'année calendaire en cours utilisée avec ce fuseau horaire et l'année grégorienne en cours. Si l'année calendaire est différente de l'année grégorienne en cours, soustrayez l'année grégorienne de l'année calendaire pour déterminer la valeur de ce paramètre. Par exemple, si l'année grégorienne est 2006 et l'année calendaire 1949, le décalage d'années est fixé à -57 (1949 moins 2006).

*SAME: La valeur reste inchangée.
-140 à 140: Indiquez la différence, en années, entre l'année calendaire en cours utilisée avec ce fuseau horaire et l'année grégorienne en cours. Une valeur de zéro signifie que ce fuseau horaire est utilisé avec le calendrier grégorien. Le décalage d'années ajouté à l'année grégorienne en cours doit être une date comprise entre 1929 et 2061 (plage prise en charge par le système).

Autre nom (ALTNAME)

Indique l'autre nom fournissant des informations supplémentaires sur la description de fuseau horaire.

*SAME: La valeur reste inchangée.
valeur-alphanumérique: Indiquez l'autre nom de ce fuseau horaire entre apostrophes. Ce nom doit comporter au plus 128 caractères.

Exemples

Exemple 1 : modification du décalage

CHGTIMZON  TIMZON(CENTRAL) OFFSET(-360)

Cette commande permet de modifier le décalage indiqué dans la description de fuseau horaire CENTRAL à moins six heures (-360 minutes).

Exemple 2 : modification des informations de début et de fin relatives à l'heure d'été

CHGTIMZON   TIMZON(CENTRALDST)
            DSTSTR(*OCT *SUN *LAST '02:00:00')
            DSTEND(*APR *SUN 1 '02:00:00')

Cette commande permet de modifier les informations de début et de fin relatives à l'heure d'été de la description de fuseau horaire CENTRALDST. L'heure d'été commencera à 02:00 le dernier dimanche d'octobre et se terminera à 02:00 le premier dimanche d'avril.

Messages d'erreur

Messages *ESCAPE

CPF09A0: Description de fuseau horaire &1 non modifiée.