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


---

# GlideDate - inclus dans le champ d'application

# GlideDate - 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) 8 minutes de lecture

La classe GlideDate incluse dans le champ d'application fournit des méthodes permettant d'effectuer des opérations sur les objets GlideDate, telles que l'instanciation d'objets GlideDate ou l'utilisation des champs GlideDate.

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.").

## GlideDate inclus dans le champ d'application : GlideDate() {#ariaid-title2}

Crée un objet GlideDate avec la date et l'heure actuelles.
{#r_ScopedGlideDateGlideDate__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateGlideDate__table_vy2_525_jq}  

    //Today's date is April 21, 2021
    var gd = new GlideDate();
    gs.info(gd.getValue());

Sortie :

    2021-04-21

## GlideDate inclus dans le champ d'application : getByFormat (format de chaîne) {#ariaid-title3}

Obtient la date au format de date spécifié.
{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| format | Chaîne | Format de date souhaité utilisant Java [SimpleDateFormat](https://docs.oracle.com/javase/10/docs/api/java/text/SimpleDateFormat.html). Par exemple, `<< jj-MM-aaaa >>` pour obtenir le jour, le mois et l'année, ou `<< EEEE >>` pour obtenir le jour de la semaine. |
[Tableau 2. Paramètres]

{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de date pour l'objet GlideDate au format spécifié. |
[Tableau 3. Renvoie]

{#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getByFormat("dd-MM-yyyy"));

Sortie :

    21-04-2021

## GlideDate inclus dans le champ d'application : getDayOfMonthNoTZ() {#ariaid-title4}

Obtient le jour du mois stocké par l'objet GlideDate, exprimé dans le fuseau horaire UTC.
{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv__entry__3}

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

{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv} {#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv__entry__2}

| Type | Description |
|-|-|
| Numéro | Jour du mois dans le fuseau horaire UTC, de 1 à 31. |
[Tableau 5. Renvoie]

{#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv}  

    //Today's date is 2016-05-13 
    var gd =new GlideDate();
    gs.info(gd.getDayOfMonthNoTZ());

Sortie :

    13

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

Obtient la date dans le format d'affichage et le fuseau horaire de l'utilisateur actuel.
{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 6. Paramètres]

{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de date de l'objet GlideDate 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, gardez à l'esprit que cette méthode peut renvoyer des valeurs dans différents formats pour différents utilisateurs. |
[Tableau 7. Renvoie]

{#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getDisplayValue());

Sortie :

    2021-04-21

## GlideDate inclus dans le champ d'application : getDisplayValueInternal() {#ariaid-title6}

Obtient la date au format interne (aaaa-MM-jj) et le fuseau horaire de l'utilisateur actuel.
{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 8. Paramètres]

{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de date de l'objet GlideDate dans le fuseau horaire de l'utilisateur actuel. Format : aaaa-MM-jj |
[Tableau 9. Renvoie]

{#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gs.info(gd.getDisplayValueInternal());

Sortie :

    2021-04-21

## GlideDate inclus dans le champ d'application : getDisplayValueLang(style de chaîne, langue de chaîne) {#ariaid-title7}

Renvoie la valeur de date dans les paramètres régionaux de l'utilisateur en fonction d'une langue et d'un style de date spécifiés.
{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb__entry__3}

| Nom | Type | Description |
|-|-|-|
| style | Chaîne | Format de date. Valeurs valides : * complet : renvoie la date au format \<jour de la semaine, mois, jour et année\> en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \<mois, jour et année\> en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/MM/AA en fonction des paramètres régionaux de l'utilisateur (par exemple, 24/10/2022 ou 24/10/2022). Si une autre valeur est transmise, l'API utilise `la valeur moyenne` par défaut. Les valeurs acceptées ne sont pas sensibles à la casse. |
| language | Chaîne | Renvoie la date en fonction d'une valeur de langue spécifiée. Accepte les étiquettes de langue conformes à la norme BCP-47. Par exemple, `fr pour le` français ou `en-UK pour l'anglais` britannique. Pour obtenir la liste complète des valeurs acceptées, consultez [la liste des codes de langue BCP 47](https://appmakers.dev/bcp-47-language-codes-list/). |
[Tableau 10. Paramètres]

{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb} {#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Date dans le style et la langue spécifiés en fonction des paramètres régionaux de l'utilisateur actuel. |
[Tableau 11. Renvoie]

{#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb}  
L'exemple suivant renvoie la date des paramètres régionaux de l'utilisateur dans différentes langues et styles.

    var gd = new GlideDate(); // This will fetch the current date


    gs.info('date: ' + gd.getDisplayValue());

    gs.info('date: ' + gd.getDisplayValueLang("full", "fr"));
    gs.info('date: ' + gd.getDisplayValueLang("long", "en-GB"));
    gs.info('date: ' + gd.getDisplayValueLang("medium", "de"));
    gs.info('date: ' + gd.getDisplayValueLang("short", "es-MX"));

Sortie :


    date: 2023-01-18
    date: mercredi 18 janvier 2023
    date: 18 January 2023
    date: 18.01.2023
    date: 18/01/23

## GlideDate inclus dans le champ d'application : getMonthNoTZ() {#ariaid-title8}

Obtient le mois stocké par l'objet GlideDate, exprimé dans le fuseau horaire UTC.
{#r_SGD-getMonthNoTZ__table_az1_3wq_yv__entry__3}

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

{#r_SGD-getMonthNoTZ__table_az1_3wq_yv} {#r_SGD-getMonthNoTZ__table_bz1_3wq_yv__entry__2}

| Type | Description |
|-|-|
| Numéro | La valeur numérique du mois de 1 à 12. |
[Tableau 13. Renvoie]

{#r_SGD-getMonthNoTZ__table_bz1_3wq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getMonthNoTZ());

Sortie :

    5

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

Obtient la date au format interne (aaaa-MM-jj) et le fuseau horaire du système (UTC par défaut).
{#r_ScopedGlideDateGetValue__table_vy2_535_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 14. Paramètres]

{#r_ScopedGlideDateGetValue__table_vy2_535_jq} {#r_ScopedGlideDateGetValue__table_qpt_3f5_jq__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de date de l'objet GlideDate dans le fuseau horaire du système. Format : aaaa-MM-jj |
[Tableau 15. Renvoie]

{#r_ScopedGlideDateGetValue__table_qpt_3f5_jq}  

    var gd = new GlideDate();
    gd.setValue('2021-04-21');
    gs.info(gd.getValue());

Sortie :

    2021-04-21

## GlideDate inclus dans le champ d'application : getYearNoTZ() {#ariaid-title10}

Obtient l'année stockée par l'objet GlideDate, exprimée dans le fuseau horaire UTC.
{#r_SGD-getYearNoTZ__table_pnp_hxq_yv__entry__3}

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

{#r_SGD-getYearNoTZ__table_pnp_hxq_yv} {#r_SGD-getYearNoTZ__table_qnp_hxq_yv__entry__2}

| Type | Description |
|-|-|
| Numéro | Valeur numérique de l'année. |
[Tableau 17. Renvoie]

{#r_SGD-getYearNoTZ__table_qnp_hxq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getYearNoTZ());

Sortie :

    2016

## GlideDate inclus dans le champ d'application : setDisplayValue(String asDisplayed) {#ariaid-title11}

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

| Nom | Type | Description |
|-|-|-|
| asDisplayed | Chaîne | Date dans le format d'affichage et le fuseau horaire de l'utilisateur actuel. Format : doit être formaté à l'aide du format d'affichage préféré de l'utilisateur actuel, tel que aaaa-MM-jj. |
[Tableau 18. Paramètres]

{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate();
    gd.setDisplayValue("2011-01-01");
    gs.info(gd.getValue());

Sortie :

    2011-01-01

## GlideDate inclus dans le champ d'application : setDisplayValueLang(String date, String style) {#ariaid-title12}

Définit une date à l'aide d'un style et d'un format spécifiés en fonction des paramètres régionaux de l'utilisateur actuel.
{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb__entry__3}

| Nom | Type | Description |
|-|-|-|
| date | Chaîne | Valeur de date de l'objet GlideDate dans le fuseau horaire de l'utilisateur actuel. Les valeurs valides sont n'importe quelle date et heure sortie de la fonction getDisplayValueLang(). Par exemple, en utilisant la sortie de l'exemple getDisplayValueLang(String style, String language) plus haut dans cette rubrique , le 25 octobre 2022 ou le 25.10.2022 sont des valeurs acceptées. |
| style | Chaîne | Format de date. Valeurs valides : * complet : renvoie la date au format \<jour de la semaine, mois, jour et année\> en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \<mois, jour et année\> en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/MM/AA en fonction des paramètres régionaux de l'utilisateur (par exemple, 24/10/2022 ou 24/10/2022). Si une autre valeur est transmise, l'API utilise `la valeur moyenne` par défaut. Les valeurs acceptées ne sont pas sensibles à la casse. |
[Tableau 20. Paramètres]

{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb} {#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 21. Renvoie]

{#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb}  
L'exemple suivant montre comment définir la date actuelle de la locale de l'utilisateur sur le style 'full' à l'aide de setDisplayValueLang().

    glideDate.setDisplayValueLang("2/3/2023", "short");


    gs.info('date: ' + glideDate.getDisplayValue());
    gs.info('date: ' + glideDate.getDisplayValueLang("full"));

Sortie :

    date: 2023-02-03
    date: Friday, February 3, 2023

## GlideDate inclus dans le champ d'application : setDisplayValueLang(date de chaîne, style de chaîne, langue de chaîne) {#ariaid-title13}

Définit une date à l'aide d'un style, d'une langue et d'un format spécifiés en fonction des paramètres régionaux de l'utilisateur actuel.
{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb__entry__3}

| Nom | Type | Description |
|-|-|-|
| date | Chaîne | Valeur de date de l'objet GlideDate dans le fuseau horaire de l'utilisateur actuel. Les valeurs valides sont n'importe quelle date et heure sortie de la fonction getDisplayValueLang(). Par exemple, en utilisant la sortie de l'exemple getDisplayValueLang(String style, String language) plus haut dans cette rubrique , le 25 octobre 2022 ou le 25.10.2022 sont des valeurs acceptées. |
| style | Chaîne | Format de date. Valeurs valides : * complet : renvoie la date au format \<jour de la semaine, mois, jour et année\> en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \<mois, jour et année\> en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/MM/AA en fonction des paramètres régionaux de l'utilisateur (par exemple, 24/10/2022 ou 24/10/2022). Si une autre valeur est transmise, l'API utilise `la valeur moyenne` par défaut. Les valeurs acceptées ne sont pas sensibles à la casse. |
| language | Chaîne | Définit la langue à l'aide d'une balise de langue conforme à la norme BCP-47. Par exemple, `fr pour le` français ou `en-UK pour l'anglais` britannique. Pour obtenir la liste complète des valeurs acceptées, consultez [la liste des codes de langue BCP 47](https://appmakers.dev/bcp-47-language-codes-list/). |
[Tableau 22. Paramètres]

{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb} {#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb__entry__2}

| Type | Description |
|-|-|
| Nul |   |
[Tableau 23. Renvoie]

{#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb}  
L'exemple suivant renvoie la date et l'heure dans des styles courts et complets pour l'anglais et le français.

    var glideDateFR = new GlideDate(); 

    glideDateUS.setDisplayValueLang("2/3/202", "short", "en-US" );
    glideDateFR.setDisplayValueLang("2/3/2023", "short", "fr-FR" );

    gs.info('en-US date: ' + glideDateUS.getDisplayValue());
    gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));

    gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
    gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));

Sortie :

    en-US date: 2023-02-03
    en-US date: Friday, February 3, 2023
    fr-FR date: 2023-03-02
    fr-FR date: Thursday, March 2, 2023

## GlideDate inclus dans le champ d'application : setValue(String o) {#ariaid-title14}

Définit la date de l'objet GlideDate actuel au format interne (aaaa-MM-jj) et le fuseau horaire du système (UTC par défaut).
{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| o | Chaîne | Date et heure à définir dans l'objet GlideDate actuel. Format : aaaa-MM-jj |
[Tableau 24. Paramètres]

{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate(); 
    gd.setValue('2015-01-01');
    gs.info(gd.getValue());

Sortie :

    2015-01-01

## GlideDate inclus dans le champ d'application : soustraire (début GlideDate, fin GlideDate) {#ariaid-title15}

Obtient la différence de durée entre deux valeurs GlideDate.
{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq__entry__3}

| Nom | Type | Description |
|-|-|-|
| début | Date Glide | Valeur de départ. |
| fin | Date Glide | Valeur de fin. |
[Tableau 26. Paramètres]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq} {#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq}  

    var sgd1 = new GlideDate(); 
    sgd1.setDisplayValue('2014-07-18'); 
    var sgd2 = new GlideDate(); 
    sgd2.setDisplayValue('2014-07-19'); 
     
    var duration = GlideDate.subtract(sgd1, sgd2); 
    gs.info(duration.getDisplayValue());

Sortie :

    1 Day