CRTTIMZON

Créer descript fuseau horaire

En bref

La commande CRTTIMZON (Créer descript fuseau horaire) permet de créer un objet description de fuseau horaire définissant les propriétés du fuseau horaire.

CRTTIMZON se lit CRT (Créer) + TIMZON. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTTIMZON TIMZON(…) OFFSET(…)

Paramètres

TIMZON Description de fuseau horaire obligatoire
OFFSET Décalage obligatoire
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
AUT Droits

Astuce : dans une session 5250, tapez CRTTIMZON 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 CRTTIMZON (Créer descript fuseau horaire) permet de créer un objet description de fuseau horaire définissant les propriétés du fuseau horaire. L'objet description de fuseau horaire est créé dans la bibliothèque QSYS. 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 des droits de lecture (*READ) et d'ajout (*ADD) sur la bibliothèque QSYS.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
TIMZON	Description de fuseau horaire	Nom	Obligatoire, positionnel 1
OFFSET	Décalage	-840-840	Obligatoire, positionnel 2
STDNAME	Heure standard	Valeurs uniques: 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: 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	Facultatif
DSTMSG	Message période d'heure d'été	Nom	Facultatif
MSGF	fichier message	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	JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
	Élément 2: Jour	MON, TUE, WED, THU, FRI, SAT, *SUN
	Élément 3: Jour relatif du mois	*LAST, 1, 2, 3, 4
	Élément 4: Heure	Heure
DSTEND	Fin période de l'heure d'été	Liste d'éléments	Facultatif
	Élément 1: Mois	JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
	Élément 2: Jour	MON, TUE, WED, THU, FRI, SAT, *SUN
	Élément 3: Jour relatif du mois	*LAST, 1, 2, 3, 4
	Élément 4: Heure	Heure
DSTSHIFT	Décalage de l'heure d'été	0-120, 60	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif
YEAROFS	Décalage de l'année	-140-140, 0	Facultatif
ALTNAME	Autre nom	Valeur caractère	Facultatif
AUT	Droits	Nom, USE, LIBCRTAUT, CHANGE, ALL, *EXCLUDE	Facultatif

Description de fuseau horaire (TIMZON)

Indique la description de fuseau horaire à créer. La description de fuseau horaire est créée dans QSYS.

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.

Ce paramètre est obligatoire.

-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

*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, les valeurs pour les paramètres STDMSG et MSGF (fichier message) doivent également être spécifiées.

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.

Valeurs uniques

*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, les valeurs pour les paramètres DSTMSG et MSGF (fichier message) doivent également être spécifiées.

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. Ce paramètre doit être spécifié lorsque *MSG est indiqué pour le paramètre STDNAME (Heure standard).

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. Ce paramètre doit être spécifié lorsque *MSG est indiqué pour le paramètre DSTNAME (Période de l'heure d'été (DST)).

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. Ce paramètre doit être spécifié lorsque *MSG est indiqué pour le paramètre STDNAME (Heure standard) ou DSTNAME (Période de l'heure d'été (DST)).

Qualificatif 1 : fichier message

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. Ce paramètre doit être spécifié lorsqu'une valeur autre que *NONE est indiquée pour le paramètre DSTNAME (Période de l'heure d'été (DST)). Les valeurs spécifiées pour ce paramètre et les valeurs spécifiées pour le paramètre DSTEND (Fin période de l'heure d'été) ne peuvent pas être identiques.

Elément 1 : Mois

*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

*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

*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

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. Ce paramètre doit être spécifié lorsqu'une valeur autre que *NONE est indiquée pour le paramètre DSTNAME (Période de l'heure d'été (DST)). Les valeurs spécifiées pour ce paramètre et celles indiquées au paramètre DSTSTR (Début période de l'heure d'été) ne peuvent pas être identiques.

Elément 1 : Mois

*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

*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

*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

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é.

60: L'heure d'été avance de 60 minutes au début de la période et recule de 60 minutes en fin de période.
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.

*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).

0: Ce fuseau horaire est utilisé avec le calendrier grégorien.
-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. 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.

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

Droits (AUT)

Indique le droit que vous accordez aux utilisateurs ne disposant d'aucun droit spécifique sur l'objet, ne figurant pas sur une liste d'autorisation et dont le profil de groupe ne dispose d'aucun droit spécifique sur l'objet.

*USE: L'utilisateur peut effectuer des opérations de base sur la description de fuseau horaire, telle que l'extraction du contenu. L'utilisateur ne peut pas modifier la description de fuseau horaire. Le droit *USE fournit un droit d'opération sur l'objet, un droit de lecture et un droit d'exécution.
*LIBCRTAUT: Le droit sur l'objet provient de la valeur indiquée pour le paramètre CRTAUT (Droits pour objets créés) de la bibliothèque dans laquelle a été créé l'objet. Si la valeur indiquée pour le paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.
*CHANGE: Le droit de modification permet à l'utilisateur de modifier l'objet et d'effectuer des opérations de base sur celui-ci. L'utilisateur peut effectuer toutes les opérations sur l'objet, sauf celles réservées au propriétaire ou celles contrôlées par le droit d'existence sur l'objet ou le droit de gestion de l'objet. Le droit de modification fournit le droit d'opération sur l'objet et les droits sur les données.
*ALL: L'utilisateur effectue toutes les opérations sur l'objet, sauf celles réservées au propriétaire.
*EXCLUDE: L'utilisateur ne peut pas accéder à l'objet.
nom: Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

Exemple 1 : création d'une description de fuseau horaire

CRTTIMZON   TIMZON(CENTRAL) OFFSET(-360)
            STDNAME(CTZ 'Central Time Zone')
            TEXT('Central Time Zone with Standard Time Only')

Cette commande permet de créer la description de fuseau horaire CENTRAL. Le décalage horaire est de moins six heures (-360 minutes). Le nom abrégé de l'heure standard du fuseau horaire est 'CTZ' et son nom complet est 'Central Time Zone'. Le texte descriptif associé à l'objet de la description de fuseau horaire est Central Time Zone with Standard Time Only. Ce fuseau horaire n'applique pas l'heure d'été.

Exemple 2 : création d'une description de fuseau horaire qui prend en charge l'heure d'été

CRTTIMZON   TIMZON(CENTRALDST) OFFSET(-360)
            STDNAME(CTZ 'Central Time Zone')
            DSTNAME(CDTZ 'Central Daylight Time Zone')
            TEXT('Central Time Zone with Daylight Saving Time')
            DSTSTR(*MAR *SUN 2 '02:00:00')
            DSTEND(*NOV *SUN 1 '02:00:00')
            ALTNAME('America/Chicago')

Cette commande permet de créer la description de fuseau horaire CENTRALDST. Le décalage horaire est de moins six heures (-360 minutes). Le nom abrégé de l'heure standard du fuseau horaire est 'CTZ' et son nom complet est 'Central Time Zone'. Le nom abrégé de l'heure d'été du fuseau horaire est 'CDTZ' et son nom complet est 'Central Daylight Time Zone'. Le texte descriptif associé à l'objet de la description de fuseau horaire est 'Central Time Zone with Daylight Time Only'. Ce fuseau horaire applique l'heure d'été. L'heure d'été commence à 2:00 le second dimanche de mars et se termine le 2:00 le premier dimanche de novembre. L'autre nom du fuseau horaire est 'America/Chicago'.

Exemple 3: Création d'une description de fuseau horaire pour un calendrier non grégorien

CRTTIMZON   TIMZON(SAMPLETIMZ) OFFSET(+420)
            STDNAME(*GEN) DSTNAME(*NONE)
            TEXT('Time Zone for Thai Buddhist Calendar')
            YEAROFS(-57)

Cette commande permet de créer la description de fuseau horaire SAMPLETIMZ, exploitable avec le calendrier chinois. Le décalage horaire est de plus sept heures (+420 minutes) et la description de fuseau horaire n'adopte pas l'heure d'été. L'année 2006 du calendrier grégorien correspond à l'année 2549 du calendrier chinois. De nombreux systèmes ont par conséquent fonctionné dans l'année 1949 alors que l'année grégorienne était 2006, ce qui représente une différence de moins 57 ans (1949 moins 2006).

Messages d'erreur

Messages *ESCAPE

CPF09A1: Description de fuseau horaire &1 non créée.