Valeur système IBM i (AS/400) · Date et heure
QDATETIME
Date et heure système en une seule valeur
Regroupe la date et l'heure locales du système en une chaîne unique, pratique pour lire ou régler l'horloge d'un seul geste.
À quoi elle sert
QDATETIME est la vue combinée de la date (QDATE) et de l'heure (QTIME) dans l'interface en mode caractère. Elle se présente sous la forme AAAAMMJJHHMMSS suivie de six chiffres de microsecondes.
Elle intéresse l'exploitant qui doit corriger l'horloge, l'auditeur qui compare les horodatages du journal d'audit et le développeur qui veut une date et une heure cohérentes en une seule lecture. IBM conseille de l'utiliser dès qu'il faut lire ou changer la date et l'heure ensemble, et de ne passer par QDATE ou QTIME que pour une seule des deux.
Les valeurs possibles
| Valeur | Signification |
|---|---|
AAAAMMJJHHMMSSXXXXXX | Année, mois, jour, heure, minute, seconde et microsecondes de l'heure locale. |
Plage de dates | Le système accepte des dates du 24 août 1928 au 7 juin 2062. |
Prise en compte : Immédiate. Le droit spécial *ALLOBJ est nécessaire.
La valeur recommandée
Ne réglez pas l'horloge à la main sur un système de production : mettez en place une synchronisation sur une source de temps externe (voir QTIMADJ) et laissez QTIMZON gérer le fuseau et l'heure d'été.
Si un recalage est inévitable, IBM recommande un ajustement d'heure (jusqu'à 2 heures) plutôt qu'une modification directe : l'ajustement évite qu'un instant soit sauté ou répété.
La changer
CHGSYSVAL SYSVAL(QDATETIME) VALUE('20261015093000000000')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 = 'QDATETIME'Le piège
Un changement brutal d'horloge fausse les horodatages : journaux, travaux planifiés, récepteurs de journaux. Sur un système qui passe à l'heure d'été, il est impossible de saisir une heure comprise dans l'heure sautée par le changement d'heure.