4D v14.3

Date

Accueil

 
4D v14.3
Date

Date 


 

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

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.

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

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

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

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

 
PROPRIÉTÉS 

Produit : 4D
Thème : Dates et heures
Numéro : 102
Nom intl. : Date

 
HISTORIQUE 

Créé : < 4D v6

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Hérité de : Date ( 4D v12.4)