- 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
Durée (Type de variable) En anglais : Duration
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, ...). 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.
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 30s
Syntaxe
Déclarer et initialiser une variable Masquer les détails
<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 chaine 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. Les propriétés utilisables sur les durées Les propriétés utilisables sur les durées sont les suivantes : | | | EnHeures | Renvoie ou modifie le nombre d'heures correspondant à une durée. Le nombre d'heures est exprimé sous forme de réel. | | EnJours | Renvoie ou modifie le nombre de jours correspondant à une durée. Le nombre de jours est exprimé sous forme de réel. | | EnMillisecondes | Renvoie ou modifie le nombre de millisecondes correspondant à une durée. Le nombre de millisecondes est exprimé sous forme d'entier. | | EnMinutes | Renvoie ou modifie le nombre de minutes correspondant à une durée. Le nombre de minutes est exprimé sous forme de réel. | | EnSecondes | Renvoie ou modifie le nombre de secondes correspondant à une durée. Le nombre de secondes est exprimé sous forme de réel. | | Heure | Renvoie ou modifie le nombre d'heures. Le nombre d'heures est exprimé sous forme d'entier. | | Jour | Renvoie ou modifie le nombre de jours. Le nombre de jours est exprimé sous forme d'entier. | | Milliseconde | Renvoie ou modifie le nombre de millisecondes. Le nombre de millisecondes est exprimé sous forme d'entier. | | Minute | Renvoie ou modifie le nombre de minutes. Le nombre de minutes est exprimé sous forme d'entier. | | Seconde | Renvoie 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.
Liste des exemples associés :
|
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
|
Documentation également disponible pour…
|
|
|
|