GlideDate : global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 13 minutes de lecture

    • La classe GlideDate fournit des méthodes pour effectuer des opérations sur les objets GlideDate, telles que l’instanciation d’objets GlideDate ou l’utilisation de champs GlideDate.

    Pour obtenir des conseils sur les chaînes d’entrée de date et d’heure avec une liste de conflits de format courants, reportez-vous à .Directives relatives aux formats de date et d’heure

    Voir aussi GlideDateTime : global.

    GlideDate : GlideDate()

    Crée un objet GlideDate avec la date et l’heure actuelles.

    Tableau 1. Paramètres
    Nom Type Description
    Néant 
    //Today's date is April 21, 2021
var gd = new GlideDate();
gs.info(gd.getValue());
    Sortie : 
    2021-04-21

    GlideDate : getByFormat (format de chaîne)

    Obtient la date au format de date spécifié.

    Tableau 2. Paramètres
    Nom Type Description
    format Chaîne Format de date souhaité utilisant Java SimpleDateFormat. 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 3. Renvoie
    Type Description
    Chaîne Valeur de date pour l’objet GlideDate au format spécifié. 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getByFormat("dd-MM-yyyy"));
    Sortie : 
    21-04-2021

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le périmètre : getByFormat(format de chaîne).

    GlideDate : getDayOfMonthNoTZ()

    Obtient le jour du mois stocké par l’objet GlideDate, exprimé dans le fuseau horaire UTC.

    Tableau 4. Paramètres
    Nom Type Description
    Néant
    Tableau 5. Renvoie
    Type Description
    Numéro Le jour du mois dans le fuseau horaire UTC, de 1 à 31. 
    //Today's date is 2016-05-13 
var gd =new GlideDate();
gs.info(gd.getDayOfMonthNoTZ());

    Sortie :

    13

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le périmètre : getMonthNoTZ().

    GlideDate : getDisplayValue()

    Obtient la valeur du champ de date et d’heure dans le fuseau horaire UTC.

    Voir aussi : GlideDate inclus dans le champ d’application : getDisplayValue()

    Tableau 6. Paramètres
    Nom Type Description
    aucun
    Tableau 7. Renvoie
    Type Description
    Chaîne Valeur de date pour l’objet GlideDate dans le fuseau horaire UTC. 
    var gd = new GlideDate(); 
gd.setValue('2025-04-21');
gs.info(gd.getDisplayValue());
    Sortie : 
    2025-04-21

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le champ d’application : getDisplayValue().

    GlideDate : getDisplayValueEx(style de chaîne)

    Renvoie la date à l’aide du fuseau horaire de l’utilisateur actuel et d’un format spécifié.

    Tableau 8. Paramètres
    Nom Type Description
    Le style Chaîne Format à utiliser pour la date.
    Valeurs valides (insensibles à la casse) :
    • abrégé : J/J/AA ou J/M/AA selon la langue de l’utilisateur actuel. Par exemple, 27/01/26 ou 01/27/26.
    • moyen : mois, jour et année abrégés. Par exemple, le 27 janvier 2026.
    • long : mois, jour et année. Par exemple, le 27 janvier 2026.
    • complet : Jour de la semaine, du mois, du jour et de l’année. Par exemple, le mardi 27 janvier 2026.

    La date est renvoyée dans la langue de l’utilisateur actuel. La langue détermine l’ordre du mois et du jour dans la date.
    Tableau 9. Renvoie
    Type Description
    Chaîne La date au format spécifié.

    Cet exemple renvoie la date à l’aide du fuseau horaire de l’utilisateur actuel et de chaque option de formatage.

    var gd = new GlideDate();
gs.info(gd.getDisplayValueEx("short"));
gs.info(gd.getDisplayValueEx("medium"));
gs.info(gd.getDisplayValueEx("long"));
gs.info(gd.getDisplayValueEx("full"));

    Sortie :

    1/27/26  //short
Jan 27, 2026  //medium
January 27, 2026  //long
Tuesday, January 27, 2026  //full

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate dans le champ d’application : getDisplayValueEx(style de chaîne).

    GlideDate : getDisplayValueInternal()

    Obtient la date au format interne (aaaa-MM-jj) et le fuseau horaire de l’utilisateur actuel.

    Voir aussi getDisplayValue()

    Tableau 10. Paramètres
    Nom Type Description
    aucun
    Tableau 11. Renvoie
    Type Description
    Chaîne Valeur de date de l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel.

    Format : aaaa-MM-jj

    		 
    var gd = new GlideDate(); 
gs.info(gd.getDisplayValueInternal());
    Sortie : 
    2021-04-21

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le champ d’application : getDisplayValueInternal().

    GlideDate : getDisplayValueLang(style de chaîne)

    Renvoie la valeur de date dans les paramètres régionaux de l’utilisateur en fonction d’un style de date spécifié.

    Tableau 12. Paramètres
    Nom Type Description
    Le 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).
    • short : renvoie la date au format MM/JJ/AA ou JJ/MM/AA en fonction des paramètres régionaux de l’utilisateur (par exemple, 24/10/2022 ou 10/24/2022).

    Si une autre valeur est transmise, l’API est définie par défaut sur moyen. Les valeurs acceptées ne sont pas sensibles à la casse.
    Tableau 13. Renvoie
    Type Description
    Chaîne Représentation sous forme de chaîne de la date dans le style spécifié et au format approprié pour les paramètres régionaux de l’utilisateur actuel.

    L’exemple suivant renvoie la date des paramètres régionaux de l’utilisateur dans tous les styles.

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


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

gs.info('date: ' + gd.getDisplayValueLang("full"));
gs.info('date: ' + gd.getDisplayValueLang("long"));
gs.info('date: ' + gd.getDisplayValueLang("medium"));
gs.info('date: ' + gd.getDisplayValueLang("short"));

    Sortie :

    date: 2023-01-18
Wednesday, January 18, 2023
date: January 18, 2023
date: Jan 18, 2023
date: 1/18/23

    GlideDate : getDisplayValueLang(style de chaîne, langage de chaîne)

    Renvoie la valeur de date dans les paramètres régionaux et la langue de l’utilisateur en fonction d’un style de date spécifié.

    Tableau 14. Paramètres
    Nom Type Description
    Le 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).
    • short : renvoie la date au format MM/JJ/AA ou JJ/MM/AA en fonction des paramètres régionaux de l’utilisateur (par exemple, 24/10/2022 ou 10/24/2022).

    Si une autre valeur est transmise, l’API est définie par défaut sur moyen. 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 balises 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.
    Tableau 15. Renvoie
    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.

    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 : getMonthNoTZ()

    Obtient le mois stocké par l’objet GlideDate, exprimé dans le fuseau horaire UTC.

    Tableau 16. Paramètres
    Nom Type Description
    Néant
    Tableau 17. Renvoie
    Type Description
    Numéro La valeur numérique du mois de 1 à 12. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getMonthNoTZ());

    Sortie :

    5

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le périmètre : getMonthNoTZ().

    GlideDate : getYearNoTZ()

    Obtient l’année stockée par l’objet GlideDate, exprimée dans le fuseau horaire UTC.

    Tableau 18. Paramètres
    Nom Type Description
    Néant
    Tableau 19. Renvoie
    Type Description
    Numéro Valeur numérique de l’année. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

    Sortie :

    2016

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le périmètre : getYearNoTZ().

    GlideDate : parseDate (date de chaîne, langue de la chaîne, pays de la chaîne)

    Analyse une date au paramètre régional associé aux codes de langue et de pays transmis.

    Remarque :
    Cette méthode échoue et lève une exception si le format de date régional n’est pas respecté.
    Tableau 20. Paramètres
    Nom Type Description
    date Chaîne Date formatée dans la syntaxe régionale.

    Formats :

    • Dates alphanumériques : vous pouvez spécifier les mois sous la forme de trois caractères tels que janvier, février ou mars, ou épeler entièrement le nom du mois. Les années doivent être à quatre chiffres et les jours à deux chiffres. Par exemple : « 31 janvier 2020 » ou « 31 janvier 2020 »
    • Dates numériques : Les jours et les mois doivent être composés de deux chiffres. Les quatre chiffres sont fortement préférés pendant des années, bien que la méthode prenne en charge une année à deux chiffres avec moins de précision et un risque plus élevé d’échec de l’analyse. Vous devez également utiliser le séparateur de date régional. Ces séparateurs affectent l’analyse en fonction des valeurs transmises language et country . Par exemple : « 12/31/2020 » pour les paramètres régionaux américains et « 31.12.20 » pour les paramètres régionaux estoniens.
    language Chaîne Code de langue ISO-639 à deux caractères.
    pays Chaîne Code de pays ISO-3166 à deux caractères.
    Tableau 21. Renvoie
    Type Description
    Objet Objet GlideDate analysé que vous pouvez utiliser dans des calculs ou insérer dans un enregistrement.

    Cette méthode lève une exception si la date n’a pas pu être analysée. Une exception se produit lorsque le format de date ne correspond pas au format local spécifié (paramètres et languagecountry réussis).

    L’exemple de code suivant analyse une date et ajoute quatre semaines à cette date.

    var date = GlideDate.parseDate("31 Dec 2020", "en", "GB");
date.addWeeksLocalTime(4);
gs.info("Project is due 4 weeks after start date, on " + date.getDisplayValue());

    Sortie :

    Project is due 4 weeks after start date, on 2021-01-28

    GlideDate : setDisplayValue (chaîne asDisplayed)

    Définit une valeur de date à l’aide du format d’affichage et du fuseau horaire de l’utilisateur actuel.

    Tableau 22. Paramètres
    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 23. Renvoie
    Type Description
    Néant 
    var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

    Sortie :

    2011-01-01

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le champ d’application : setDisplayValue(String asDisplayed).

    GlideDate : setDisplayValueEx(date de chaîne, style de chaîne)

    Définit la date à l’aide d’un format spécifié.

    Tableau 24. Paramètres
    Nom Type Description
    date Chaîne Valeur à définir pour la date.
    La méthode getDisplayValueEx() renvoie les dates dans un format valide, ou les dates peuvent être formatées comme indiqué ci-dessous.
    • M/J/AA ou J/M/AA selon la langue de l’utilisateur. Par exemple, 27/01/26 ou 01/27/26.
    • Mois, jour et année abrégés. Par exemple, le 27 janvier 2026.
    • Mois, jour et année. Par exemple, le 27 janvier 2026.
    • Jour de la semaine, du mois, du jour et de l’année. Par exemple, le mardi 27 janvier 2026.
    La langue de l’utilisateur actuel détermine l’ordre accepté du mois et du jour dans la date. Par exemple, si la langue de l’utilisateur actuel est l’anglais, le 21/03/26 et le 21 mars 2026 sont des valeurs valides, alors que le 26/03/21 et le 21 mars 2026 ne le sont pas.
    Le style Chaîne Format à utiliser pour la date.

    Vous devez utiliser le même format que la valeur fournie date .

    Valeurs valides (insensibles à la casse) :
    • abrégé : J/J/AA ou J/M/AA selon la langue de l’utilisateur actuel. Par exemple, 27/01/26 ou 01/27/26.
    • moyen : mois, jour et année abrégés. Par exemple, le 27 janvier 2026.
    • long : mois, jour et année. Par exemple, le 27 janvier 2026.
    • complet : Jour de la semaine, du mois, du jour et de l’année. Par exemple, le mardi 27 janvier 2026.
    Tableau 25. Renvoie
    Type Description
    Néant

    Cet exemple définit la date à l’aide d’un format spécifié.

    gd = new GlideDate();
gd.setDisplayValueEx("Jan 28, 2026", "medium");
gs.info(gd.getDisplayValueEx("full"));

    Sortie :

    Wednesday, January 28, 2026

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate dans le champ d’application : setDisplayValueEx(date de chaîne, style de chaîne).

    GlideDate : setDisplayValueLang(date de chaîne, style de chaîne)

    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.

    Tableau 26. Paramètres
    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 sortie de date et d’heure 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.
    Le 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).
    • short : renvoie la date au format MM/JJ/AA ou JJ/MM/AA en fonction des paramètres régionaux de l’utilisateur (par exemple, 24/10/2022 ou 10/24/2022).

    Si une autre valeur est transmise, l’API est définie par défaut sur moyen. Les valeurs acceptées ne sont pas sensibles à la casse.
    Tableau 27. Renvoie
    Type Description
    nul

    L’exemple suivant montre comment vous pouvez définir la date actuelle des paramètres régionaux de l’utilisateur sur le style « complet » à 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 : setDisplayValueLang(date de chaîne, style de chaîne, langage de chaîne)

    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.

    Tableau 28. Paramètres
    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 sortie de date et d’heure 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.
    Le 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).
    • short : renvoie la date au format MM/JJ/AA ou JJ/MM/AA en fonction des paramètres régionaux de l’utilisateur (par exemple, 24/10/2022 ou 10/24/2022).

    Si une autre valeur est transmise, l’API est définie par défaut sur moyen. 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.
    Tableau 29. Renvoie
    Type Description
    Nul

    L’exemple suivant renvoie la date et l’heure dans des styles court et complet 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 : setValue(chaîne o)

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

    Tableau 30. Paramètres
    Nom Type Description
    o Chaîne Date et heure à définir dans l’objet GlideDate actuel.

    Format : aaaa-MM-jj
    Tableau 31. Renvoie
    Type Description
    Néant 
    var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

    Sortie :

    2015-01-01

    Équivalent dans le champ d’application

    Pour utiliser cette méthode dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : GlideDate incluse dans le périmètre : setValue(String o).