GlideDate : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 8 minutes de lecture

    • La classe GlideDate incluse dans le champ d’application fournit des méthodes pour 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 d’heure avec une liste des conflits de format courants, reportez-vous à .Directives relatives aux formats de date et d’heure

    GlideDate inclus dans le champ d’application : 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 inclus dans le champ d’application : 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é à l’aide de 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

    GlideDate inclus dans le champ d’application : getDayOfMonthNoTZ()

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

    Tableau 4. Paramètres
    Nom Type Description
    Aucun
    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

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

    Obtient la date dans le format d’affichage et le fuseau horaire de l’utilisateur actuel.

    Tableau 6. Paramètres
    Nom Type Description
    Aucun
    Tableau 7. Renvoie
    Type Description
    Chaîne Valeur de date de l’objet GlideDate dans le format d’affichage et le fuseau horaire de l’utilisateur actuel. Gardez à l’esprit lors de la conception de règles métier ou d’includes de script que cette méthode peut renvoyer des valeurs dans différents formats pour différents utilisateurs. 
    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()

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

    Tableau 8. Paramètres
    Nom Type Description
    Aucun
    Tableau 9. Renvoie
    Type Description
    Chaîne Valeur de date pour 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

    GlideDate inclus dans le champ d’application : getDisplayValueLang(style de chaîne, langage de chaîne)

    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.

    Tableau 10. Paramètres
    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 JJ/MM/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, la valeur par défaut de l’API est moyenne. 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 11. 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 inclus dans le champ d’application : getMonthNoTZ()

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

    Tableau 12. Paramètres
    Nom Type Description
    Aucun
    Tableau 13. 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

    GlideDate inclus dans le champ d’application : getValue()

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

    Tableau 14. Paramètres
    Nom Type Description
    Aucun
    Tableau 15. Renvoie
    Type Description
    Chaîne Valeur de date de l’objet GlideDate dans le fuseau horaire du système.

    Format : aaaa-MM-jj

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

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

    Tableau 16. Paramètres
    Nom Type Description
    Aucun
    Tableau 17. 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

    GlideDate inclus dans le champ d’application : setDisplayValue(String asDisplayed)

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

    Tableau 18. 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 19. Renvoie
    Type Description
    Néant 
    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(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 20. Paramètres
    Nom Type Description
    date Chaîne Valeur de date pour l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel. Les valeurs valides sont la date et l’heure de 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 JJ/MM/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, la valeur par défaut de l’API est moyenne. Les valeurs acceptées ne sont pas sensibles à la casse.
    Tableau 21. Renvoie
    Type Description
    nul

    L’exemple suivant montre comment 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 inclus dans le champ d’application : 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 22. Paramètres
    Nom Type Description
    date Chaîne Valeur de date pour l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel. Les valeurs valides sont la date et l’heure de 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 JJ/MM/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, la valeur par défaut de l’API est moyenne. 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 23. Renvoie
    Type Description
    Nul

    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)

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

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

    Format : aaaa-MM-jj
    Tableau 25. Renvoie
    Type Description
    Néant 
    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 de GlideDate, fin de GlideDate)

    Obtient la différence de durée entre deux valeurs GlideDate.

    Tableau 26. Paramètres
    Nom Type Description
    début Date GlideDate Valeur de départ.
    fin Date GlideDate Valeur de fin.
    Tableau 27. Renvoie
    Type Description
    Durée GlideDuration Durée entre les deux valeurs. 
    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