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 heure
  • Format date heure
  • 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
Convertit une date heure en une chaîne au format spécifié.
Conseil : Il ne faut pas affecter la valeur de retour de cette fonction à un champ de saisie de type "Date" (avec un masque de saisie comprenant la date et l'heure) qui attend une chaîne sans séparateur (exemple : "202004281500").
Exemple
MaDateHeure est une DateHeure
 
MaDateHeure = "201912251715"
Res = MaDateHeure.VersChaîne() // Res = "25/12/2019 17:15:00:00"
 
MaDateHeure = RéelVersDateHeure(73773,5)
Res = MaDateHeure.VersChaîne() // Res = "25/12/2001 00:00:00:00"
 
MaDateHeure = "201912251715"
Res = MaDateHeure.VersChaîne("MM-JJ-AAAA HH:mm") // Res = "12-25-2019 17:15"
 
MaDateHeure = "207912251715"
Res = MaDateHeure.VersChaîne(...
"Le numéro du jour JJ du mois n° MM de l'année AAAA à HH heures et mm minutes")
 
MaDateHeure = DateHeureSys
Res = MaDateHeure.VersChaîne((), maskDateSystème)
// Res utilise le format défini dans le projet
 
// La casse des jours et mois en lettres est dépendante des options linguistiques du projet
MaDateHeure = "202012021715"
Res = MaDateHeure.VersChaîne("JJJ JJ MMM AAAA HH:mm")
// Res = "mer. 02 déc. 2020 17:15" ou "Mer. 02 Déc. 2020 17:15"
 
MaDateHeure = "202012021715"
Res = MaDateHeure.VersChaîne("JJJJ JJ MMMM AAAA HH:mm")
// Res = "mercredi 02 décembre 2020 17:15" ou "Mercredi 02 Décembre 2020 17:15"
 
// La casse des jours et des mois est forcée avec une majuscule
MaDateHeure = "202012021715"
Res = MaDateHeure.VersChaîne("Jjj JJ Mmm AAAA HH:mm")
// Res = "Mer. 02 Déc. 2020 17:15"
 
Res = MaDateHeure.VersChaîne("202012021715", "Jjjj JJ Mmmm AAAA HH:mm")
// Res = "Mercredi 02 Décembre 2020 17:15"
 
MaDateHeure = "201911251715"
Res = MaDateHeure.VersChaîne(maskDateEmail)
// Renvoie "Mon, 25 Nov 2019 17:15:00 +0100"
 
MaDateHeure = "201908251715"
Res = MaDateHeure.VersChaîne(maskDateEmail)  
// Renvoie "Sun, 25 Aug 2019 17:15:00 +0200"
 
MaDateHeure = "201911250015"
Res = MaDateHeure.VersChaîne(maskDateEmailUTC)
// Renvoie "Sun, 24 Nov 2019 23:15:00 +0000"
 
MaDateHeure = "201908251715"
Res = MaDateHeure.VersChaîne(maskDateInternet)  
// Renvoie "2019-08-25T17:15:00.000+02:00"
 
MaDateHeure = "201908250015"
Res = MaDateHeure.VersChaîne(maskDateInternetUTC)  
// Renvoie "2019-08-24T22:15:00.000Z"
 
// A la date du 02/09/2020 à 11:00
MaDateHeure = "202001011715"
Res = MaDateHeure.VersChaîne(maskDateDuréeRelative)
// Renvoie : il y a 8 mois
MaDateHeure = "202011251715"
Res = MaDateHeure.VersChaîne(maskDateDuréeRelative)
// Renvoie : l'année prochaine
MaDateHeure = "202001181715"
Res = MaDateHeure.VersChaîne(maskDateDuréeRelative)
// Renvoie : dans 6 heures
Syntaxe
<Résultat> = <Donnée à convertir>.VersChaîne([<Format>])
<Résultat> : Chaîne de caractères
Chaîne de caractères au format spécifié.
<Donnée à convertir> : Variable de type DateHeure
Date et heure locale à convertir. Peut correspondre à :
  • une variable de type DateHeure.
  • une chaîne de caractères à un des formats suivants :
    • AAAAMMJJHHmmSSCCC
    • AAAAMMJJHHmmSSCC
    • AAAAMMJJHHmmSS
    • AAAAMMJJHHmm
    • AAAAMMJJHH
    • AAAAMMJJ
Ce paramètre sera considéré invalide dans les cas suivants :
  • si la date est invalide ou antérieure au 01/01/1970. La validité de la date peut être vérifiée avec la fonction DateValide.
  • si l'heure est invalide. La validité de l'heure peut être vérifiée avec la fonction HeureValide.
Remarque : Il est possible d'utiliser des dates au-delà de l'année 2038.
<Format> : Chaîne de caractères optionnelle
Format de la date et de l'heure converties. Ce paramètre peut contenir un mot, une phrase, ... Les caractères spécifiques représentant les différents éléments de la date et de l'heure seront automatiquement remplacés par leur valeur identifiée dans la chaîne <Donnée à convertir>. 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 majuscule (par exemple Janvier)
  • 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)
  • HH représente le nombre d'heures,
  • mm représente le nombre de minutes,
  • SS représente le nombre de secondes,
  • CC représente le nombre de centièmes de seconde,
  • CCC représente le nombre de millièmes de seconde,
  • AP représente "AM" ou "PM" (si "AP" est présent dans le format, l'heure est affichée sur 12 heures).
Si ce paramètre correspond à la constante :
maskDateDuréeRelativeLe format utilisé permet d'exprimer la durée écoulée (ou à venir) entre la date heure du jour et la date heure 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 DateHeure>.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 heure 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 heure 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 heure 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 heure 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 de la date 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).
  4. Sélectionnez l'onglet "Langues" puis l'onglet "Heure".
  5. Le format de l'heure 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 HH:mm:SS:CC.
Remarques

Validité de la date heure

La validité de la date heure passée en paramètre est vérifiée. Un message d'erreur fatale est affiché en cas de date heure invalide. Il est possible de tester la validité d'une date heure avec la fonction DateHeureValide. Le format de stockage des dates heure permet de stocker des dates heure comprises entre le 01/01/0001 00:00:00:00 et le 31/12/9999 23:59:59:99.
Les calculs sur les dates heure réalisés avec les fonctions WLangage ou les propriétés WLangage sont fiables à partir du 1er Janvier 1583 00:00:00:00.

Format date heure

La fonction <Type DateHeure>.VersChaîne permet de formater une date heure retournée par la fonction RéelVersDateHeure ou par la fonction DateHeureSys. Le résultat pourra par exemple être affecté à un champ de type texte.
Pour obtenir la date heure 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 et heures 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 : wd300std.dll
Version minimum requise
  • Version 28
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