Heure (Propriété)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Gestion des heures
Gestion des durées
Opérateurs disponibles sur les heures

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Heure (Propriété)

En anglais : Hour

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.
Non disponible.
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.
Non disponible.

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)

Versions 17 et supérieures

Cette propriété est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette propriété est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette propriété est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette propriété est désormais disponible en mode Windows Store apps.

Versions 20 et supérieures

Cette propriété est désormais disponible en code navigateur sur les variables de type Heure, DateHeure ou Durée.

Nouveauté 20

Cette propriété est désormais disponible en code navigateur sur les variables de type Heure, DateHeure ou Durée.

Versions 21 et supérieures

Cette propriété est désormais disponible en mode Apple Watch.

Cette propriété est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette propriété est désormais disponible en mode Apple Watch.

Cette propriété est désormais disponible en mode Universal Windows 10 App.

Cette propriété est désormais disponible en mode Apple Watch.

Cette propriété est désormais disponible en mode Universal Windows 10 App.

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.

Non disponible en code navigateur et en PHP

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.

Non disponible en code navigateur et en PHP

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

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/10/2021

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