Manuel des Scripts Automation Engine > Organisation fonctionnelle > Date et heure > CONV_TIMESTAMP

CONV_TIMESTAMP

Fonction de script : Convertit la date et l'heure pour un autre Fuseau horaire.

Syntaxe

CONV_TIMESTAMP(Time Stamp, [TimeZone1], [TimeZone2])

Syntaxe

Description / format

Horodatage

Horodatage à partir de la date et de l'heure ("AAAA-MM-JJ HH:MM:SS").
Format : littéral de script ou variable de script

Fuseau horaire1

Nom d'un objet Fuseau horaire ou mot clé UTC.
Fuseau horaire ou UTC attribué à l'horodatage.

Format : littéral de script ou variable de script
Défaut : "UTC"

Fuseau horaire2

Nom d'un objet Fuseau horaire.
Fuseau horaire pour lequel l'horodatage doit être converti.

Format : littéral de script ou variable de script

Code retour

Horodatage au format "AAAA-MM-JJ HH:MM:SS".

Remarques

Cette fonction de script convertit la date et l'heure au format "AAAA-MM-JJ HH:MM:SS" pour un autre fuseau horaire.

Pour cela, le fuseau horaire précédent, à partir duquel commence le calcul, peut être indiqué par fuseau horaire1. Si le mot clé UTC est utilisé ou que ce paramètre est omis, l'UTC (Universal Time Coordinated) sert de base de calcul. Le fuseau horaire, pour lequel l'horodatage doit être converti, est désigné par fuseau horaire2. Si ce paramètre facultatif n'est pas indiqué, le fuseau horaire de l'objet ou du Client est utilisé lorsqu'aucun fuseau horaire n'a été défini pour l'objet lui-même.

Si l'UTC ne sert pas de base de calcul, la conversion de l'heure pour le passage de l'heure d'été à l'heure normale est imprécise. Elle est indétectable si la première ou la deuxième apparition de cette heure est 02:30:00, par exemple. AE part toujours de la première apparition de l'heure pendant le passage à l'heure normale.

Exemple

L'exemple illustre la conversion de l'horodatage pour le changement d'année 2003/2004. Le calcul illustre la conversion de l'heure australienne de Sydney à l'heure européenne. Le résultat "2003-12-31 14:00:00" est affiché dans le protocole d'activation.

:SET &MEZ# = CONV_TIMESTAMP("2004-01-01 00:00:00","TZ.SYD","TZ.MEZ")
:PRINT &MEZ#

 

Rubriques connexes :

Elément de script Description

CONV_DATE

Convertit le format d'une date.

Eléments de script - Date et heure

Heure

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle