DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Syntaxe WLangage / Types du WLangage
  • Valeurs d'une durée
  • Les propriétés utilisables sur les durées
  • Valeurs gérées
  • Affichage d'une durée dans un champ de saisie
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 Durée permet de manipuler simplement des intervalles de dates et d'heures. Le type Durée peut être utilisé par exemple pour réaliser des calculs (différence, addition, etc.). Pour plus de détails, consultez le chapitre Opérations disponibles sur le type Durée.
Remarques :
  • Plusieurs propriétés peuvent être utilisées avec le type Durée, pour récupérer par exemple le nombre de jours ou de minutes.
  • Pour affecter une durée provenant du résultat d'une fonction, utilisez la fonction ChaîneVersDurée.
  • 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.
Le type Durée est un type nullable. Pour plus de détails, consultez Activation des types nullables.
Exemple
HeureDébut est une Heure = "1330"
HeureFin est une Heure = "1730"
DuréeCongrès est une Durée = HeureFin - HeureDébut
DuréeTâche est une Durée = 3 min 30 s
Syntaxe
<Nom de la variable> est une Durée = <Valeur>
OU

<Nom de la variable> est une Durée
<Nom de la variable> = <Valeur>
<Nom de la variable> :
Nom de la variable à déclarer. Lorsque plusieurs variables du même type sont déclarées et initialisées sur la même ligne, seule la dernière variable est initialisée.
<Valeur> :
Le plus souvent, une durée est le résultat d'une opération effectuée entre des variables de type Date, Heure ou DateHeure.
Cette valeur peut correspondre à :
  • une chaîne de caractères,
  • un entier (nombre de millisecondes de la durée),
  • une durée (par exemple, une autre variable de type durée),
  • l'indication directe de la durée (par exemple : 30 s).
0 permet de ré-initialiser la durée.
Remarques

Valeurs d'une durée

Si une variable de type Durée est manipulée :
  • grâce à une chaîne, cette chaîne est au format : "+JHHMMSSCCC" (Jours, heures, minutes, secondes, millièmes de seconde).
  • grâce à un entier, cet entier correspond au nombre de millisecondes de la durée.
  • grâce à une durée, cette durée peut correspondre à une variable de type Durée ou à l'indication directe de la durée.
Le plus souvent, une durée est le résultat d'une opération effectuée entre des variables de type Date, Heure ou DateHeure. Cette valeur peut être une durée.
0 permet de ré-initialiser la durée.
Android Il est désormais possible d'utiliser l'indication directe de la durée.

Les propriétés utilisables sur les durées

Les propriétés utilisables sur les durées sont les suivantes :
EnHeuresRenvoie ou modifie le nombre d'heures correspondant à une durée. Le nombre d'heures est exprimé sous forme de réel.
EnJoursRenvoie ou modifie le nombre de jours correspondant à une durée. Le nombre de jours est exprimé sous forme de réel.
EnMillisecondesRenvoie ou modifie le nombre de millisecondes correspondant à une durée. Le nombre de millisecondes est exprimé sous forme d'entier.
EnMinutesRenvoie ou modifie le nombre de minutes correspondant à une durée. Le nombre de minutes est exprimé sous forme de réel.
EnSecondesRenvoie ou modifie le nombre de secondes correspondant à une durée. Le nombre de secondes est exprimé sous forme de réel.
HeureRenvoie ou modifie le nombre d'heures. Le nombre d'heures est exprimé sous forme d'entier.
JourRenvoie ou modifie le nombre de jours. Le nombre de jours est exprimé sous forme d'entier.
MillisecondeRenvoie ou modifie le nombre de millisecondes. Le nombre de millisecondes est exprimé sous forme d'entier.
MinuteRenvoie ou modifie le nombre de minutes. Le nombre de minutes est exprimé sous forme d'entier.
SecondeRenvoie ou modifie le nombre de secondes. Le nombre de secondes est exprimé sous forme d'entier.

Pour plus de détails sur les opérations possibles sur les durées (addition, soustraction, comparaison), consultez Opérations disponibles sur le type Durée.
HeureDébut est une Heure = "1330"
HeureFin est une Heure = "1730"     
DuréeCongrès est une Durée = HeureFin - HeureDébut
Info("Le congrès a duré : " + DuréeCongrès.Heure + " heures")

Important : Pour mémoriser les valeurs des propriétés listées dans le tableau ci-dessus, il est impératif de respecter le type de variable renvoyé par chaque propriété. Par exemple :
MaDurée est une Durée
CombienEnHeure est un réel

MaDurée.Jour = 5
CombienEnHeure = MaDurée.EnHeures

Info(MaDurée.Jour + " jours = " + CombienEnHeure + " heures.")

Dans cet exemple, la variable CombienEnHeure doit être déclarée en tant que réel et non en tant que entier. Si cette variable est déclarée en tant que entier, sa valeur sera approchée.

Valeurs gérées

Le type Durée permet de gérer des durées comprises entre plus et moins 2 milliards de jours. La précision est la milliseconde.

Affichage d'une durée dans un champ de saisie

Pour afficher une durée dans un champ de saisie, il est possible d'utiliser la propriété MasqueAffichage. Pour plus de détails, consultez Masque d'affichage pour les durées.
Liste des exemples associés :
Calculs sur les durées Exemples unitaires (WINDEV) : Calculs sur les durées
[ + ] Calculs sur les dates et heures avec les fonctions WLangage :
- Calculer la durée écoulée entre deux instants (dates et heures)
- Effectuer une somme de durées
- Effectuer une moyenne de durées
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/03/2024

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