|
|
|
|
|
|
|
|
|
|
- Validité de la date
- Format de date
- Cas particulier : le paramètre n'est pas spécifié
DateVersChaîne (Fonction) En anglais : DateToString Convertit : - une date en une chaîne au format spécifié.
 une date heure en une chaîne au format spécifié.
La fonction DateHeureVersChaîne permet également de convertir une date heure vers une chaîne avec un format spécifique.
Conseil : Si la date formatée contient les caractères séparateurs "/", il ne faut pas l'afficher dans un champ de saisie de type Date.
Res = DateVersChaîne("20191225")
Res = DateVersChaîne(EntierVersDate(73773))
DateVersChaîne("")
Res = DateVersChaîne("20191225", "MM-JJ-AAAA")
Res = DateVersChaîne("20791225", "Le numéro du jour JJ du mois n° MM de l'année AAAA")
Res = DateVersChaîne(DateSys(), maskDateSystème)
Res = DateVersChaîne("20031202", "JJJ JJ MMM AAAA")
Res = DateVersChaîne("20031202", "JJJJ JJ MMMM AAAA")
Res = DateVersChaîne("20031202", "Jjj JJ Mmm AAAA")
Res = DateVersChaîne("20031202", "Jjjj JJ Mmmm AAAA")
Res = DateVersChaîne("20191125", maskDateEmail)
Res = DateVersChaîne("20190825", maskDateEmail)
Res = DateVersChaîne("20191125", maskDateEmailUTC)
Res = DateVersChaîne("20190825", maskDateInternet)
Res = DateVersChaîne("20190825", maskDateInternetUTC)
Res = DateVersChaîne("20190101", maskDateDuréeRelative)
Res = DateVersChaîne("20191125", maskDateDuréeRelative)
Res = DateVersChaîne("20190118", maskDateDuréeRelative)
Syntaxe
Convertir une date en chaîne Masquer les détails
<Résultat> = DateVersChaîne(<Date> [, <Format>])
<Résultat> : Chaîne de caractères Chaîne de caractères au format spécifié. <Date> : Chaîne de caractères, variable de type Date Date à convertir. Si cette date correspond à une chaîne, elle doit être au format AAAAMMJJ (AAAA correspond à l'année, MM au mois et JJ au jour). <Format> : Chaîne de caractères optionnelle Format de la date convertie. Ce paramètre peut contenir un mot, une phrase, ... Les caractères spécifiques représentant les différents éléments de la date (AAAA, AA, MM ou JJ) seront automatiquement remplacés par leur valeur identifiée dans la chaîne <Date>. Dans cette chaîne :- AAAA représente l'année sur 4 positions,
- AA représente l'année sur 2 positions.
- M représente le mois (le zéro n'est pas affiché devant le numéro du mois),
- MM représente le mois sur 2 chiffres,
- MMM représente le mois en lettres sur 3 caractères (par exemple jan). La casse utilisée dépend des options linguistiques du projet.
- Mmm représente le mois en lettres sur 3 caractères avec la première lettre forcée en majuscule (par exemple Jan)
- mmm représente le mois en lettres sur 3 caractères avec la première lettre forcée en minuscule (par exemple jan)
- MMMM représente le mois en lettres complet (par exemple janvier). La casse utilisée dépend des options linguistiques du projet.
- mmmm représente le mois en lettres complet avec la première lettre forcée en minuscule (par exemple janvier)
- J représente le jour (le zéro n'est pas affiché devant le numéro du jour),
- JJ représente le jour sur 2 chiffres,
- JJJ représente le jour en lettres sur 3 caractères (par exemple lun). La casse utilisée dépend des options linguistiques du projet.
- Jjj représente le jour en lettres sur 3 caractères avec la première lettre forcée en majuscule (par exemple Lun)
- jjj représente le jour en lettres sur 3 caractères avec la première lettre forcée en minuscule (par exemple lun)
- JJJJ représente le jour en lettres complet (par exemple lundi). La casse utilisée dépend des options linguistiques du projet.
- Jjjj représente le jour en lettres complet avec la première lettre forcée en majuscule (par exemple Lundi).
- jjjj représente le jour en lettres complet avec la première lettre forcée en minuscule (par exemple lundi).
- L représente la première lettre du jour (par exemple L,M,M,J,V,S,D).
Si ce paramètre correspond à la constante : | | | maskDateDuréeRelative | Le format utilisé permet d'exprimer la durée écoulée (ou à venir) entre la date du jour et la date spécifiée. Ce format est exprimé en langage naturel. Les différentes formulations utilisées sont configurables dans la description du projet pour la langue en cours :- Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
- Dans l'onglet "Langues" :
- sélectionnez la langue à configurer.
- sélectionnez l'onglet "Date".
- Cliquez sur le bouton "Dates et Heures en langage naturel".
- Définissez les libellés personnalisés à utiliser si nécessaire. Ces libellés seront utilisés :
- pour le résultat de la fonction DateVersChaîne.
- pour les champs utilisant le masque d'affichage "Durée relative".
| | maskDateEmail | Le format utilisé correspond au format de date de la norme RFC-5322 utilisé pour l'encryption d'un mail, d'un flux RSS, ...
Le résultat est exprimé dans le fuseau horaire local. | | maskDateEmailUTC | Le format utilisé correspond au format de date de la norme RFC-5322 utilisé pour l'encryption d'un mail, d'un flux RSS, ...
Le résultat est exprimé en temps universel (UTC). | | maskDateInternet | Le format utilisé correspond au format de date de la norme RFC-3339 utilisé pour les communications internationales.
Le résultat est exprimé dans le fuseau horaire local. | | maskDateInternetUTC | Le format utilisé correspond au format de date de la norme RFC-3339 utilisé pour les communications internationales.
Le résultat est exprimé en temps universel (UTC). | | maskDateSystème | Le format utilisé correspond au format défini dans la description du projet pour la langue en cours : - Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
- Sélectionnez l'onglet "Langues" puis l'onglet "Date".
- Le format utilisé correspond :
- soit aux paramètres du système d'exploitation,
- soit aux paramètres spécifiés (avec les jours et mois définis).
|
Si ce paramètre n'est pas spécifié, le format utilisé par défaut est JJ/MM/AAAA.
Remarques Validité de la date La validité de la date passée en paramètre est vérifiée. Un message est affiché en cas de date invalide. Il est possible de tester la validité d'une date avec la fonction DateValide.
Le format de stockage des dates permet de stocker des dates comprises entre le 01/01/0001 et le 31/12/9999. Format de date La fonction DateVersChaîne permet de formater une date retournée par la fonction EntierVersDate ou la fonction DateSys. Le résultat pourra par exemple être affecté à un champ de type texte. Pour obtenir la date sous un autre format, il faut utiliser les fonctions Droite, Gauche, Milieu, etc. Cas particulier : le paramètre <Format> n'est pas spécifié Les options linguistiques spécifiées pour les dates dans la description du projet sont prises en compte si aucun format spécifique n'est défini. Pour afficher les options linguistiques du projet : - Affichez la description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
- Sélectionnez l'onglet "Langues".
Par exemple : - si le projet utilise les options linguistiques de Windows pour les dates, sur un poste utilisant Windows en Français, les jours de la semaine et les mois commenceront par défaut avec une minuscule.
- si le projet utilise des paramètres spécifiques pour les dates pour une ou plusieurs langues (nom du jour ou du mois personnalisés, ...), ces paramètres seront pris en compte pour la langue spécifiée.
Liste des exemples associés :
|
Exemples unitaires (WINDEV) : Gestion des dates
[ + ] Utilisation du type Date du WLangage et des fonctions de manipulations de dates.
|
Classification Métier / UI : Code neutre Composante : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|