# Time Fonction de script et de graphique
Time() formate une expression en tant que valeur horaire en utilisant le format horaire défini dans les variables système du script de chargement de données ou sur le système d'exploitation, à moins qu'une chaîne de format ne soit précisée.
Time(number[, format])
double
Arguments
| Argument | Description |
| --- | --- |
| number | Nombre à formater. |
| format | Chaîne décrivant la façon dont la chaîne horaire résultante doit être formatée. En cas d'omission, ce sont le format horaire et le séparateur décimal définis dans le système d'exploitation qui sont utilisés.
La fonction `Time` supporte de nombreuses options de format pour différentes structures horaires, par exemple :
`hh:mm:ss`-Formate une valeur horaire dans un format horaire standard et affiche les heures, les minutes et les secondes avec des zéros au début.
`hh:mm TT` - Utilise un format de 12 heures avec le suffixe AM/PM.
`hh:mm` - N'affiche que les heures et les minutes, sans les secondes.
`hh.mm.ss`-Format horaire avec des séparateurs différents tels qu'un point (`.`) au lieu de deux-points.
`hh TT` - Inclut uniquement l'heure et AM/PM.
`hh "Hrs" mm "Mins"` - Affiche l'heure avec un texte personnalisé tel que Hrs.
[Description des formats de nombre et d'heure](https://help.qlik.com/fr-FR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
Exemple : Expressions de graphique
| Exemple | Résultat |
| --- | --- |
| `Time( 0.375 )` | Renvoie `09:00:00` lorsque le paramètre `TimeFormat` est `'hh:mm:ss'`. |
| `Time( 35648.375 )` | Renvoie `09:00:00` lorsque le `Timeformat` fourni est `'hh:mm:ss'`. |
| `Time( 0.99999, 'hh-mm' )` | Renvoie `23-59` en ignorant le paramètre `TimeFormat`, puisque le format est fourni dans la mesure. |
## Exemple - Les bases de Time
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### Expression de graphique
Vue d'ensemble
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
* Jeu de données chargé dans une table de données appelée `Example`.
* Champ suivant dans une table de données :
* `TimeValue`
* Variable `TimeFormat`, qui utilise le format `hh:mm:ss`.
Script de chargement
```
SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
Résultats
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :
* ` TimeValue
`
Créez les mesures suivantes :
* `=Time(TimeValue )`, pour afficher la valeur sous forme d'heure formatée via le paramètre système.
* `=Time(TimeValue, 'hh-mm' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh:mm:ss' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh:mm TT' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh:mm' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh.mm.ss' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh TT' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
Tableau de résultats
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
Les résultats montrent comment la fonction `Time` peut afficher les valeurs en fonction du format fourni dans l'expression de la fonction.
## Exemple - Les bases de Time via un paramètre TimeFormat différent
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### Expression de graphique
Vue d'ensemble
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
* Jeu de données chargé dans une table de données appelée `Example`.
* Champ suivant dans une table de données :
* `TimeValue`
* Variable `TimeFormat`, qui utilise le format `hh.mm.ss`.
Script de chargement
```
SET TimeFormat='hh.mm.ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
Résultats
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :
* ` TimeValue
`
Créez les mesures suivantes :
* `=Time(TimeValue )`, pour afficher la valeur sous forme d'heure formatée via le paramètre système.
* `=Time(TimeValue, 'hh-mm' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh:mm:ss' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh:mm TT' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh:mm' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh.mm.ss' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh TT' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`, pour afficher la valeur sous forme d'heure via le format fourni dans la fonction.
Tableau de résultats
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23.59.59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
Les résultats montrent comment la fonction `Time` peut afficher les valeurs en fonction du format fourni dans l'expression de la fonction.