4D Doc Center : Date

4D v13.4

Date


Date ( chaîneDate ) -> Résultat

Paramètre	Type	Description
chaîneDate	Chaîne	Chaîne contenant la date à retourner
Résultat	Date	chaîneDate sous forme de Date

Description

La fonction Date extrait et retourne la date de la chaîne chaîneDate.

Le paramètre chaîneDate doit respecter soit le format date ISO, soit les paramètres régionaux du système.

Format Date ISO
La chaîne doit comporter 13 caractères et être formatée de la manière suivante : "AAAA-MM-JJTHH:MM:SS", par exemple "2013-11-20T10:20:00". Dans ce cas, Date évaluera correctement chaîneDate, quels que soient les réglages de langue courants.
Si le format de chaîneDate ne respecte pas exactement ce schéma ISO, la date sera évaluée comme un format date court dépendant des paramètres régionaux du système.

Paramètres régionaux
Si chaîneDate ne correspond pas au format ISO, les paramètres régionaux définis dans le système d'exploitation pour une date courte sont utilisés pour l'évaluation. Par exemple, dans une version française de 4D, la date doit être par défaut de la forme JJ/MM/AA (jour, mois, année). Le jour et le mois peuvent être composés d'un ou deux chiffres. L'année peut être composée de deux ou quatre chiffres. Si l'année comporte deux chiffres, Date considère que la date appartient au XXe ou au XXIe siècle en fonction de la valeur saisie. Par défaut, la valeur pivot est 30 :

si la valeur saisie est supérieure ou égale à 30, 4D considère que la date appartient au XXe siècle et ajoute 19 devant la valeur.
si la valeur saisie est inférieure à 30, 4D considère que la date appartient au XXIe siècle et ajoute 20 devant la valeur.

Ce mécanisme peut être modifié à l'aide de la commande SIECLE PAR DEFAUT.
Les caractères de séparation de date autorisés sont les suivants : barre oblique (/), espace, point (.), virgule (,) et tiret (-).
Date ne vérifie pas la validité de la date passée dans chaîneDate. Si une date erronée (telle que "13/35/94") est passée, Date retourne une date invalide. Si chaîneDate ne peut être interprétée comme une date (par exemple, "aa/12/94"), une date nulle (!00/00/00!) est retournée. Il est de votre ressort de tester la validité de chaîneDate.

Exemple 1

L'exemple suivant demande à l'utilisateur de saisir une date. La chaîne saisie est convertie en date et stockée dans la variable DemDate :

 DemDate:=Date(Demander("Saisissez une date :";Chaine(Date du jour)))

 Si(OK=1)

  ` Faire quelque chose avec la date

 Fin de si

Exemple 2

L'exemple suivant retourne la chaîne "25/12/97" sous forme de date :

vDate:=Date("25/12/97")

Exemple 3

Evaluation d'une date à partir d'une date au format ISO :

 $vtDateISO:="2013-06-05T20:00:00"

 $vDate:=Date($vtDateISO)

     //$vDate représente le 5 juin 2013 quelle que soit la langue du système