PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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, ...). 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.
Versions 16 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Ce type de variable est désormais disponible pour les applications Windows Phone.
Universal Windows 10 App Ce type de variable est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Widget Android Ce type de variable est désormais disponible en mode Widget Android.
Nouveauté 18
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Widget Android Ce type de variable est désormais disponible en mode Widget Android.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Widget Android Ce type de variable est désormais disponible en mode Widget Android.
Versions 20 et supérieures
WEBDEV - Code Navigateur Ce type de variable est désormais disponible en code navigateur.
Nouveauté 20
WEBDEV - Code Navigateur Ce type de variable est désormais disponible en code navigateur.
WEBDEV - Code Navigateur Ce type de variable est désormais disponible en code navigateur.
Versions 21 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Apple Watch Ce type de variable est désormais disponible en mode Apple Watch.
Nouveauté 21
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Apple Watch Ce type de variable est désormais disponible en mode Apple Watch.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Apple Watch Ce type de variable est désormais disponible en mode Apple Watch.
Exemple
HeureDébut est une Heure = "1330"
HeureFin est une Heure = "1730"    
DuréeCongrès est une Durée = HeureFin - HeureDébut
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 être une durée.
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 : "+JHHMMSSLLL" (Jours, heures, minutes, secondes, millièmes de seconde).
Si une variable de type durée est manipulée grâce à un entier, cet entier correspond au nombre de millisecondes 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 :
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