|
|
|
|
|
- Validité de la date heure
- Format date heure
- Cas particulier : le paramètre n'est pas spécifié
<Type DateHeure>.VersChaîne (Fonction) En anglais : <DateTime type>.ToString 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").
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éeRelative | Le 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 :- 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 <Type DateHeure>.VersChaîne.
- pour les champs utilisant le masque d'affichage "Durée relative".
| maskDateEmail | Le 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. | maskDateEmailUTC | Le 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). | maskDateInternet | Le 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. | maskDateInternetUTC | Le 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). | 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 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).
- Sélectionnez l'onglet "Langues" puis l'onglet "Heure".
- 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 : - 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.
Composante : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|