4D Doc Center : Date

4D v14.3

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 ê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. Les décimales de secondes, précédées d'un point, sont prises en charge (ex : "2013-11-20T10:20:00.9854").
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.

Note : A compter de 4D v14, il est conseillé d'utiliser le format "AAAA-MM-JJTHH:MM:SSZ", conforme à la norme ISO et permettant d'exprimer le fuseau horaire.

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 (-).
Si une date invalide (telle que "13/35/94" ou "aa/12/94") est passée dans chaîneDate, Date retourne une date nulle (!00/00/00!). 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