DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés de gestion des dates et des heures
  • Gestion des heures
  • Gestion des durées
  • Opérateurs disponibles sur les heures
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
La propriété Heure permet de :
  • Récupérer l'heure d'une variable de type Heure, DateHeure ou récupérer le nombre d'heures d'une variable de type Durée.
  • Modifier l'heure d'une variable de type Heure, DateHeure ou modifier le nombre d'heures d'une variable de type Durée.
  • Récupérer l'heure ou le nombre d'heures d'une rubrique de type Date (au format "Date et heure" ou "Durée") ou d'une rubrique de type Heure.
  • Modifier l'heure ou le nombre d'heures d'une rubrique de type Date (au format "Date et heure" ou "Durée") ou d'une rubrique de type Heure.
Remarque : La propriété Heure permet de simplifier les opérations de décalage sur les heures et les durées (ajouter une heure, ...).
Rappel : Les rubriques de type Date permettent de gérer :
  • les dates simples "Année - Mois - Jour" (format AAAAMMJJ)
  • les dates et les heures "Année - Mois - Jour - Heures - Minutes - Secondes - Millièmes de seconde" (format AAAAMMJJHHmmSSCCC)
  • les durées "Nombre de jours - Nombre d'heures - Nombre de minutes - Nombre de secondes - Nombre de millièmes de seconde" (format +JHHMMSSCCC)
Exemple
// Exemple sur une variable
HeureDébut est une Heure = "1230"
// Ajouter 10 heures
HeureDébut.Heure += 10   // HeureDébut correspond à 22h30
HeureDébut.Heure += 10   // HeureDébut correspond à 08h30
// Modifier les heures
HeureDébut.Heure = 10
// Exemple sur une rubrique
Journée.HeureDébut = "1230"
// Ajouter 10 heures
Journée.HeureDébut.Heure += 10	// HeureDébut correspond à 22h30
Journée.HeureDébut.Heure += 10	// HeureDébut correspond à 08h30
// Modifier les heures
Journée.HeureDébut.Heure = 10
Syntaxe

Connaître l'heure d'une variable Heure, DateHeure ou Durée Masquer les détails

<Résultat> = <Heure manipulée>.Heure
<Résultat> : Entier
Heure sur 2 chiffres.
<Heure manipulée> : Heure, DateHeure ou Durée
Nom de la variable de type Heure, DateHeure ou Durée à manipuler.

Modifier l'heure d'une variable Heure, DateHeure ou Durée Masquer les détails

<Heure manipulée>.Heure = <Nouvelle heure>
<Heure manipulée> : Heure, DateHeure ou Durée
Nom de la variable de type Heure, DateHeure ou Durée à manipuler.
<Nouvelle heure> : Chaîne de caractères ou entier
Nouvelle heure en chiffres, compris entre 0 et 23. Remplace l'heure de la variable manipulée.

Connaître l'heure d'une rubrique de type Heure ou Date (format "Date et Heure" ou "Durée") Masquer les détails

<Résultat> = <Fichier de données>.<Rubrique>.Heure
<Résultat> : Entier
Heure sur 2 chiffres.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données manipulé. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Rubrique.

Modifier l'heure d'une rubrique de type Heure ou Date (format "Date et Heure" ou "Durée") Masquer les détails

<Fichier de données>.<Rubrique>.Heure = <Nouvelle heure>
<Fichier de données> : Chaîne de caractères
Nom du fichier de données manipulé. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Rubrique.
<Nouvelle heure> : Chaîne de caractères ou entier
Nouvelle heure en chiffres, compris entre 0 et 23. Remplace l'heure de rubrique manipulée.
Remarques

Gestion des heures

Cas 1 : Affectation directe
Lors d'une affectation directe (par exemple, Journée.HeureDébut.Heure = n), l'heure doit être comprise entre 0 et 23. Si l'heure spécifiée est supérieure, une erreur du WLangage est générée.
La notation Journée.HeureDébut.Heure = Journée.HeureDébut.Heure + 5 risque de générer une erreur en exécution.
Cas 2 : Opérations sur les heures
Lors d'opérations sur les heures des rubriques de type Heure ou Date (format "Date et Heure"), le changement d'heures est automatiquement géré.
L'ajout ou la diminution d'heures prend en compte automatiquement le passage de 23 heures à 0 heure.
Ainsi, si une heure est ajoutée à :
  • une rubrique de type Heure correspondant à 23h35, le résultat correspondra à 0h35
  • une rubrique de type Date (format Date et Heure), l'heure et la date seront modifiés (un jour sera ajouté).
// Exemple sur une variable
HeureDébut est une Heure = "2335"
HeureDébut.Heure++                            // HeureDébut = 0035
DateDébut est une Date = "202011262335"        // 26/11/2020 à 23:35
DateDébut.Heure++                             // 27/11/2020 à 00:35

Gestion des durées

Si le nombre d'heures d'une durée dépasse 23H59, le nombre de jours est automatiquement incrémenté.

Opérateurs disponibles sur les heures

Les opérateurs arithmétiques suivants peuvent être utilisés avec la propriété Heure :
  • ++ et --
  • += et -=
// Exemple sur une rubrique
Journée.HeureDébut = "1230"
Journée.HeureDébut.Heure++     // Ajouter 1 heure
Journée.HeureDébut.Heure+=5    // Ajouter 5 heures
Journée.HeureDébut.Heure-=5    // Retrancher 5 heures
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/03/2024

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