SYS_DATE_PHYSICAL
Fonction de script : Renvoie la date courante.
Syntaxe
SYS_DATE_PHYSICAL ([Date Format][,TimeZone])
Syntaxe |
Description / format |
---|---|
Date Format |
Format prédéfini de la date déterminée. |
TimeZone |
Nom d'un objet fuseau horaire ou mot clé UTC |
Code retour |
---|
Date courante au format indiqué. |
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 la date est optionnel. 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 optionnel. 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 rapport d'activation.
:SET &DATE# = SYS_DATE_PHYSICAL('YYYY-MM-DD','TZ.MEZ')
:PRINT &DATE#
Voir aussi :