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

SUB_TIMESTAMP

Fonction de script : Soustrait une durée à partir d'un horodatage.

Syntaxe

SUB_TIMESTAMP (Time Stamp,Time)

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

Heure

Heure ("HH:MM:SS") devant être soustraite de l'horodatage.
Format : littéral de script ou variable de script

Valeurs autorisées : 0 à 99 (pour les HH, MM et SS)

Code retour

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

Commentaires

Cette fonction de script soustrait l'heure au format "HH:MM:SS" d'un horodatage indiqué au format "AAAA-MM-JJ HH:MM:SS".

Il est pour cela calculé selon l'UTC : les heures d'été et d'hiver ne sont pas prises en compte. Etant donné que les heures, les minutes et les secondes ne peuvent pas dépasser la valeur maximale de 99, le résultat de la fonction de script peut être légèrement supérieur à 4 jours avant l'horodatage d'origine.

Exemple

L'exemple soustrait une seconde de l'horodatage. Le résultat "2003-12-31 23:59:59" est affiché dans le protocole d'activation.

:SET &RET# = SUB_TIMESTAMP("2004-01-01 00:00:00", "00:00:01")
:PRINT &RET#

 

Rubriques connexes :

Eléments de script - Date et heure

Formats de date, d'heure et de période

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