CONV_TIMESTAMP

La fonction de script CONV_TIMESTAMP permet de convertir la date et l'heure dans un autre fuseau horaire, en utilisant le format AAAA-MM-JJ HH:MM:SS.

Syntaxe

CONV_TIMESTAMP (Timestamp,[TimeZone1][,TimeZone2])

Paramètres

• CONV_TIMESTAMP
  Convertit la date et l'heure dans un autre fuseau horaire.
• Timestamp
  Horodatage à partir de la date et de l'heure au format AAAA-MM-JJ HH:MM:SS
  Format : littéral de script ou variable de script
• TimeZone1
  Nom d'un objet fuseau horaire ou mot clé UTC.
  Fuseau horaire attribué à l'horodatage ou UTC. Il définit le fuseau horaire d'origine servant de base au calcul.
  Format : littéral de script ou variable de script
  Défaut : UTC
• (Optionnel) TimeZone2
  Nom d'un objet fuseau horaire.
  Fuseau horaire selon lequel l'horodatage doit être converti.
  Format : littéral de script ou variable de script
  Défaut : Fuseau horaire défini pour l'objet. Si l'objet n'inclut pas de définition de fuseau horaire, c'est le fuseau horaire du client qui est utilisé.

Code retour

La fonction de script renvoie l'horodatage au format AAAA-MM-JJ HH:MM:SS.

Important ! Si la base de calcul n'est pas l'UTC, le résultat de la conversion ne sera pas précis lorsque vous passez de l'heure d'été à l'heure d'hiver. Exemple : Le système ne peut pas identifier si l'heure 02:30:00 se réfère à sa première occurrence en heure d'été ou à sa seconde occurrence en heure d'hiver. Il la lit donc comme sa première occurrence. Pour de plus amples informations, voir Passages à l'heure d'été et à l'heure d'hiver

Exemple

L'exemple suivant illustre la conversion de l'horodatage pour le passage de l'année 2017 à 2018. TimeZone1 applique le fuseau horaire défini pour Sydney, Australie (TZ.SYD). Ce fuseau horaire doit être converti en CET, définie avec TimeZone2 (TZ.CET). Le résultat, 2017-12-31 14:00:00 s'affiche dans le rapport d'activation.

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

Voir aussi :