---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideTime - Dans le champ d'application

# GlideTime - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture

L'API GlideTime fournit des méthodes pour effectuer des opérations sur les objets GlideTime, telles que l'instanciation d'objets GlideTime ou l'utilisation des champs GlideTime.
Pour obtenir des conseils sur les chaînes d'entrée de date et heure avec une liste des conflits de format courants, reportez-vous à [Directives relatives au format de la date et de l'heure](https://servicenow-prod.fluidtopics.net/VPFM7rKMmvkG7R6eDSeRwQ#date-and-time-format-guidelines "Vous pouvez spécifier un format de date avec une séquence de chaînes de modèle de date et d’heure spécifiques. Une chaîne de modèle se compose d’une ou plusieurs lettres majuscules et minuscules de A à Z. Tout texte entre guillemets est ignoré et copié dans la sortie date.").

## GlideTime : GlideTime() {#ariaid-title2}

Instancie un objet GlideTime avec l'heure actuelle.
{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r}  

    var gt = new GlideTime(); 
    gs.info(gt.getDisplayValue());

## GlideTime : GlideTime(nombre de millisecondes) {#ariaid-title3}

Instancie un objet GlideTime dont l'heure commence à minuit UTC plus la valeur transmise.
La valeur est ajustée en fonction du fuseau horaire dans lequel réside l'instance. Par exemple, si l'instance de l'utilisateur se trouve dans un fuseau horaire situé à -8 heures de l'UTC et que 1 000 est transmis, l'heure dans l'objet GlideTime est 16:00:10 (00:00:00 - 8 heures + 10 secondes.)
{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| millisecondes | Numéro | Heure à ajouter à minuit UTC. Unité : Millisecondes |
[Tableau 2. Paramètres]

{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq}  
Cet exemple montre l'ajout de 10 secondes à minuit (UTC), qui est ensuite ajusté pour le fuseau horaire dans lequel réside l'instance. Dans ce cas, -8 heures à partir de UTC.

    var gt = new GlideTime(10000); 
    gs.info(gt.getDisplayValue());

Sortie :

    16:00:10

## GlideTime : getByFormat (format de chaîne) {#ariaid-title4}

Renvoie l'heure au format spécifié.
Pour plus d'informations sur les formats d'heure que vous pouvez transmettre à cette méthode, voir [Format de champ de date et d'heure global](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Vous pouvez transmettre ces valeurs dans n'importe quel ordre et ajouter des séparateurs tels qu'un tiret, un espace, une barre oblique inverse ou deux points. De plus, vous pouvez également passer le caractère \<\< a \>\> pour retourner le matin et l'après-midi.
{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| format | Chaîne | Chaîne à utiliser pour formater l'heure. Par exemple, si l'heure actuelle est 10:30:20 alors : * hh :mm :ss = 10:30:20 * HH = 10 * HH --- ss = 10 --- 20 * hh a = 10 AM * s :m :H ss :mm :hh = 20:30:10 20:30:10 * HH :mm :ss. SSSZ = 10:30:20.000+0000 * HH/mm/ss = 10/30/20 {#r_ScopedGlideTimeGetByFormat_String__ul_cdw_4zy_jkb} |
[Tableau 3. Paramètres]

{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Heure au format spécifié. |
[Tableau 4. Renvoie]

{#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq}  

    var gt = new GlideTime(); 
    gt.setValue('12:00:00');
    gs.info(gt.getByFormat("HH:mm"));

Sortie :

    12:00

## GlideTime : getDisplayValue() {#ariaid-title5}

Obtient l'heure dans le format d'affichage et le fuseau horaire de l'utilisateur actuel.
Lors de la conception de règles métier ou d'includes de script, n'oubliez pas que cette méthode peut renvoyer des valeurs dans différents formats pour différents utilisateurs.
{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 5. Paramètres]

{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | L'heure au format et dans le fuseau horaire de l'utilisateur. |
[Tableau 6. Renvoie]

{#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setDisplayValue("12:00:00"); // User Time Zone
    gs.info(gt.getDisplayValue()); // User Time Zone

## GlideTime : getDisplayValueInternal() {#ariaid-title6}

Obtient la valeur d'affichage dans le fuseau horaire de l'utilisateur actuel et au format interne (HH :mm :ss).
{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | La valeur d'heure de l'objet GlideTime dans le fuseau horaire de l'utilisateur actuel et le format d'heure interne HH :mm :ss. |
[Tableau 8. Renvoie]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setValue("01:00:00"); //Internal Time Zone , UTC
    gs.info(gt.getDisplayValueInternal()); //User Time Zone

## GlideTime : getHourLocalTime() {#ariaid-title7}

Renvoie les heures faisant partie du temps en utilisant le fuseau horaire local.
{#r_SGT-getHourLocalTime__table_pwr_c2d_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 9. Paramètres]

{#r_SGT-getHourLocalTime__table_pwr_c2d_kw} {#r_SGT-getHourLocalTime__table_qwr_c2d_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Les heures utilisant le fuseau horaire local. |
[Tableau 10. Renvoie]

{#r_SGT-getHourLocalTime__table_qwr_c2d_kw}

## GlideTime : getHourOfDayLocalTime() {#ariaid-title8}

Renvoie les heures faisant partie du temps en utilisant le fuseau horaire local. Le nombre d'heures est basé sur une horloge de 24 heures.
{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 11. Paramètres]

{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw} {#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Les heures utilisant le fuseau horaire local. Le nombre d'heures est basé sur une horloge de 24 heures. |
[Tableau 12. Renvoie]

{#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw}

## GlideTime : getHourOfDayUTC() {#ariaid-title9}

Renvoie la partie heures de l'heure en utilisant le fuseau horaire UTC. Le nombre d'heures est basé sur une horloge de 24 heures.
{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 13. Paramètres]

{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw} {#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Les heures utilisant le fuseau horaire UTC. Le nombre d'heures est basé sur une horloge de 24 heures. |
[Tableau 14. Renvoie]

{#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw}

## GlideTime : getHourUTC() {#ariaid-title10}

Renvoie la partie heures de l'heure en utilisant le fuseau horaire UTC. Le nombre d'heures est basé sur une horloge de 12 heures. Midi et minuit sont représentés par 0 et non par 12.
{#r_SGT-getHourUTC__table_cfh_nyc_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 15. Paramètres]

{#r_SGT-getHourUTC__table_cfh_nyc_kw} {#r_SGT-getHourUTC__table_dfh_nyc_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Les heures utilisant le fuseau horaire UTC. Le nombre d'heures est basé sur une horloge de 12 heures. Midi et minuit sont représentés par 0 et non par 12. |
[Tableau 16. Renvoie]

{#r_SGT-getHourUTC__table_dfh_nyc_kw}

## GlideTime : getMinutesLocalTime() {#ariaid-title11}

Renvoie le nombre de minutes en utilisant le fuseau horaire local.
{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 17. Paramètres]

{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw} {#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Nombre de minutes en utilisant le fuseau horaire local. |
[Tableau 18. Renvoie]

{#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw}

## GlideTime : getMinutesUTC() {#ariaid-title12}

Renvoie le nombre de minutes dans l'heure en fonction du fuseau horaire UTC.
{#r_SGT-getMinutesUTC__table_qvr_xcd_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 19. Paramètres]

{#r_SGT-getMinutesUTC__table_qvr_xcd_kw} {#r_SGT-getMinutesUTC__table_rvr_xcd_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Nombre de minutes dans l'heure en utilisant le fuseau horaire UTC. |
[Tableau 20. Renvoie]

{#r_SGT-getMinutesUTC__table_rvr_xcd_kw}

## GlideTime : getSeconds() {#ariaid-title13}

Renvoie le nombre de secondes dans la minute actuelle.
{#r_SGT-getSeconds__table_dkh_1fd_kw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 21. Paramètres]

{#r_SGT-getSeconds__table_dkh_1fd_kw} {#r_SGT-getSeconds__table_ekh_1fd_kw__entry__2}

| Type | Description |
|-|-|
| Numéro | Nombre de secondes dans la minute. |
[Tableau 22. Renvoie]

{#r_SGT-getSeconds__table_ekh_1fd_kw}

## GlideTime : getValue() {#ariaid-title14}

Obtient la valeur d'heure stockée dans la base de données par l'objet GlideTime au format interne, HH :mm :ss, et le fuseau horaire du système.
{#r_ScopedGlideTimeGetValue__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 23. Paramètres]

{#r_ScopedGlideTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur horaire dans le fuseau horaire interne et système. |
[Tableau 24. Renvoie]

{#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gs.info(gt.getValue()); // Internal Time Zone, UTC

## GlideTime : setDisplayValue(String asDisplayed) {#ariaid-title15}

Définit une valeur d'heure en utilisant le format d'affichage et le fuseau horaire de l'utilisateur actuel.
{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| asDisplayed | Chaîne | Heure dans le format d'affichage et le fuseau horaire de l'utilisateur actuel. Le paramètre doit être formaté à l'aide du format d'affichage préféré de l'utilisateur actuel, tel que HH :mm :ss. |
[Tableau 25. Paramètres]

{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 26. Renvoie]

{#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setDisplayValue('01:00:00');   // User Time Zone
    gs.info(gt.getDisplayValueInternal()); // User Time Zone

## GlideTime : setValue(String o) {#ariaid-title16}

Définit l'heure de l'objet GlideTime dans le fuseau horaire interne.
{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| o | Chaîne | L'heure au format hh :mm :ss. |
[Tableau 27. Paramètres]

{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 28. Renvoie]

{#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setValue('01:00:00');  //Internal Time Zone, UTC
    gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

## GlideTime - soustraire(GlideTime startTime, GlideTime endTime) {#ariaid-title17}

Obtient la différence de durée entre deux valeurs d'objet GlideTime.
{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| startTime | Heure de Glide | Valeur de départ. |
| endTime | Heure de Glide | Valeur de fin. |
[Tableau 29. Paramètres]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq} {#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| GlideDuration (en anglais seulement) | Durée entre les deux valeurs. |
[Tableau 30. Renvoie]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq}  

    var gd1 = new GlideTime(); 
    gd1.setDisplayValue("09:00:00"); 
    var gd2 = new GlideTime(); 
    gd2.setDisplayValue("09:10:00"); 
     
    var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
    gs.info(dur.getDisplayValue());