---
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


---

# GlideDuration : inclus dans le champ d'application

# GlideDuration : inclus 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) 4 minutes de lecture

La classe GlideDuration fournit des méthodes permettant de travailler avec des intervalles de temps connus sous le nom de durées.

Les objets GlideDuration stockent la durée sous la forme d'un nombre de jours et d'une heure à partir du 1er janvier 1970, 00:00:00. Par conséquent, les méthodes setValue() et getValue() utilisent l'objet GlideDateTime inclus dans la portée pour les paramètres et les valeurs de retour.

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

Instancie un objet GlideDuration.
{#r_ScopedGlideDurationGlideDuration__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDurationGlideDuration__table_vy2_525_jq}

## GlideDuration : GlideDuration(GlideDuration un autre) {#ariaid-title3}

Instancie un objet GlideDuration en clonant les valeurs de l'objet GlideDuration transmis.
{#r_ScopedGlideDurationGlideDuration_GlideDuration__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| autre | GlideDuration (en anglais seulement) | Objet GlideDuration. |
[Tableau 2. Paramètres]

{#r_ScopedGlideDurationGlideDuration_GlideDuration__table_vy2_525_jq}  

    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration(duration);
    gs.info(duration2.getDisplayValue());

Sortie :

    3 Days 12 Hours

## GlideDuration : GlideDuration(nombre de millisecondes) {#ariaid-title4}

Instancie un objet GlideDuration avec la durée spécifiée en millisecondes.
{#r_ScopedGlideDurationGlideDuration_Number__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| millisecondes | Numéro | Valeur de durée. Unité : Millisecondes |
[Tableau 3. Paramètres]

{#r_ScopedGlideDurationGlideDuration_Number__table_vy2_525_jq}  

    var dur = new GlideDuration(60000);
    gs.info(dur.getDurationValue());

Sortie :

    00:01:00

## GlideDuration : GlideDuration(String displayValue) {#ariaid-title5}

Instancie un objet GlideDuration avec la valeur d'affichage de durée spécifiée.
{#r_ScopedGlideDurationGlideDuration_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| displayValue | Chaîne | Valeur de durée. Format : d HH :mm :ss où \<\< d \>\> est le nombre de jours. |
[Tableau 4. Paramètres]

{#r_ScopedGlideDurationGlideDuration_String__table_vy2_525_jq}  

    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration('3:00:00');
    var answer = duration.add(duration2);
    gs.info(answer.getDisplayValue());

Sortie :

    3 Days 15 Hours

## GlideDuration : ajouter (durée GlideDuration) {#ariaid-title6}

Ajoute la durée de l'objet GlideDuration spécifié à l'objet GlideDuration actuel.
{#r_ScopedGlideDurationAdd_GlideDuration__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| durée | GlideDuration (en anglais seulement) | Objet GlideDuration qui contient la valeur de durée à ajouter à l'objet GlideDuration actuel. |
[Tableau 5. Paramètres]

{#r_ScopedGlideDurationAdd_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| GlideDuration (en anglais seulement) | Nouvel objet GlideDuration dont la durée est la somme des durées des deux objets GlideDuration. |
[Tableau 6. Renvoie]

{#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq}  

    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration('3:00:00');
    var answer = duration.add(duration2);
    gs.info(answer.getDisplayValue());

Sortie :

    3 Days 15 Hours

## GlideDuration : getByFormat (format de chaîne) {#ariaid-title7}

Renvoie la valeur de durée au format spécifié.
{#r_ScopedGlideDurationGetByFormat_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| format | Chaîne | Format de durée. Format : [format de champ global de date et d'heure](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) |
[Tableau 7. Paramètres]

{#r_ScopedGlideDurationGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDurationGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Durée actuelle dans le format spécifié. |
[Tableau 8. Renvoie]

{#r_ScopedGlideDurationGetByFormat_String__table_qpt_3f5_jq}  

    var dur = new GlideDuration('3 22:00:00');
    gs.info(dur.getByFormat('HH:mm'));

Sortie

    22:00

## GlideDuration : getDayPart() {#ariaid-title8}

Renvoie le nombre de jours.
{#r_ScopedGlideDurationGetDayPart__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDurationGetDayPart__table_vy2_525_jq} {#r_ScopedGlideDurationGetDayPart__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Numéro | Nombre de jours dans la durée. |
[Tableau 10. Renvoie]

{#r_ScopedGlideDurationGetDayPart__table_qpt_3f5_jq}  

    var dur = new GlideDuration('3 12:00:00');
    gs.info(dur.getDayPart());

Sortie :

    3

## GlideDuration inclus dans le champ d'application : getDisplayValue() {#ariaid-title9}

Renvoie la valeur d'affichage de la durée en nombre de jours, d'heures et de minutes.
{#r_ScopedGlideDurationGetDisplayValue__table_vy2_565_jq__entry__3}

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

{#r_ScopedGlideDurationGetDisplayValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nombre de jours, d'heures et de minutes, par exemple 2 jours 10 heures 36 minutes. Format : Valeur d'affichage : \<\< n \>\> Jours \<\< n \>\> Heures \<\< n \>\> Minutes |
[Tableau 12. Renvoie]

{#r_ScopedGlideDurationGetDisplayValue__table_qpt_3f5_jq}  

    var dur = new GlideDuration('3 12:00:00');
    gs.info(dur.getDisplayValue());

Sortie :

    3 Days 12 Hours

## GlideDuration : getDurationValue() {#ariaid-title10}

Renvoie la valeur de durée au format \<\< j HH :mm :ss \>\>.
{#r_ScopedGlideDurationGetDurationValue__table_vy2_565_jq__entry__3}

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

{#r_ScopedGlideDurationGetDurationValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetDurationValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de durée. Format : d HH :mm :ss où \<\< d \>\> est le nombre de jours. |
[Tableau 14. Renvoie]

{#r_ScopedGlideDurationGetDurationValue__table_qpt_3f5_jq}  

    var dur = new GlideDuration(60000);
    gs.info(dur.getDurationValue());

Sortie :

    00:01:00

## GlideDuration : getRoundedDayPart() {#ariaid-title11}

Renvoie le nombre arrondi de jours. Si la partie temporelle est supérieure à 12 heures, la valeur de retour est arrondie à l'unité supérieure. Sinon, il est arrondi à l'unité inférieure.
{#r_ScopedGlideDurationGetRoundedDayPart__table_vy2_565_jq__entry__3}

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

{#r_ScopedGlideDurationGetRoundedDayPart__table_vy2_565_jq} {#r_ScopedGlideDurationGetRoundedDayPart__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Numéro | Valeur jour de la valeur d'affichage arrondie. |
[Tableau 16. Renvoie]

{#r_ScopedGlideDurationGetRoundedDayPart__table_qpt_3f5_jq}  

    var dur = new GlideDuration('3 14:00:00');
    gs.info(dur.getRoundedDayPart());

Sortie :

    4

## GlideDuration : getValue() {#ariaid-title12}

Renvoie la valeur interne de date/heure de l'objet GlideDuration actuel.
Les objets GlideDuration stockent la durée sous forme de date et d'heure à partir du 1er janvier 1970, 00:00:00.
{#r_ScopedGlideDurationGetValue__table_vy2_565_jq__entry__3}

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

{#r_ScopedGlideDurationGetValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Durée actuelle dans l'objet GlideDuration. Format : JJ-MM-AAAA HH :mm :ss |
[Tableau 18. Renvoie]

{#r_ScopedGlideDurationGetValue__table_qpt_3f5_jq}  

    var dur = new GlideDuration('3 12:00:00');
    gs.info(dur.getValue());

Sortie :

    1970-01-04 12:00:00

## GlideDuration : setDisplayValue(String asDisplayed) {#ariaid-title13}

Définit la valeur d'affichage de la durée.
{#r_ScopedGlideDurationSetDisplayValue_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| asDisplayed | Chaîne | Affichez la valeur de durée à régler. Format : d HH :mm :ss où \<\< d \>\> est le nombre de jours |
[Tableau 19. Paramètres]

{#r_ScopedGlideDurationSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDurationSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDurationSetDisplayValue_String__table_qpt_3f5_jq1}  

    var dur = new GlideDuration(); 
    dur.setDisplayValue('3 08:00:00');
    gs.info(dur.getDisplayValue());

Sortie :

    3 Days 8 Hours

## GlideDuration : setValue(Object o) {#ariaid-title14}

Définit la valeur interne date/heure de l'objet GlideDuration.
La méthode définit la valeur de durée à la différence de la date/heure de transmission de la valeur date/heure de base du 1er janvier 1970, 00:00:00. L'objet date/heure transmis (chaîne) est analysé en un objet GlideDateTime.
{#r_ScopedGlideDurationSetValue_Object__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| o | Objet | Date et heure à utiliser comme point de terminaison pour la durée calculée. Format : JJ-MM-AAAA HH :mm :ss |
[Tableau 21. Paramètres]

{#r_ScopedGlideDurationSetValue_Object__table_vy2_525_jq} {#r_ScopedGlideDurationSetValue_Object__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDurationSetValue_Object__table_qpt_3f5_jq1}  

    var dur = new GlideDuration();
    dur.setValue('1970-01-05 08:00:00'); // sets internal DateTime value. The String is parsed into a GlideDateTime object.
    gs.info(dur.getDisplayValue());

Sortie :

    4 Days 8 Hours

## GlideDuration - soustraire(durée GlideDuration) {#ariaid-title15}

Soustrait la durée de l'objet GlideDuration spécifié à l'objet GlideDuration actuel.
{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| durée | GlideDuration (en anglais seulement) | Objet GlideDuration qui contient la valeur de durée à soustraire de l'objet GlideDuration actuel. |
[Tableau 23. Paramètres]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1__entry__2}

| Type | Description |
|-|-|
| GlideDuration (en anglais seulement) | Nouvel objet GlideDuration dont la durée contient le résultat de la soustraction de la durée des deux objets GlideDuration. |
[Tableau 24. Renvoie]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1}  

    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration('3:00:00');
    var answer = duration.subtract(duration2);
    gs.info(answer.getDisplayValue());

Sortie :

    3 Days 9 Hours