DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Syntaxe WLangage / Types du WLangage
  • Déclaration et initialisation
  • Affectation d'une variable de type Heure à une rubrique de type Heure
  • Les propriétés utilisables sur les heures
  • Limites
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
Le type Heure permet de manipuler simplement des heures. Ce type permet de gérer de manière quasi automatique les conversions (fonctions HeureVersChaîne, HeureVersEntier, etc.).
Ce type peut être utilisé aussi bien :
  • pour récupérer puis manipuler des rubriques HFSQL au format Heure.
  • pour récupérer puis manipuler les champs de saisie de type Heure.
  • dans les fonctions du WLangage permettant de gérer les heures.
  • pour réaliser des calculs sur les heures (différence, addition, etc.). Pour plus de détails, consultez le chapitre Opérations disponibles sur le type Heure.
Le type Heure est un type nullable. Pour plus de détails, consultez Activation des types nullables.

Remarques :
  • Plusieurs propriétés peuvent être utilisées avec le type Heure, pour récupérer par exemple qu'une partie de l'heure (heure, minute, etc.).
  • Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
HeureDébut est une Heure = 1205
HeureFin est une Heure = "2030"     // 20 heures 30
HeureEnCours est une Heure = HeureSys()
Syntaxe

Déclarer et initialiser une variable Masquer les détails

<Nom de la variable> est une Heure = <Valeur>

OU

<Nom de la variable> est une Heure
<Nom de la variable> = <Valeur>
<Nom de la variable> :
Nom de la variable à déclarer.
<Valeur> :
Valeur à affecter à la variable. Cette valeur peut être de type :
  • Heure
  • DateHeure : seule l'heure sera prise en compte.
  • Chaîne de caractères, au format :
    • HHMM
    • HHMMSS
    • HHMMSSCC
    • HHMMSSCCC
      Seules les heures et les minutes seront prises en compte.
      (HH : Heure, MM : minutes, SS : secondes, CC : centièmes de seconde, CCC : millièmes de seconde)
  • Entier : l'heure correspondra alors au nombre de centièmes de seconde écoulés depuis minuit "00 :00 :00 :00". A minuit correspond l'entier 0. Ne peut dépasser 8.639.999 (24 heures - 1 centième de seconde).
Remarques

Déclaration et initialisation

  • Une variable de type Heure peut être initialisée avec une valeur de type :
    • Heure
    • DateHeure : seule l'heure sera prise en compte.
    • Chaîne de caractères, au format :
      - HHMM
      - HHMMSS
      - HHMMSSCC
      - HHMMSSCCC
      Seules les heures et les minutes seront prises en compte (HH : Heure, MM : minutes, SS : secondes, CC : centièmes de seconde, CCC : millièmes de seconde).
    • Entier : l'heure correspondra alors au nombre de centièmes de seconde écoulés depuis minuit "00 :00 :00 :00". A minuit correspond l'entier 0. Ne peut dépasser 8.639.999 (24 heures - 1 centième de seconde).
  • Par défaut, une variable de type Heure est initialisée avec l'heure système. Pour régler la valeur par défaut affectée aux variables de type Date, Heure et DateHeure, utilisez la fonction DateHeureParDéfaut.
Remarque : Il est également possible d'initialiser une variable de type Heure avec l'heure système en utilisant la fonction Maintenant.

Affectation d'une variable de type Heure à une rubrique de type Heure

Désormais, lors de l'affectation d'une variable de type Heure à une rubrique de type Heure, les secondes et les centièmes de seconde sont pris en compte selon le format de la rubrique.
Par exemple, si la variable de type Heure correspond à "HHMMSSCCC" :
Rubrique du fichier de donnéesJusqu'à la version 100050 de WINDEV, WEBDEV, WINDEV MobileA partir des versions supérieures à 100050 de WINDEV, WEBDEV et WINDEV Mobile
Rubrique chaîneHHMMHHMMSSCCC
Rubrique heure au format HHMMHHMMHHMM
Rubrique heure au format HHMMSSHHMMHHMMSS
Rubrique heure au format HHMMSSMMHHMMHHMMSSMM

Les propriétés utilisables sur les heures

Les propriétés utilisables sur les heures sont les suivantes :
HeureRenvoie ou modifie l'heure (sous forme d'entier).
MillisecondeRenvoie ou modifie le nombre de millisecondes (sous forme d'entier).
MinuteRenvoie ou modifie le nombre de minutes (sous forme d'entier).
SecondeRenvoie ou modifie le nombre de secondes (sous forme d'entier).

Pour plus de détails sur les opérations possibles sur les heures (addition, soustraction, comparaison), consultez Opérations disponibles sur le type Heure.
HeureDébut est une Heure = "20011201"
// Ajoute 5 heures
HeureDébut.Heure += 5
// Modifie le nombre de minutes
HeureDébut.Minute = 5

Limites

Le type Heure permet de gérer les heures comprises entre 00:00 et 23:59. La précision est effectuée à la milliseconde.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/04/2024

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