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

SYS_DATE_PHYSICAL

Fonction de script : Détermine la date courante.

Syntaxe

SYS_DATE_PHYSICAL([Format de Format de date], [Fuseau horaire])

Syntaxe	Description / format
Format de date	Format prédéfini de la date déterminée. Format : littéral de script ou variable de script Valeur par défaut : "AAMMJJ"
Fuseau horaire	Nom d'un objet fuseau horaire ou mot clé UTC. Format : littéral de script ou variable de script

Code retour
Date courante au format indiqué.

Remarques

La fonction de script détermine la date courante. Un fuseau horaire indiqué comme paramètre est inclus.

Si la fonction de script est utilisée plusieurs fois dans un script, des résultats différents peuvent être obtenus (par exemple, à cause d'un changement de date entre la première et la deuxième exécution). La fonction de script est donc différente de SYS_DATE, qui détermine l'heure courante au début du traitement du script, puis la "gèle" pour garantir la cohérence de celui-ci.

Le format de date est facultatif. Il sert à déterminer le format dans lequel la fonction doit renvoyer sa valeur. Si vous n'avez pas indiqué de format de date, le format par défaut "AAMMJJ" est renvoyé.

Le fuseau horaire est également facultatif. Si la fonction de script est exécutée sans ce paramètre, le fuseau horaire de l'objet est utilisé ou celui du client si aucun fuseau horaire n'a été défini pour cet objet. Si un fuseau horaire non défini a été indiqué, le calcul se fait automatiquement avec la valeur par défaut (fuseau horaire du client). Au lieu d'un fuseau horaire, vous pouvez également utiliser le mot clé UTC. La date est alors retournée en UTC (Temps Universel Coordonné).

Exemples

Le premier exemple détermine la date et transmet la valeur à une variable de script. Le deuxième exemple doit montrer qu'il est possible de saisir des paramètres spéciaux. Le jour de la semaine est déterminé et utilisé comme paramètre de fonction d'une variable de script.

:SET &DATE# = SYS_DATE_PHYSICAL('DD.MM.YYYY')

:SET &FORMAT# = 'WW'
:SET &WEEKDAY# = SYS_DATE_PHYSICAL(&FORMAT#)

Si la fonction est utilisée sans indiquer de format de date, la syntaxe se présente comme dans l'exemple suivant.

:IF SYS_DATE_PHYSICAL() = '990101'
!...
:ENDIF

Dans le troisième exemple, la date courante est déterminée. Un fuseau horaire défini pour l'heure d'Europe centrale est utilisé. Le résultat s'affiche dans le protocole d'activation.

:SET &DATE# = SYS_DATE_PHYSICAL('YYYY-MM-DD','TZ.MEZ')
:PRINT &DATE#

Rubriques connexes :

Elément de script	Description
CONV_DATE	Convertit le format d'une date.
DIFF_DATE	Détermine la différence entre deux dates en jours.
SYS_LDATE	Retourne la date logique.
SYS_DATE	Retourne la date courante au début du traitement de script.

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