GlideDateTime : inclus dans le champ d’application

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 29 minutes de lecture

    • La classe GlideDateTime incluse dans le champ d’application fournit des méthodes permettant d’effectuer des opérations sur des objets GlideDateTime, telles que l’instanciation d’objets GlideDateTime ou l’utilisation de champs glide_date_time.

    Utilisez les méthodes GlideDateTime pour effectuer des opérations date-heure, telles que l’instanciation d’un objet GlideDateTime , l’exécution de calculs de date-heure, la mise en forme d’une date-heure ou la conversion entre des formats date-heure.

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

    GlideDateTime inclus dans le périmètre : GlideDateTime()

    Instancie un nouvel objet GlideDateTime avec la date et l’heure actuelles.

    Tableau 1. Paramètres
    Nom Type Description
    Néant

    Cet exemple instancie un objet GlideDateTime .

    var gdt = new GlideDateTime();
gs.info(gdt);

    Sortie :

    2022-08-08 16:51:44

    Défini dans le champ d’application GlideDateTime : GlideDateTime(valeur de chaîne)

    Instancie un nouvel objet GlideDateTime à l’aide de la valeur de date et d’heure transmise.

    Le système tente de faire correspondre la valeur transmise au format système interne spécifié. Si l’argument ne correspond pas au format système, le système tente de le faire correspondre à l’un des formats suivants dans cet ordre :
    • aaaa-MM-jj hh:mm:ss
    • MM/jj/aaaa hh :mm :ss
    • MM-jj-aaaa hh:mm:ss
    • MM-jj-a HH :mm
    • mm-jj-aaaa
    • MM/jj/aa HH :mm :ss
    • MM/jj/aaaa
    • jj-MM-aaaa hh:mm:ss
    • jj-MM-aaaa HH.mm.ss
    • jj-MM-aaaa HH.mm
    • jj-MM-aa HH :mm :ss
    • jj-MM-aa HH.mm.ss
    • jj/mm/aaaa
    • jj-mm-aaaa
    • aaaa-MM-jj HH :mm
    • aaaa-MM-jj
    • jj.MM.aaaa hh :mm :ss
    • jj.MM.aaaa HH.mm.ss
    • jj.MM.aaaa hh :mm :ss a
    • jj.MM.aaaa hh.mm.ss un
    • jj.MM.aaaa
    Remarque :
    Le format suivant n’est pas pris en charge actuellement :
    aaaa-MM-jj’T’HH :mm :ss. SSSZ (en anglais seulement)
    Tableau 2. Paramètres
    Nom Type Description
    valide Chaîne Date et heure UTC à définir dans l’objet GlideDateTime . 
    var gdt = new GlideDateTime("2023-01-01 12:00:00");
gs.info(gdt);

    Sortie :

    2023-01-01 12:00:00

    GlideDateTime inclus dans le périmètre : GlideDateTime(GlideDateTime g)

    Instancie un nouvel objet GlideDateTime défini sur l’heure d’un objet GlideDateTime spécifié.

    Tableau 3. Paramètres
    Nom Type Description
    g GlideDateTime Objet utilisé pour régler l’heure du nouvel objet.

    Cet exemple instancie un objet GlideDateTime à l’aide de l’attribut aaaa-MM-jj’T’HH :mm :ss. SSSZ .

    var gdt1 = new GlideDateTime("2023-07-04T12:08:56.235-0700");
var gdt2 = new GlideDateTime(gdt1);
gs.info(gdt1);
gs.info(gdt2);

    Sortie :

    2023-07-04 19:08:56
2023-07-04 19:08:56

    GlideDateTime inclus dans le périmètre : add(GlideTime gd)

    Ajoute un objet GlideTime à l’objet GlideDateTime actuel.

    Tableau 4. Paramètres
    Nom Type Description
    Gd Temps Glide Objet GlideTime dont la valeur de temps doit être ajoutée à l’objet GlideDateTime spécifié.
    Tableau 5. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));

    Sortie :

    08:00:20

    GlideDateTime inclus dans le champ d’application : add(nombre de millisecondes)

    Ajoute le nombre spécifié de millisecondes à l’objet GlideDateTime actuel.

    Tableau 6. Paramètres
    Nom Type Description
    millisecondes Numéro Nombre de millisecondes à ajouter.
    Tableau 7. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());
gdt.add(10);
gs.info(gdt.getNumericValue());
    Sortie : 
    1314777600000 1314777600010

    GlideDateTime inclus dans le champ d’application : addDaysLocalTime(nombre de jours)

    Ajoute un nombre spécifié de jours à l’objet GlideDateTime actuel. Un paramètre négatif soustrait les jours. La méthode détermine l’équivalent de date et d’heure locales à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait les jours à l’aide des valeurs de date et d’heure locales.

    Tableau 8. Paramètres
    Nom Type Description
    jours Numéro Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 9. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.info(gdt.getLocalDate());

    Sortie :

    2011-08-30

    GlideDateTime inclus dans le champ d’application : addDaysUTC(nombre de jours)

    Ajoute un nombre spécifié de jours à l’objet GlideDateTime actuel. Un paramètre négatif soustrait les jours. La méthode détermine l’équivalent de la date et de l’heure UTC à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait les jours à l’aide des valeurs de date et d’heure UTC.

    Tableau 10. Paramètres
    Nom Type Description
    jours Numéro Nombre de jours à ajouter. Utilisez un nombre négatif pour soustraire.
    Tableau 11. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.info(gdt.getDate());

    Sortie :

     2011-08-30

    GlideDateTime inclus dans le champ d’application : addMonthsLocalTime(nombre de mois)

    Ajoute un nombre spécifié de mois à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des mois. La méthode détermine l’équivalent de date et d’heure locales à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait les mois à l’aide des valeurs de date et d’heure locales.

    Tableau 12. Paramètres
    Nom Type Description
    mois Numéro Nombre de mois à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 13. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.info(gdt.getDate());

    Sortie :

    2011-10-31

    GlideDateTime inclus dans le champ d’application : addMonthsUTC(nombre de mois)

    Ajoute un nombre spécifié de mois à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des mois. La méthode détermine l’équivalent de la date et de l’heure UTC à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait les mois à l’aide des valeurs de date et d’heure UTC.

    Tableau 14. Paramètres
    Nom Type Description
    mois Numéro Nombre de mois à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 15. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.info(gdt.getDate());

    Sortie :

    2011-10-31

    GlideDateTime inclus dans le champ d’application : addSeconds(nombre de secondes)

    Ajoute le nombre spécifié de secondes à l’objet GlideDateTime actuel.

    Tableau 16. Paramètres
    Nom Type Description
    secondes Numéro Nombre de secondes à ajouter.
    Tableau 17. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.info(gdt.getValue());

    Sortie :

    2011-12-07 08:16:40

    GlideDateTime inclus dans le champ d’application : addWeeksLocalTime(nombre de semaines)

    Ajoute un nombre spécifié de semaines à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des semaines. La méthode détermine l’équivalent de date et d’heure locales à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des semaines à l’aide des valeurs de date et d’heure locales.

    Tableau 18. Paramètres
    Nom Type Description
    semaines Numéro Nombre de semaines à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 19. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.info(gdt.getDate());

    Sortie :

    2011-08-24

    GlideDateTime inclus dans le champ d’application : addWeeksUTC(nombre de semaines)

    Ajoute un nombre spécifié de semaines à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des semaines. La méthode détermine l’équivalent de la date et de l’heure UTC à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des semaines à l’aide des valeurs de date et d’heure UTC.

    Tableau 20. Paramètres
    Nom Type Description
    semaines Numéro Nombre de semaines à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 21. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.info(gdt.getDate());

    Sortie :

    2011-08-24

    GlideDateTime inclus dans le champ d’application : addYearsLocalTime(Nombre d’années)

    Ajoute un nombre spécifié d’années à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des années. La méthode détermine l’équivalent de date et d’heure locales à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des années à l’aide des valeurs de date et d’heure locales.

    Tableau 22. Paramètres
    Nom Type Description
    années Numéro Nombre d’années à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 23. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.info(gdt.getDate());

    Sortie :

    2011-08-31

    GlideDateTime inclus dans le champ d’application : addYearsUTC(Nombre d’années)

    Ajoute un nombre spécifié d’années à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des années. La valeur de date et d’heure stockée par l’objet GlideDateTime est interprétée comme étant dans le fuseau horaire UTC.

    Tableau 24. Paramètres
    Nom Type Description
    années Numéro Nombre d’années à ajouter. Utilisez une valeur négative pour soustraire.
    Tableau 25. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.info(gdt.getDate());

    Sortie :

    2011-08-31

    GlideDateTime inclus dans le champ d’application : after(GlideDateTime gdt)

    Détermine si la date et l’heure de l’objet GlideDateTime se produisent après la date et l’heure de l’objet spécifié.

    Tableau 26. Paramètres
    Nom Type Description
    Gdt GlideDateTime Date et heure à vérifier.
    Tableau 27. Renvoie
    Type Description
    Booléen Marqueur indiquant si la date et l’heure de l’objet GlideDateTime sont postérieures à la date et à l’heure spécifiées par le paramètre.
    Valeurs possibles :
    • true : la date et l’heure de l’objet GlideDateTime sont postérieures à la date et à l’heure de l’objet spécifié.
    • false : la date et l’heure de l’objet GlideDateTime sont antérieures ou égales à la date et à l’heure de l’objet spécifié.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.after(gdt2));

    Sortie :

    False

    GlideDateTime inclus dans le champ d’application : before (GlideDateTime gdt)

    Détermine si la date et l’heure de l’objet GlideDateTime se produisent avant la date et l’heure de l’objet GlideDateTime spécifié.

    Tableau 28. Paramètres
    Nom Type Description
    Gdt GlideDateTime Date et heure à vérifier.
    Tableau 29. Renvoie
    Type Description
    Booléen Marqueur indiquant si la date et l’heure de l’objet GlideDateTime sont antérieures à la date et l’heure spécifiées par le paramètre.
    Valeurs possibles :
    • true : la date et l’heure de l’objet GlideDateTime sont antérieures à la date et l’heure spécifiées.
    • false : la date et l’heure de l’objet GlideDateTime sont postérieures ou égales à la date et l’heure spécifiées.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.before(gdt2));

    Sortie

    true

    GlideDateTime inclus dans le périmètre : compareTo(Object o)

    Compare deux objets de date et d’heure pour déterminer s’ils sont équivalents ou si l’un d’eux se produit avant ou après l’autre.

    Tableau 30. Paramètres
    Nom Type Description
    O Objet Objet de date et d’heure au format GlideDateTime
    Tableau 31. Renvoie
    Type Description
    Numéro
    • 0 = Les dates sont égales
    • 1 = La date de l’objet est postérieure à la date spécifiée dans le paramètre
    • -1 = La date de l’objet est antérieure à la date spécifiée dans le paramètre
    		 
    var initDate = new GlideDateTime("2011-08-01 12:00:00");
var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
 
gs.info(initDate.compareTo(compDate1)); // Equals (0)
gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)

    Sortie :

    0
1
-1

    GlideDateTime inclus dans le champ d’application - equals(Object dateTime)

    Compare une date/heure avec une valeur existante pour l’égalité.

    Tableau 32. Paramètres
    Nom Type Description
    Datetime Objet ou chaîne GlideDateTime Date/heure à comparer.
    Tableau 33. Renvoie
    Type Description
    Booléen Renvoie la valeur true s’ils sont égaux ; sinon, faux. 
    var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.info(gdt.equals("2011-09-30 00:12:01"));

    Sortie :

    false

    GlideDateTime inclus dans le champ d’application : getDate()

    Renvoie la date stockée par l’objet GlideDateTime. Exprimé au format standard, aaaa-MM-jj, et dans le fuseau horaire du système, GMT par défaut.

    Tableau 34. Paramètres
    Nom Type Description
    Aucun
    Tableau 35. Renvoie
    Type Description
    Objet Date dans le fuseau horaire du système. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDate());

    Sortie :

    2011-08-31

    GlideDateTime inclus dans le périmètre : getDayOfMonthLocalTime()

    Obtient le jour du mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.

    Tableau 36. Paramètres
    Nom Type Description
    Aucun
    Tableau 37. Renvoie
    Type Description
    Numéro Le jour du mois dans le fuseau horaire de l’utilisateur, de 1 à 31. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthLocalTime());

    Sortie :

    2

    GlideDateTime inclus dans le champ d’application : getDayOfMonthUTC()

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

    Tableau 38. Paramètres
    Nom Type Description
    Aucun
    Tableau 39. Renvoie
    Type Description
    Numéro Jour du mois dans le fuseau horaire UTC, de 1 à 31. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthUTC());

    Sortie :

    02

    GlideDateTime inclus dans le périmètre : getDayOfWeekLocalTime()

    Obtient le jour de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur.

    Tableau 40. Paramètres
    Nom Type Description
    Aucun
    Tableau 41. Renvoie
    Type Description
    Numéro Valeur du jour de la semaine, dans le fuseau horaire de l’utilisateur, de 1 à 7. Le lundi est égal à 1, le dimanche est égal à 7. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());

    Sortie :

    4

    GlideDateTime inclus dans le champ d’application : getDayOfWeekUTC()

    Obtient le jour de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.

    Tableau 42. Paramètres
    Nom Type Description
    Aucun
    Tableau 43. Renvoie
    Type Description
    Numéro Valeur du jour de la semaine comprise entre 1 et 7. Le lundi est égal à 1, le dimanche est égal à 7. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());

    Sortie :

    4

    GlideDateTime inclus dans le périmètre : getDaysInMonthLocalTime()

    Obtient le nombre de jours du mois stockés par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.

    Tableau 44. Paramètres
    Nom Type Description
    Aucun
    Tableau 45. Renvoie
    Type Description
    Numéro Nombre de jours du mois actuel dans le fuseau horaire de l’utilisateur. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
gs.info(gdt.getDaysInMonthLocalTime());

    Sortie :

    30

    GlideDateTime inclus dans le champ d’application : getDaysInMonthUTC()

    Obtient le nombre de jours du mois stockés par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.

    Tableau 46. Paramètres
    Nom Type Description
    Aucun
    Tableau 47. Renvoie
    Type Description
    Numéro Nombre de jours du mois stockés par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getDaysInMonthUTC());

    Sortie :

    30

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

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

    Tableau 48. Paramètres
    Nom Type Description
    Aucun
    Tableau 49. Renvoie
    Type Description
    Chaîne Date et heure au format et fuseau horaire de l’utilisateur. Gardez à l’esprit, lors de la conception de règles métier ou de script includes, que cette méthode peut renvoyer des valeurs dans différents formats pour différents utilisateurs. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)

    Sortie :

    2011-08-31 01:00:00

    GlideDateTime inclus dans le champ d’application : getDisplayValueInternal()

    Obtient la valeur d’affichage au format interne (aaaa-MM-jj HH :mm :ss).

    Tableau 50. Paramètres
    Nom Type Description
    Aucun
    Tableau 51. Renvoie
    Type Description
    Chaîne Les valeurs de date et d’heure de l’objet GlideDateTime dans le fuseau horaire de l’utilisateur actuel et le format de date et d’heure interne de aaaa-MM-jj HH :mm :ss. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00"); 
gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)

    Sortie :

    2011-08-31 01:00:00

    GlideDateTime inclus dans le périmètre : getDisplayValueLang(style de chaîne, langue de chaîne)

    Renvoie une valeur de date et d’heure dans les paramètres régionaux des utilisateurs actuels en fonction d’une langue et d’un style de date spécifiés.

    Tableau 52. Paramètres
    Nom Type Description
    Style Chaîne Spécifie le format de date et d’heure.
    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 24/10/2022).

    Si une autre valeur est transmise, l’API utilisera par défaut medium. Les valeurs acceptées ne sont pas sensibles à la casse.
    langue 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.
    Tableau 53. 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 et l’heure des paramètres régionaux de l’utilisateur dans tous les styles de langue et de date.

    var gdt = new GlideDateTime(); // This will fetch the current date


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

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

    Sortie :

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

    GlideDateTime inclus dans le champ d’application : getDSTOffset()

    Obtient la durée de décalage de l’heure d’été.

    Tableau 54. Paramètres
    Nom Type Description
    Aucun
    Tableau 55. Renvoie
    Type Description
    Numéro Durée, en millisecondes, pendant laquelle l’heure d’été est décalée. Renvoie 0 s’il n’y a pas de décalage ou si l’heure n’est pas définie pendant l’heure d’été. 
    var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

    Sortie :

    3600000

    GlideDateTime inclus dans le champ d’application : getErrorMsg()

    Obtient le message d’erreur actuel.

    Tableau 56. Paramètres
    Nom Type Description
    Aucun
    Tableau 57. Renvoie
    Type Description
    Objet Message d’erreur. 
    var gdt = new GlideDateTime(); 
gdt.setDisplayValue("2011-aa-01 00:00:00"); 
gs.info(gdt.getErrorMsg());

    Sortie :

    Could not parse DateTime: 2011-aa-01 00:00:00

    GlideDateTime inclus dans le champ d’application : getInternalFormattedLocalTime()

    Renvoie l’heure de l’objet dans le fuseau horaire local et au format interne.

    Tableau 58. Paramètres
    Nom Type Description
    Aucun
    Tableau 59. Renvoie
    Type Description
    Chaîne Heure de l’objet dans le fuseau horaire local et format interne.

    Cet exemple affiche l’heure au format d’heure système du fuseau horaire de l’utilisateur.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getInternalFormattedLocalTime());

    Sortie

    2022-10-07 06:00:00 PM
18:00:00

    GlideDateTime inclus dans l’étendue : getLocalDate()

    Obtient la date stockée par l’objet GlideDateTime, exprimée au format standard, aaaa-MM-jj, et le fuseau horaire de l’utilisateur actuel.

    Tableau 60. Paramètres
    Nom Type Description
    Aucun
    Tableau 61. Renvoie
    Type
    Date de Glide La date dans le fuseau horaire de l’utilisateur. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getLocalDate());

    Sortie :

    2011-08-31

    GlideDateTime inclus dans le champ d’application : getLocalTime()

    Renvoie un objet GlideTime qui représente la partie temporelle de l’objet GlideDateTime dans le fuseau horaire de l’utilisateur.

    Tableau 62. Paramètres
    Nom Type Description
    Aucun
    Tableau 63. Renvoie
    Type Description
    Temps Glide Heure dans le fuseau horaire de l’utilisateur. 
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getLocalTime();
gs.info("local time is " + gt.getByFormat('hh:mm:ss'));

    Sortie :

    local time is 01:00:00

    GlideDateTime inclus dans le champ d’application : getMonthLocalTime()

    Obtient le mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.

    Tableau 64. Paramètres
    Nom Type Description
    Aucun
    Tableau 65. Renvoie
    Type Description
    Numéro Valeur numérique du mois. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthLocalTime());

    Sortie :

    11

    GlideDateTime inclus dans le champ d’application : getMonthUTC()

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

    Tableau 66. Paramètres
    Nom Type Description
    Aucun
    Tableau 67. Renvoie
    Type Description
    Numéro Valeur numérique du mois. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthUTC());

    Sortie :

    11

    GlideDateTime inclus dans le champ d’application : getNumericValue()

    Obtient le nombre de millisecondes écoulées depuis le 1er janvier 1970, 00 :00 :00 GMT.

    Tableau 68. Paramètres
    Nom Type Description
    Aucun
    Tableau 69. Renvoie
    Type Description
    Numéro Nombre de millisecondes écoulées depuis le 1er janvier 1970, 00 :00 :00 GMT. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());

    Sortie :

    1314777600000

    GlideDateTime inclus dans l’étendue : getTime()

    Renvoie un objet GlideTime qui représente la partie temporelle de l’objet GlideDateTime.

    Tableau 70. Paramètres
    Nom Type Description
    Aucun
    Tableau 71. Renvoie
    Type Description
    Temps Glide L’horodatage de durée Unix au format système basé sur l’heure GMT. 
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getTime();
gs.info(gt.getByFormat('hh:mm:ss'));

    Sortie :

    08:00:00

    GlideDateTime inclus dans le périmètre : getTZOffset()

    Obtient le décalage du fuseau horaire en millisecondes.

    Tableau 72. Paramètres
    Nom Type Description
    Aucun
    Tableau 73. Renvoie
    Type Description
    Numéro Nombre de millisecondes de décalage de fuseau horaire. 
    var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.info(gdt.getTZOffset());

    Sortie :

    -25200000

    GlideDateTime inclus dans le périmètre : getUserFormattedLocalTime()

    Renvoie l’heure de l’objet dans le fuseau horaire local et au format de l’utilisateur.

    Tableau 74. Paramètres
    Nom Type Description
    Aucun
    Tableau 75. Renvoie
    Type Description
    Chaîne Heure de l’objet dans le fuseau horaire local et au format de l’utilisateur.

    Cet exemple montre l’heure de l’objet dans le fuseau horaire local.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getUserFormattedLocalTime());

    Sortie :

    2022-10-07 06:00:00 PM
06:00:00 PM

    GlideDateTime inclus dans l’étendue : getValue()

    Renvoie la valeur de date et d’heure stockée par l’objet GlideDateTime au format interne, aaaa-MM-jj HH :mm :ss, dans le fuseau horaire UTC.

    Tableau 76. Paramètres
    Nom Type Description
    Aucun
    Tableau 77. Renvoie
    Type Description
    Chaîne Date et heure au format interne et fuseau horaire du système.

    Format : aaaa-MM-jj HH :mm :ss dans le fuseau horaire UTC.

    		 
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
gs.info(gdt.getValue());

    Sortie :

    2014-08-31 08:00:00

    GlideDateTime inclus dans le périmètre : getWeekOfYearLocalTime()

    Obtient le numéro de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.

    Toutes les semaines commencent le dimanche. La première semaine de l’année est la semaine qui contient au moins un jour de la nouvelle année. La semaine commençant le dimanche 2015-12-27 est considérée comme la première semaine de 2016 car cette semaine contient les 1er et 2 janvier.

    Tableau 78. Paramètres
    Nom Type Description
    Aucun
    Tableau 79. Renvoie
    Type Description
    Numéro Numéro de la semaine en cours. Le nombre de semaines le plus élevé d’une année est 52 ou 53. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
gs.info(gdt.getWeekOfYearLocalTime());

    Sortie :

    49

    GlideDateTime inclus dans le champ d’application : getWeekOfYearUTC()

    Obtient le numéro de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.

    Toutes les semaines commencent le dimanche. La première semaine de l’année est la semaine qui contient au moins un jour de la nouvelle année. La semaine commençant le dimanche 2015-12-27 est considérée comme la première semaine de 2016 car cette semaine contient les 1er et 2 janvier.

    Tableau 80. Paramètres
    Nom Type Description
    Aucun
    Tableau 81. Renvoie
    Type Description
    Numéro Numéro de la semaine en cours à l’heure UTC. Le nombre de semaines le plus élevé d’une année est 52 ou 53. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
gs.info(gdt.getWeekOfYearUTC());

    Sortie :

    49

    GlideDateTime inclus dans le champ d’application : getYearLocalTime()

    Obtient l’année stockée par l’objet GlideDateTime, exprimée dans le fuseau horaire de l’utilisateur actuel.

    Tableau 82. Paramètres
    Nom Type Description
    aucun
    Tableau 83. Renvoie
    Type Description
    Numéro Valeur de l’année à quatre chiffres dans le fuseau horaire de l’utilisateur. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearLocalTime());

    Sortie :

    2011

    GlideDateTime inclus dans le champ d’application : getYearUTC()

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

    Tableau 84. Paramètres
    Nom Type Description
    Aucun
    Tableau 85. Renvoie
    Type Description
    Numéro Valeur de l’année à 4 chiffres dans le fuseau horaire UTC. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
gs.info(gdt.getYearUTC());

    Sortie :

    2011

    GlideDateTime inclus dans le champ d’application : hasDate()

    Détermine si la date d’un objet est définie.

    Tableau 86. Paramètres
    Nom Type Description
    Aucun
    Tableau 87. Renvoie
    Type Description
    Booléen True si la date de l’objet est définie ; dans le cas contraire, renvoie la valeur false. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.hasDate());

    Sortie :

    true

    GlideDateTime inclus dans le périmètre : isDST()

    Détermine si l’heure d’un objet utilise un décalage d’heure d’été.

    Tableau 88. Paramètres
    Nom Type Description
    Aucun
    Tableau 89. Renvoie
    Type Description
    Booléen True si l’heure est à l’heure d’été ; dans le cas contraire, renvoie la valeur false. 
    var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true

    Sortie :

    var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true

    GlideDateTime inclus dans le champ d’application : isValid()

    Détermine si une valeur est une date et une heure valides.

    Tableau 90. Paramètres
    Nom Type Description
    Aucun
    Tableau 91. Renvoie
    Type Description
    Booléen Vrai si la valeur est valide ; dans le cas contraire, renvoie la valeur false. 
    var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
gs.info(gdt.isValid()); //true
gs.info(gdt.getErrorMsg()); //reason

    Sortie :

    false
Invalid date time: '2011-aa-31 aa:00:00', ignored

    GlideDateTime inclus dans le champ d’application : onOrAfter(GlideDateTime gdt)

    Détermine si les données et l’heure de l’objet GlideDateTime se produisent à la date et à l’heure de l’objet GlideDateTime spécifié ou après.

    Tableau 92. Paramètres
    Nom Type Description
    Gdt GlideDateTime Date et heure à vérifier.
    Tableau 93. Renvoie
    Type Description
    Booléen Marqueur indiquant si la date et l’heure de l’objet GlideDateTime sont identiques ou postérieures à la date et à l’heure spécifiées par le paramètre.
    Valeurs possibles :
    • true : la date et l’heure de l’objet GlideDateTime sont égales ou postérieures à la date et à l’heure de l’objet spécifié.
    • false : la date et l’heure de l’objet GlideDateTime sont antérieures à la date et l’heure de l’objet spécifié.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrAfter(gdt2));

    Sortie

    false

    GlideDateTime inclus dans le champ d’application : onOrBefore(GlideDateTime gdt)

    Détermine si les données et l’heure de l’objet GlideDateTime se produisent en même temps ou avant la date et l’heure de l’objet GlideDateTime spécifié.

    Tableau 94. Paramètres
    Nom Type Description
    Gdt GlideDateTime Date et heure à vérifier.
    Tableau 95. Renvoie
    Type Description
    Booléen Marqueur indiquant si la date et l’heure de l’objet GlideDateTime sont identiques ou antérieures à la date et à l’heure spécifiées par le paramètre.
    Valeurs possibles :
    • true : la date et l’heure de l’objet GlideDateTime sont égales ou antérieures à la date et à l’heure de l’objet spécifié.
    • false : la date et l’heure de l’objet GlideDateTime sont postérieures à la date et à l’heure de l’objet spécifié.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrBefore(gdt2));

    Sortie

    true

    GlideDateTime inclus dans le champ d’application : setDayOfMonthLocalTime(Number day)

    Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire de l’utilisateur actuel.

    Tableau 96. Paramètres
    Nom Type Description
    day Numéro Le jour du mois auquel passer de 1 à 31. Si cette valeur est supérieure au nombre maximal de jours dans le mois, la valeur est définie sur le dernier jour du mois.
    Tableau 97. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.info(gdt.getDayOfMonthLocalTime());

    Sortie :

    9

    GlideDateTime inclus dans le champ d’application : setDayOfMonthUTC (nombre de jours)

    Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire UTC.

    Tableau 98. Paramètres
    Nom Type Description
    day Numéro Le jour du mois auquel passer de 1 à 31. Si cette valeur est supérieure au nombre maximal de jours dans le mois, la valeur est définie sur le dernier jour du mois.
    Tableau 99. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.info(gdt.getDayOfMonthUTC());

    Sortie :

    9

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

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

    Tableau 100. Paramètres
    Nom Type Description
    asDisplayed Chaîne La date et l’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 MM-jj-aa HH :mm :ss. Pour affecter la date et l’heure actuelles à une variable dans un script de workflow, utilisez la variable .setDisplayValue(gs.nowDateTime) ;.
    Tableau 101. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific) 
gs.info(gdt.getValue());

    Sortie :

    2014-01-01 20:00:00

    GlideDateTime inclus dans le champ d’application : setDisplayValue (valeur de chaîne, format de chaîne)

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

    Cette méthode génère une exception d’exécution si le format de date et d’heure utilisé dans le value paramètre ne correspond pas au format paramètre. Vous pouvez récupérer le message d’erreur en appelant getErrorMsg() sur l’objet GlideDateTime après la détection de l’exception.

    Tableau 102. Paramètres
    Nom Type Description
    valide Chaîne Date et heure dans le fuseau horaire de l’utilisateur actuel.
    format Chaîne Format de date et d’heure à utiliser pour analyser le value paramètre.
    Utilisez les valeurs suivantes pour décrire le value paramètre :
    • jj : Jour du mois
    • MM : Mois de l’année
    • yyyy : Année
    • HH : Heure
    • mm : Minutes
    • ss : secondes

    Par exemple : « jj-MM-aa HH :mm :ss » ou « MM-jj-aa HH :mm ».
    Tableau 103. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
gs.info(gdt.getValue());

    Sortie

    "20-05-2011 12:00:00"

    GlideDateTime inclus dans le champ d’application : setDisplayValueInternal(String value)

    Définit une valeur de date et d’heure à l’aide du format interne (aaaa-MM-jj HH :mm :ss) et du fuseau horaire de l’utilisateur actuel.

    Tableau 104. Paramètres
    Nom Type Description
    valide Chaîne La date et l’heure au format interne.
    Tableau 105. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
gs.info(gdt.getValue());

    Sortie :

    2014-01-01 20:00:00

    GlideDateTime inclus dans le périmètre : setDisplayValueLang(String dateTime, String style)

    Définit une date et une heure à l’aide d’un style et d’un format spécifiés en fonction des paramètres régionaux de l’utilisateur actuel.

    Tableau 106. Paramètres
    Nom Type Description
    Datetime Chaîne Date et valeur d’heure de l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel. Les valeurs valides sont n’importe quelle date et heure de sortie de la fonction getDisplayValueLang().

    Par exemple, l’utilisation de la sortie de l’exemple getDisplayValueLang(String style, String language) plus haut dans cette rubrique, November 28, 2022 07 :03 :41 ou 28.11.2022 07 :03 :41 sont des valeurs acceptées.
    Style Chaîne Spécifie le 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 24/10/2022).

    Si une autre valeur est transmise, l’API utilisera par défaut medium. Les valeurs acceptées ne sont pas sensibles à la casse.
    Tableau 107. Renvoie
    Type Description
    Nul

    L’exemple suivant renvoie la date et l’heure dans des styles courts et complets.

    var glideDateFR = new GlideDateTime();

glideDateTime.setDisplayValueLang("2/3/2023 17:27:56", "short");

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

    Sortie :

    date: 2023-02-03 17:27:56
date: Friday, February 3, 2023 17:27:56

    GlideDateTime inclus dans le périmètre : setDisplayValueLang(String dateTime, String style, String language)

    Définit une date et une heure à 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 108. Paramètres
    Nom Type Description
    Datetime Chaîne Date et valeur d’heure de l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel. Les valeurs valides sont n’importe quelle date et heure de sortie de la fonction getDisplayValueLang().

    Par exemple, l’utilisation de la sortie de l’exemple getDisplayValueLang(String style, String language) plus haut dans cette rubrique, November 28, 2022 07 :03 :41 ou 28.11.2022 07 :03 :41 sont des valeurs acceptées.
    Style Chaîne Spécifie le 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 24/10/2022).

    Si une autre valeur est transmise, l’API utilisera par défaut medium. Les valeurs acceptées ne sont pas sensibles à la casse.
    langue 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 109. 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 GlideDateTime(); 

glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "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 18:00:00
en-US date: Friday, February 3, 2023 18:00:00
fr-FR date: 2023-03-02 18:00:00
fr-FR date: Thursday, March 2, 2023 18:00:00

    GlideDateTime inclus dans le périmètre : setGlideDateTime(GlideDateTime g)

    Définit la date et l’heure de l’objet actuel à l’aide d’un objet GlideDateTime existant. Cette méthode est équivalente à l’instanciation d’un nouvel objet avec un paramètre GlideDateTime.

    Tableau 110. Paramètres
    Nom Type Description
    g GlideDateTime Objet à utiliser pour définir la valeur datetime.
    Tableau 111. Renvoie
    Type Description
    Néant 
    var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.info(dt1.getValue());

    Sortie :

    2011-02-02 08:00:00

    GlideDateTime inclus dans le champ d’application : setMonthLocalTime(Number month)

    Définit le mois stocké par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire de l’utilisateur actuel.

    Tableau 112. Paramètres
    Nom Type Description
    month Numéro Le mois auquel le changement doit s’effectuer.
    Tableau 113. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.info(gdt.getMonthLocalTime());

    Sortie :

    1

    GlideDateTime inclus dans le champ d’application : setMonthUTC(numéro mois)

    Définit le mois stocké par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire UTC.

    Tableau 114. Paramètres
    Nom Type Description
    month Numéro Le mois auquel le changement doit s’effectuer.
    Tableau 115. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.info(gdt.getMonthUTC());

    Sortie :

    1

    GlideDateTime inclus dans le champ d’application : setValue(String o)

    Définit la date et l’heure de l’objet GlideDateTime.

    Tableau 116. Paramètres
    Nom Type Description
    O Chaîne Date et heure d’utilisation. Ce paramètre peut être de plusieurs types :
    • Une chaîne dans le fuseau horaire UTC et le format interne de aaaa-MM-jj HH :mm :ss. Définit la valeur de l’objet sur la date et l’heure spécifiées. L’utilisation de cette méthode équivaut à l’instanciation d’un nouvel objet GlideDateTime à l’aide du constructeur GlideDateTime(valeur String). Si le format de date et d’heure utilisé ne correspond pas au format interne, la méthode tente de définir la date et l’heure à l’aide d’autres formats disponibles. La résolution de la date et de l’heure de cette façon peut entraîner des données inexactes en raison de l’ambiguïté des valeurs du jour et du mois. Lorsque vous utilisez un format de date et d’heure non standard, utilisez setValueUTC(String dt, String format) à la place.
    • Un objet GlideDateTime. Définit la valeur de l’objet sur la date et l’heure stockées par le GlideDateTime passé dans le paramètre. L’utilisation de cette méthode équivaut à l’instanciation d’un nouvel objet GlideDateTime à l’aide du constructeur GlideDateTime(GlideDateTime g).
    • Un numéro JavaScript. Définit la valeur de l’objet à l’aide de la valeur Nombre en millisecondes après le 1er janvier 1970 00 :00 :00 UTC.
    Tableau 117. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00");  // value set =  2011-02-02 08:00:00
gs.info(gdt.getValue());

    Sortie :

    2011-02-02 08:00:00

    GlideDateTime inclus dans le champ d’application : setValueUTC(String dt, format de chaîne)

    Définit une valeur de date et d’heure à l’aide du fuseau horaire UTC et du format de date et d’heure spécifié. Cette méthode génère une exception d’exécution si le format de date et d’heure utilisé dans le dt paramètre ne correspond pas au format paramètre. Vous pouvez récupérer le message d’erreur en appelant getErrorMsg() sur l’objet GlideDateTime après la détection de l’exception.

    Tableau 118. Paramètres
    Nom Type Description
    Dt Chaîne Date et heure d’utilisation.
    format Chaîne Format de date et d’heure à utiliser.
    Tableau 119. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
gs.info(gdt.getValue());

    Sortie :

    2011-02-15 08:00:00

    GlideDateTime inclus dans le champ d’application : setYearLocalTime(Number year)

    Définit l’année stockée par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire de l’utilisateur actuel.

    Tableau 120. Paramètres
    Nom Type Description
    année Numéro Année à laquelle passer à.
    Tableau 121. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.info(gdt.getYearLocalTime());

    Sortie :

    2013

    GlideDateTime inclus dans le champ d’application : setYearUTC(Number year)

    Définit l’année stockée par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire UTC.

    Tableau 122. Paramètres
    Nom Type Description
    année Numéro Année à laquelle passer à.
    Tableau 123. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.info(gdt.getYearUTC());

    Sortie :

    2013

    GlideDateTime inclus dans le champ d’application : soustraire (heure GlideTime)

    Soustrait une durée spécifiée de l’objet GlideDateTime actuel.

    Tableau 124. Paramètres
    Nom Type Description
    heure Temps Glide Valeur de temps à soustraire.
    Tableau 125. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));

    Sortie :

    07:59:40

    GlideDateTime inclus dans le champ d’application : soustraire (nombre de millisecondes)

    Soustrait le nombre spécifié de millisecondes de l’objet GlideDateTime.

    Tableau 126. Paramètres
    Nom Type Description
    millisecondes Numéro Nombre de millisecondes à soustraire.
    Tableau 127. Renvoie
    Type Description
    Néant 
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.info(gdt.getValue());

    Sortie :

    2011-12-07 07:59:59

    GlideDateTime inclus dans le champ d’application : soustraire (début GlideDateTime, fin GlideDateTime)

    Renvoie la différence de durée entre deux objets GlideDateTime spécifiés.

    Tableau 128. Paramètres
    Nom Type Description
    Début GlideDateTime Objet de date de début.
    Fin GlideDateTime Objet de date de fin.
    Tableau 129. Renvoie
    Type Description
    GlideDuration (GlideDuration) Différence de durée entre les deux dates spécifiées. 
    var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
 
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());

    Sortie :

    2 Days 23 Hours

    GlideDateTime inclus dans le champ d’application : toString()

    Obtient la valeur de date et d’heure stockée par l’objet GlideDateTime au format interne, aaaa-MM-jj HH :mm :ss, et le fuseau horaire du système, UTC par défaut. Cette méthode est équivalente à getValue().

    Tableau 130. Paramètres
    Nom Type Description
    Aucun
    Tableau 131. Renvoie
    Type
    Chaîne La date et l’heure stockées par l’objet GlideDateTime dans le fuseau horaire et le format du système. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.toString());

    Sortie :

    2011-08-31 08:00:00