DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des dates et des heures
  • Validité de l'heure
  • Format d'heure
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
HeureVersChaîne (Fonction)
En anglais : TimeToString
Convertit une heure en une chaîne au format spécifié.
Exemple
// Formater l'heure spécifiée selon le format "HH:MM:SS:CC"
HeureVersChaîne("12005956")   // Renvoie "12:00:59:56"
Gauche(HeureVersChaîne("12005956"), 5) // Renvoie "12:00"
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystJavaCode Utilisateur (MCU)PHPAjax
// Formater l'heure spécifiée selon le format "Il est : HH h MM"
HeureVersChaîne(Maintenant(), "Il est : HH h MM") // Renvoie "Il est : 12 h 32"
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystJavaCode Utilisateur (MCU)PHPAjax
DateAujourdhui est une Date = DateSys()
SAI_SaisieDate = DateVersJourEnLettre(DateAujourdhui) + " " + DateAujourdhui.Jour + ...
" " + DateVersMoisEnLettre(DateAujourdhui) + " à " + ...
HeureVersChaîne(HeureSys(), "HH:MM:SS")
// Le champ SAI_SaisieDate contient par exemple : Lundi 20 Août à 14:44:17
Syntaxe
<Résultat> = HeureVersChaîne(<Heure à convertir> [, <Format>])
<Résultat> : Chaîne de caractères
Chaîne de caractères au format spécifié.
<Heure à convertir> : Chaîne de caractères, variable de type Heure ou variable de type DateHeure
Heure à manipuler. Cette heure peut correspondre à :
  • une chaîne de caractères au format HHMMSSCC (HH correspond aux heures, MM aux minutes, SS aux secondes et CC aux centièmes de seconde).
  • une chaîne de caractères au format AAAAMMJJHHmmSSCC (AAAA correspond à l'année, MM au mois, JJ au jour, HH aux heures, mm aux minutes, SS aux secondes et CC aux centièmes de seconde). Dans ce cas, seule l'heure est prise en compte.
  • une variable de type Heure.
  • une variable de type DateHeure. Dans ce cas, seule l'heure est prise en compte.
<Format> : Chaîne de caractères optionnelle
Format à appliquer à l'heure. Ce paramètre correspond :
  • soit à une chaîne de caractères (une phrase par exemple). Les caractères spécifiques représentant les différents éléments de l'heure (HH, MM, SS, CC ou AP) seront automatiquement remplacés par leur valeur identifiée dans la chaîne <Heure>. Dans cette chaîne :
    • 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,
    • AP représente "AM" ou "PM" (si "AP" est présent dans le format, l'heure est affichée sur 12 heures).
  • soit à la constante maskHeureSystème. Cette constante permet d'utiliser directement le masque utilisé par l'heure système.
    AndroidWidget AndroidJava Cette constante n'est pas disponible.
Si ce paramètre n'est spécifié, le format du résultat est HH:MM:SS:CC.
Remarques

Validité de l'heure

La validité de l'heure passée en paramètre est vérifiée. Un message est affiché en cas d'heure invalide. Il est possible de tester la validité d'une heure avec la fonction HeureValide.
Conseil : Pour avoir une chaîne contenant une heure valide, il faut saisir l'heure dans un champ de saisie de type Heure.

Format d'heure

La fonction HeureVersChaîne permet de formater une heure retournée par la fonction EntierVersHeure ou la fonction HeureSys. Le résultat pourra par exemple être affecté à un champ de type texte.
Classification Métier / UI : Code neutre
Composante : wd300std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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