DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des dates et des heures
  • Validité de la date
  • Format de date
  • Cas particulier : le paramètre n'est pas spécifié
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Formate la date spécifiée au format spécifié.
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.
Exemple
MaDate est une Date
MaDate = "20191225"
Res = MaDate.VersChaîne()  // Res = "25/12/2019"
Res = MaDate.VersChaîne("MM-JJ-AAAA") // Res = "12-25-2019"
Res = MaDate.VersChaîne("Le numéro du jour JJ du mois n° MM de l'année AAAA")
MaDate = DateSys()
Res = MaDate.VersChaîne(maskDateSystème)
// Res utilise le format défini dans le projet
MaDate est une Date
MaDate = "20031202"
// La casse des jours et mois en lettres est dépendante des options linguistiques du projet
Res = MaDate.VersChaîne("JJJ JJ MMM AAAA")
// Res = "mar. 02 déc. 2003" ou "Mar. 02 Déc. 2003"
Res = MaDate.VersChaîne("JJJJ JJ MMMM AAAA")
// Res = "mardi 02 décembre 2003" ou "Mardi 02 Décembre 2003"
//--------
// La casse des jours et des mois est forcée avec une majuscule
Res = MaDate.VersChaîne("Jjj JJ Mmm AAAA") // Res = "Mar. 02 Déc. 2003"
Res = MaDate.VersChaîne("Jjjj JJ Mmmm AAAA") // Res = "Mardi 02 Décembre 2003"
MaDate est une Date
MaDate = "20191125"
Res = MaDate.VersChaîne(maskDateEmail)
// Renvoie "Mon, 25 Nov 2019 00:00:00 +0100"
Res = MaDate.VersChaîne(maskDateEmail)  
// Renvoie "Sun, 25 Aug 2019 00:00:00 +0200"
MaDate est une Date
MaDate = "20121125"
Res = MaDate.VersChaîne(maskDateEmail)
// Renvoie "Sun, 25 Nov 2012 00:00:00 +0100"
Res = MaDate.VersChaîne(maskDateEmail)  
// Renvoie "Sat, 25 Aug 2012 00:00:00 +0200"
MaDate est une Date
MaDate = "20190101"
// A la date du 22/01/2019
Res = MaDate.VersChaîne(maskDateDuréeRelative)
// Renvoie : il y a 3 semaines
Res = MaDate.VersChaîne(maskDateDuréeRelative)
// Renvoie : dans 10 mois
Res = MaDate.VersChaîne(maskDateDuréeRelative)
// Renvoie : la semaine dernière
Syntaxe

Convertir une date en chaîne Masquer les détails

<Résultat> = <Date>.VersChaîne([<Format>])
<Résultat> : Chaîne de caractères
Chaîne de caractères au format spécifié.
<Date> : Variable de type Date
Nom de la variable de type Date à convertir.
<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)
    PHP Cette notation n'est pas disponible.
  • mmm représente le mois en lettres sur 3 caractères avec la première lettre forcée en minuscule (par exemple jan)
    PHP Cette notation n'est pas disponible.
  • MMMM représente le mois en lettres complet (par exemple janvier). La casse utilisée dépend des options linguistiques du projet.
    PHP Cette notation n'est pas disponible.
  • mmmm représente le mois en lettres complet avec la première lettre forcée en minuscule (par exemple janvier)
    PHP Cette notation n'est pas disponible.
  • 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)
    PHP Cette notation n'est pas disponible.
  • jjj représente le jour en lettres sur 3 caractères avec la première lettre forcée en minuscule (par exemple lun)
    PHP Cette notation n'est pas disponible.
  • 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).
    PHP Cette notation n'est pas disponible.
  • jjjj représente le jour en lettres complet avec la première lettre forcée en minuscule (par exemple lundi).
    PHP Cette notation n'est pas disponible.
  • 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éeRelativeLe 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 :
    1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
    2. Dans l'onglet "Langues" :
      • sélectionnez la langue à configurer.
      • sélectionnez l'onglet "Date".
    3. Cliquez sur le bouton "Dates et Heures en langage naturel".
    4. Définissez les libellés personnalisés à utiliser si nécessaire. Ces libellés seront utilisés :
      • pour le résultat de la fonction <Type Date>.VersChaîne.
      • pour les champs utilisant le masque d'affichage "Durée relative".
    WEBDEV - Code Navigateur Non disponible.
    maskDateEmailLe 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.
    WEBDEV - Code NavigateurAndroidJavaPHP Non disponible.
    maskDateEmailUTCLe 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).
    WEBDEV - Code NavigateurAndroidJavaPHP Non disponible.
    maskDateInternetLe 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.
    maskDateInternetUTCLe 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).
    WEBDEV - Code Navigateur Non disponible.
    maskDateSystèmeLe format utilisé correspond au format défini dans la description du projet pour la langue en cours :
    1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
    2. Sélectionnez l'onglet "Langues" puis l'onglet "Date".
    3. 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.
Les calculs sur les dates réalisés avec les fonctions WLangage ou les propriétés WLangage sont fiables à partir du 1er Janvier 1583.

Format de date

La fonction <Type Date>.VersChaî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 <Type Chaîne Ansi>.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 :
  1. Affichez la description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. 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.
Composante : wd290std.dll
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale