Aller au contenu

Valeur système IBM i (AS/400) · Date et heure

QUTCOFFSET

Décalage de l'heure locale avec l'UTC

Donne l'écart en heures et minutes entre l'heure locale et l'UTC ; il est déduit de QTIMZON et ne se modifie pas.

À quoi elle sert

QUTCOFFSET indique de combien l'heure système est en avance (+) ou en retard (-) sur l'heure UTC, au format +hhmm ou -hhmm. Une valeur négative signifie à l'ouest de l'UTC, une valeur positive à l'est.

Les valeurs possibles vont de -12:59 à +13:59 (la documentation note le décalage sous la forme +00:00). Elle est déterminée par le fuseau QTIMZON et se met à jour d'elle-même quand le fuseau change. Elle sert aux programmes qui convertissent des horodatages locaux en UTC.

Les valeurs possibles

ValeurSignification
+hhmmHeure locale en avance sur l'UTC (est).
-hhmmHeure locale en retard sur l'UTC (ouest).
+0000Valeur livrée : aucun décalage.

Prise en compte : Immédiate, déduite de QTIMZON ; la valeur n'est pas modifiable.

La valeur recommandée

Ne cherchez pas à la fixer : réglez QTIMZON. Pour un traitement qui échange des horodatages avec l'extérieur, stockez de préférence des heures UTC calculées avec ce décalage.

L'afficher

DSPSYSVAL  SYSVAL(QUTCOFFSET)

Pour lire la valeur actuelle et celle de la livraison, en SQL :

SELECT SYSTEM_VALUE_NAME, SYSTEM_VALUE, SHIPPED_DEFAULT_VALUE
FROM QSYS2.SYSTEM_VALUE_INFO
WHERE SYSTEM_VALUE_NAME = 'QUTCOFFSET'

Le piège

Le décalage peut varier avec l'heure d'été définie dans le fuseau : ne le mémorisez pas en dur dans un programme, relisez-le à chaque besoin.