Time
Les variables, champs ou expressions de type Heure (Time) peuvent être compris entre 00:00:00 et 596 000:00:00.
Les heures sont stockées dans un format de 24 heures.
Une valeur de type Heure peut être utilisée en tant que numérique. Le nombre correspondant est le nombre de secondes que cette valeur représente à partir de minuit (00:00:00).
Note : Dans le manuel de référence du langage 4D, les paramètres de type Heure dans les descriptions des commandes sont appelés Heure, sauf spécification explicite.
Constantes littérales de type heure
Une constante heure est incluse entre deux points d’interrogation (?...?).
Avec une version française de 4D, une heure est structurée sous la forme heure:minute:seconde, deux points (:) séparant les valeurs. Les heures sont stockées dans un format de 24 heures.
Voici quelques exemples de constantes littérales de type heure :
?00:00:00? //minuit
?09:30:00? //9:30 du matin
?13:01:59? //13 heures 1 minute et 59 secondes
Une heure nulle s’écrit ?00:00:00?
Astuce : L'éditeur de code propose un raccourci pour saisir une date nulle. Pour cela, saisissez un point d'interrogation (?) et appuyez sur Entrée.
Opérateurs sur les heures
| Opération | Syntaxe | Retourne | Expression | Valeur |
|---|---|---|---|---|
| Addition | Heure + Heure | Time | ?02:03:04? + ?01:02:03? | ?03:05:07? |
| Soustraction | Heure – Heure | Time | ?02:03:04? – ?01:02:03? | ?01:01:01? |
| Addition | Heure + Nombre | Number | ?02:03:04? + 65 | 7449 |
| Soustraction | Heure – Nombre | Number | ?02:03:04? – 65 | 7319 |
| Multiplication | Heure * Nombre | Number | ?02:03:04? * 2 | 14768 |
| Division | Heure / Nombre | Number | ?02:03:04? / 2 | 3692 |
| Division entière | Heure \ Nombre | Number | ?02:03:04? \ 2 | 3692 |
| Modulo | Heure % Heure | Time | ?20:10:00? % ?04:20:00? | ?02:50:00? |
| Modulo | Heure % Nombre | Number | ?02:03:04? % 2 | 0 |
| Egalité | Heure = Heure | Boolean | ?01:02:03? = ?01:02:03? | True |
| ?01:02:03? = ?01:02:04? | False | |||
| Inégalité | Heure # Heure | Boolean | ?01:02:03? # ?01:02:04? | True |
| ?01:02:03? # ?01:02:03? | False | |||
| Supérieur à | Heure > Heure | Boolean | ?01:02:04? > ?01:02:03? | True |
| ?01:02:03? > ?01:02:03? | False | |||
| Inférieur à | Heure < Heure | Boolean | ?01:02:03? < ?01:02:03? | True |
| ?01:02:03? < ?01:02:03? | False | |||
| Supérieur ou égal à | Heure >= Heure | Boolean | ?01:02:03? >=?01:02:03? | True |
| ?01:02:03? >=?01:02:03? | False | |||
| Inférieur ou égal à | Heure <= Heure | Boolean | ?01:02:03? <=?01:02:03? | True |
| ?01:02:04? <=?01:02:03? | False |
Exemple 1
Vous pouvez combiner des expressions de type heure et de type numérique à l'aide des fonctions Time et Time string.
Vous pouvez combiner des expressions Time et Number à l'aide des fonctions Time ou Current time:
// La ligne suivante assigne à la variable $vlSeconds le nombre de secondes qui, dans une heure à partir de maintenant, se seront écoulées depuis minuit
$vlSeconds:=Current time+3600
// La ligne suivante assigne à la variable $vhSoon l'heure qu'il sera dans une heure
$vhSoon:=Time(Current time+3600)
La seconde ligne peut également être écrite de la façon suivante :
// La ligne suivante assigne à la variable $vhBientôt l'heure qu'il sera dans une heure
$vhSoon:=Current time+?01:00:00?
Exemple 2
L'opérateur Modulo permet notamment d'ajouter des heures en tenant compte du format sur 24 heures d'une journée :
$t1:=?23:00:00? // C'est 23:00 heures
// Nous voulons ajouter 2 heures et demie
$t2:=$t1 +?02:30:00? // Avec un ajout simple, $t2 vaut ?25:30:00?
$t2:=($t1 +? 2:30:00?)%?24:00:00? // $t2 vaut ?01:30:00? et il est 1:30 heure le lendemain matin