GlideDateTime : global

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

GlideDateTime : GlideDateTime(String dateTime)

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
Datetime	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 : GlideDateTime(GlideDateTime gdt)

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

Tableau 3. Paramètres
Nom	Type	Description
Gdt	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 : add(Nombre de millisecondes)

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

Tableau 4. Paramètres
Nom	Type	Description
millisecondes	Numéro	Nombre de millisecondes à ajouter

Tableau 5. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getNumericValue());
gdt.add(10);
gs.print(gdt.getNumericValue());

Sortie :

1314777600000
1314777600010

Équivalent dans le champ d’application

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

GlideDateTime - add(heure GlideTime)

Ajoute un objet GlideTime à l’objet GlideDateTime actuel.

Tableau 6. Paramètres
Nom	Type	Description
heure	Temps Glide	Objet GlideTime dont la valeur de temps doit être ajoutée à l’objet GlideDateTime spécifié.

Tableau 7. Renvoie
Type	Description
nul

Cet exemple montre comment ajouter 20 secondes à l’heure définie dans l’objet gdt GlideDateTime.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
gs.print(gdt.toString());

Sortie :

2011-08-31 08:00:20

Équivalent dans le champ d’application

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

GlideDateTime : addDays(Nombre de jours)

Ajoute un nombre spécifié de jours à l’objet GlideDateTime actuel. Un paramètre négatif soustrait les jours.

Utilisez addDaysLocalTime() et addDaysUTC() au lieu de cette méthode.

Tableau 8. Paramètres
Nom	Type	Description
jours	Numéro	Nombre de jours à ajouter. Utilisez un nombre négatif pour soustraire.

Tableau 9. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDays(-1);
gs.print(gdt.getDate());

Sortie :

2011-08-30

GlideDateTime : 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 10. Paramètres
Nom	Type	Description
jours	Numéro	Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire.

Tableau 11. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.print(gdt.getLocalDate());

Sortie :

2011-08-30

Équivalent dans le champ d’application

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

GlideDateTime – 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 12. Paramètres
Nom	Type	Description
jours	Numéro	Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire.

Tableau 13. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.print(gdt.getDate());

Sortie :

2011-08-30

Équivalent dans le champ d’application

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

GlideDateTime – addSeconds(Nombre de secondes)

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

Tableau 14. Paramètres
Nom	Type	Description
secondes	Numéro	Le nombre de secondes à ajouter

Tableau 15. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.print(gdt.getValue());

Sortie :

2011-12-07 08:16:40

Équivalent dans le champ d’application

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

GlideDateTime : addWeeks(Nombre de semaines)

Ajoute un nombre spécifié de semaines à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des semaines.

Utilisez addWeeksLocalTime() et addWeeksUTC() à la place de cette méthode.

Tableau 16. Paramètres
Nom	Type	Description
semaines	Numéro	Nombre de semaines à ajouter. Utilisez un nombre négatif pour soustraire.

Tableau 17. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeks(-1);
gs.print(gdt.getDate());

Sortie :

2011-08-24

GlideDateTime : 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 un nombre négatif pour soustraire.

Tableau 19. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.print(gdt.getDate());

Sortie :

2011-08-24

Équivalent dans le champ d’application

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

GlideDateTime – 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 un nombre négatif pour soustraire.

Tableau 21. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.print(gdt.getDate());

Sortie :

2011-08-24

Équivalent dans le champ d’application

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

GlideDateTime - addMonths(Nombre de mois)

Ajoute un nombre spécifié de mois à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des mois.

Utilisez addMonthsLocalTime() ou addMonthsUTC() à la place de cette méthode.

Tableau 22. Paramètres
Nom	Type	Description
mois	Numéro	Nombre de mois à ajouter. Utilisez un nombre négatif pour soustraire.

Tableau 23. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonths(2);
gs.print(gdt.getDate());

Sortie :

2011-10-31

GlideDateTime : 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 24. Paramètres
Nom	Type	Description
mois	Numéro	Nombre de mois à ajouter. Utilisez une valeur négative pour soustraire.

Tableau 25. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.print(gdt.getDate());

Sortie :

2011-10-31

Équivalent dans le champ d’application

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

GlideDateTime - 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 26. Paramètres
Nom	Type	Description
mois	Numéro	Nombre de mois à ajouter. Utilisez un nombre négatif pour soustraire.

Tableau 27. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.print(gdt.getDate());

Sortie :

2011-10-31

Équivalent dans le champ d’application

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

GlideDateTime : addYears(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.

Utilisez addYearsLocalTime() ou addYearsUTC() à la place de cette méthode.

Tableau 28. Paramètres
Nom	Type	Description
années	Numéro	Nombre d’années à ajouter. Utilisez une valeur négative pour soustraire.

Tableau 29. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYears(1);
gs.print(gdt.getDate());

Sortie :

2011-08-31

GlideDateTime - 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 30. Paramètres
Nom	Type	Description
années	Numéro	Nombre d’années à ajouter. Pour soustraire, utilisez une valeur négative.

Tableau 31. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.print(gdt.getDate());

Sortie :

2011-08-31

Équivalent dans le champ d’application

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

GlideDateTime - 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 32. Paramètres
Nom	Type	Description
années	Numéro	Nombre d’années à ajouter. Utilisez une valeur négative pour soustraire.

Tableau 33. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.print(gdt.getDate());

Sortie :

2011-08-31

Équivalent dans le champ d’application

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

GlideDateTime - compareTo(Object dateTime)

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

Tableau 34. Paramètres
Nom	Type	Description
Datetime	Objet	Date/heure dans un objet GlideDateTime

Tableau 35. 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

Équivalent dans le champ d’application

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

GlideDateTime - equals(Object GDT)

Compare un objet avec une valeur existante pour l’égalité.

Tableau 36. Paramètres
Nom	Type	Description
GDT	Objet	Objet à comparer. Il peut s’agir d’un objet GlideDateTIme ou d’une chaîne de date et d’heure valide.

Tableau 37. Renvoie
Type	Description
Booléen	Vrai s’ils sont égaux, faux dans le cas contraire.

var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.print(gdt.equals("2011-09-30 00:12:01"));

Sortie :

 false

Équivalent dans le champ d’application

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

GlideDateTime : getDate()

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

Tableau 38. Paramètres
Nom	Type	Description
Aucun

Tableau 39. Renvoie
Type	Description
Chaîne	Date dans le fuseau horaire du système. Format : aaaa-MM-jj, et dans le fuseau horaire du système, UTC par défaut.

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

Sortie :

2011-08-31

Équivalent dans le champ d’application

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

GlideDateTime : getDayOfMonth()

Obtient le jour actuel du mois dans le fuseau horaire UTC.

Utilisez getDayOfMonthLocalTime() et getDayOfMonthUTC() au lieu de cette méthode.

Tableau 40. Paramètres
Nom	Type	Description
Aucun

Tableau 41. 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.print(gdt.getDayOfMonth());

Sortie :

GlideDateTime : getDayOfMonthLocalTime()

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

Tableau 42. Paramètres
Nom	Type	Description
Aucun

Tableau 43. 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.print(gdt.getDayOfMonthLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getDayOfMonthUTC()

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

Tableau 44. Paramètres
Nom	Type	Description
Aucun

Tableau 45. 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.print(gdt.getDayOfMonthUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getDayOfWeek()

Récupère le jour de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur.

Utilisez getDayOfWeekLocalTime() et getDayOfWeekUTC() au lieu de cette méthode.

Tableau 46. Paramètres
Nom	Type	Description
Aucun

Tableau 47. Renvoie
Type	Description
Numéro	Valeur du jour de la semaine - Lundi = 1, ... Dimanche = 7.

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeek());

Sortie :

GlideDateTime : getDayOfWeekLocalTime()

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

Tableau 48. Paramètres
Nom	Type	Description
Aucun

Tableau 49. Renvoie
Type	Description
Numéro	Valeur du jour de la semaine - Lundi = 1, ... Dimanche = 7

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeekLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getDayOfWeekUTC()

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

Tableau 50. Paramètres
Nom	Type	Description
Aucun

Tableau 51. Renvoie
Type	Description
Numéro	Valeur du jour de la semaine - Lundi = 1, ... Dimanche = 7

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeekUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getDaysInMonth()

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

Utilisez getDaysInMonthLocalTime() et getDaysInMonthUTC() au lieu de cette méthode.

Tableau 52. Paramètres
Nom	Type	Description
Aucun

Tableau 53. Renvoie
Type	Description
Numéro	Nombre de jours du mois actuel dans le fuseau horaire de l’ordinateur virtuel Java.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonth());

Sortie :

GlideDateTime : getDaysInMonthLocalTime()

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

Tableau 54. Paramètres
Nom	Type	Description
Aucun

Tableau 55. Renvoie
Type	Description
Numéro	Nombre de jours du mois actuel dans le fuseau horaire de l’utilisateur.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getDaysInMonthUTC()

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

Tableau 56. Paramètres
Nom	Type	Description
Aucun

Tableau 57. 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(); //December
gs.print(gdt.getDaysInMonthUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getDisplayValue()

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

Remarque :

La référence à l’objet GlideDateTime renvoie directement la valeur de date et d’heure dans le fuseau horaire GMT.

Tableau 58. Paramètres
Nom	Type	Description
Aucun

Tableau 59. Renvoie
Type	Description
Objet	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());

Sortie :

2011-08-31 01:00:00

Équivalent dans le champ d’application

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

GlideDateTime : getDisplayValueInternal()

Renvoie la valeur d’affichage au format interne, aaaa-MM-jj HH :mm :ss. Cette méthode est utile pour les champs date/heure, mais pas pour les champs de date.

Tableau 60. Paramètres
Nom	Type	Description
Aucun

Tableau 61. Renvoie
Type	Description
Objet	Valeurs de date et d’heure de l’objet GlideDateTime. Format : aaaa-MM-jj HH :mm :ss dans le fuseau horaire de l’appelant.

// The passed in date and time is converted to the caller's time zone.
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValueInternal());

Sortie :

2011-08-31 01:00:00

Équivalent dans le champ d’application

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

GlideDateTime : getDisplayValueLang(style de chaîne)

Renvoie une valeur de date et d’heure dans les paramètres régionaux de l’utilisateur actuel en fonction du style de date spécifié.

Tableau 62. 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.

Tableau 63. 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 date.

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


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

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

Sortie :

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

GlideDateTime – getDisplayValueLang(style de chaîne, langue de chaîne)

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

Tableau 64. 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 65. 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 : getDSTOffset()

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

Tableau 66. Paramètres
Nom	Type	Description
Aucun

Tableau 67. 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("2011-08-31 08:00:00");
gs.print(gdt.getDSTOffset());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getErrorMsg()

Obtient le message d’erreur actuel.

Tableau 68. Paramètres
Nom	Type	Description
Aucun

Tableau 69. Renvoie
Type	Description
Objet	Message d’erreur

var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); //bad
gs.print(gdt.isValid()); //false
gs.print(gdt.getErrorMsg()); //reason

Sortie :

false
Could not parse DateTime: 2011-aa-31 aa:00:00

Équivalent dans le champ d’application

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

GlideDateTime : getInternalFormattedLocalTime()

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

Tableau 70. Paramètres
Nom	Type	Description
Aucun

Tableau 71. Renvoie
Type	Description
Objet	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

Équivalent dans le champ d’application

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

GlideDateTime : getInternalMidnight(Number dayOfTheWeek)

Renvoie un objet de date et d’heure défini sur minuit d’un jour spécifié en utilisant UTC.

Tableau 72. Paramètres
Nom	Type	Description
jourDeLaSemaine	Numéro	Jour de la semaine pour lequel renvoyer l’objet date/heure.

Tableau 73. Renvoie
Type	Description
GlideDateTime	Objet GlideDateTime défini sur minuit.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getInternalMidnight(2));

Sortie :

2011-08-30 00:00:01

GlideDateTime : 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 74. Paramètres
Nom	Type	Description
Aucun

Tableau 75. Renvoie
Type	Description
Date de Glide	La date dans le fuseau horaire de l’utilisateur.

Cet exemple affiche l’heure au format d’heure de l’utilisateur dans le fuseau horaire de celui-ci.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getLocalDate());

Sortie :

2011-08-31

Équivalent dans le champ d’application

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

GlideDateTime : getLocalTime()

Obtient l’heure dans le fuseau horaire de l’utilisateur.

Tableau 76. Paramètres
Nom	Type	Description
Aucun

Tableau 77. Renvoie
Type	Description
Temps Glide	Heure dans le fuseau horaire de l’utilisateur.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getLocalTime());

Sortie :

1970-01-01 01:00:00

Équivalent dans le champ d’application

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

GlideDateTime : getMonth()

Récupère le mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’ordinateur virtuel Java.

Utilisez getMonthLocalTime() et getMonthUTC() au lieu de cette méthode.

Tableau 78. Paramètres
Nom	Type	Description
Aucun

Tableau 79. Renvoie
Type	Description
Numéro	Valeur numérique du mois, janv=1, déc=12.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonth());

Sortie :

GlideDateTime : getMonthLocalTime()

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

Tableau 80. Paramètres
Nom	Type	Description
Aucun

Tableau 81. Renvoie
Type	Description
Numéro	Valeur numérique du mois, janv=1, déc=12.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getMonthUTC()

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

Tableau 82. Paramètres
Nom	Type	Description
Aucun

Tableau 83. Renvoie
Type	Description
Numéro	Valeur numérique du mois, janv=1, déc=12.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getNumericValue()

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

Tableau 84. Paramètres
Nom	Type	Description
Aucun

Tableau 85. 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.print(gdt.getNumericValue());

Sortie :

1314777600000

GlideDateTime : getSpanTime(Number dayOfWeek)

Récupère le temps écoulé depuis minuit d’un jour spécifié jusqu’à l’heure actuelle.

Tableau 86. Paramètres
Nom	Type	Description
Dayofweek	Numéro	Valeur du jour de la semaine de 1 à 7. 1 = lundi, 7 = dimanche.

Tableau 87. Renvoie
Type	Description
Temps Glide	Temps écoulé depuis minuit le jour spécifié. Pour afficher le résultat en termes conviviaux, définissez la valeur sur GlideDuration.

var gdt = new GlideDateTime("2011-08-31 08:00:00"); //Wednesday
var dur = new GlideDuration();
 
var span = gdt.getSpanTime(1); //how much time since Monday 00:00:00
dur.setValue(span);
gs.print(dur.getDisplayValue());

Sortie :

2 Days 8 Hours

GlideDateTime : getTime()

Obtient l’horodatage de durée Unix.

Tableau 88. Paramètres
Nom	Type	Description
Aucun

Tableau 89. Renvoie
Type	Description
Temps Glide	L’horodatage de durée Unix au format système basé sur l’heure GMT.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getTime());

Sortie :

1970-01-01 08:00:00

Équivalent dans le champ d’application

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

GlideDateTime - getTZOffset()

Obtient le décalage du fuseau horaire en millisecondes.

Tableau 90. Paramètres
Nom	Type	Description
Aucun

Tableau 91. Renvoie
Type	Description
Numéro	Nombre de millisecondes du décalage du fuseau horaire

var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.print(gdt.getTZOffset());

Sortie :

-28800000

Équivalent dans le champ d’application

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

GlideDateTime : getUserFormattedLocalTime()

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

Tableau 92. Paramètres
Nom	Type	Description
Aucun

Tableau 93. Renvoie
Type	Description
Objet	L’heure de l’objet en heure locale et le format de l’utilisateur.

L’exemple de code suivant montre comment appeler cette méthode.

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

Équivalent dans le champ d’application

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

GlideDateTime : getUserTimeZone()

Récupère le fuseau horaire de la session utilisateur actuelle.

Cette méthode est équivalente à gs.getSession().getTimeZone().

Tableau 94. Paramètres
Nom	Type	Description
Aucun

Tableau 95. Renvoie
Type	Description
Timezone	TimeZone pour l’utilisateur actuel.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getUserTimeZone());

Sortie :

sun.util.calendar.ZoneInfo[id="America/Los_Angeles",offset=-28800000,dstSavings=3600000,useDaylight=true,transitions=185,
lastRule=java.util.SimpleTimeZone[id=America/Los_Angeles,offset=-28800000,dstSavings=3600000,useDaylight=true,startYear=0,startMode=3,
startMonth=2,startDay=8,startDayOfWeek=1,startTime=7200000,startTimeMode=0,endMode=3,endMonth=10,endDay=1,endDayOfWeek=1,
endTime=7200000,endTimeMode=0]]

GlideDateTime : getUTCMidnight(Nombre dayOfTheWeek)

Récupère un objet GlideDateTime dont l’heure est définie sur minuit à l’aide du fuseau horaire UTC.

Cette méthode définit la date du nouvel objet GlideDateTime comme jour spécifié de la semaine dans la semaine de l’objet GlideDateTime d’origine.

Tableau 96. Paramètres
Nom	Type	Description
jourDeLaSemaine	Numéro	Le jour de la semaine, de 13h à 7h. Lundi = 1, Dimanche = 7. N’entrez pas 0 dans ce paramètre.

Tableau 97. Renvoie
Type	Description
GlideDateTime	Un nouvel objet GlideDateTime, défini sur minuit.

var gdt = new GlideDateTime("2011-08-31 08:00:00"); // Wednesday, 3rd day of the week.
gs.print(gdt.getUTCMidnight(5)); //Friday, 5th day of the week.

Sortie :

2011-09-02 00:00:00

GlideDateTime : 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 98. Paramètres
Nom	Type	Description
Aucun

Tableau 99. 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("2011-08-31 08:00:00");
gs.info(gdt.getValue());

Sortie :

2011-08-31 08:00:00

Équivalent dans le champ d’application

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

GlideDateTime : 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 100. Paramètres
Nom	Type	Description
Aucun

Tableau 101. 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");
gs.print(gdt.getWeekOfYearUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : 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 102. Paramètres
Nom	Type	Description
Aucun

Tableau 103. 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");
gs.print(gdt.getWeekOfYearUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getYear()

Récupère l’année stockée par l’objet GlideDateTime, exprimée dans le fuseau horaire de l’ordinateur virtuel Java.

Utilisez getYearLocalTime() et getYearUTC() au lieu de cette méthode.

Tableau 104. Paramètres
Nom	Type	Description
Aucun

Tableau 105. Renvoie
Type	Description
Numéro	Valeur de l’année à 4 chiffres dans le fuseau horaire de l’ordinateur virtuel Java.

var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYear());

Sortie :

GlideDateTime : getYearLocalTime()

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

Tableau 106. Paramètres
Nom	Type	Description
Aucun

Tableau 107. Renvoie
Type	Description
Numéro	Valeur de l’année à 4 chiffres dans le fuseau horaire de l’utilisateur.

var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYearLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : getYearUTC()

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

Tableau 108. Paramètres
Nom	Type	Description
Aucun

Tableau 109. Renvoie
Type	Description
Numéro	Valeur de l’année à quatre chiffres dans le fuseau horaire UTC.

var gdt = new GlideDateTime(); //2011
gs.info(gdt.getYearUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : hasDate()

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

Tableau 110. Paramètres
Nom	Type	Description
Aucun

Tableau 111. Renvoie
Type	Description
Booléen	True si la date de l’objet est définie, false dans les autres cas.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.hasDate());

Sortie :

true

Équivalent dans le champ d’application

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

GlideDateTime : isDST()

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

Tableau 112. Paramètres
Nom	Type	Description
Aucun

Tableau 113. Renvoie
Type	Description
Booléen	True s’il s’agit de l’heure d’été, false dans les autres cas.

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

Sortie :

true

Équivalent dans le champ d’application

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

GlideDateTime : isValid()

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

Tableau 114. Paramètres
Nom	Type	Description
Aucun

Tableau 115. Renvoie
Type	Description
Booléen	Vrai si la valeur est valide, faux dans les autres cas.

var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
gs.print(gdt.isValid()); //true
gs.print(gdt.getErrorMsg()); //reason

Sortie

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

Équivalent dans le champ d’application

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

GlideDateTime : setDayOfMonth (nombre de jours)

Définit le jour du mois sur une valeur spécifiée.

Utilisez setDayOfMonthLocalTime(day) et setDayOfMonthUTC(day) au lieu de cette méthode.

Tableau 116. Paramètres
Nom	Type	Description
day	Numéro	Jour du mois, du 1er au 31.

Tableau 117. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setDayOfMonth(9);
gs.print(gdt.getDayOfMonth());

Sortie :

GlideDateTime : setDayOfMonthLocalTime(nombre jour)

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

Tableau 118. 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 119. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.print(gdt.getDayOfMonthLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime – setDayOfMonthUTC (nombre de jours)

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

Tableau 120. 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 121. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.print(gdt.getDayOfMonthUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : 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 122. 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 `<variable>.setDisplayValue(gs.nowDateTime) ;`.

Tableau 123. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("2011-01-01 12:00:00");
gs.print(gdt.getValue());

Sortie :

2011-01-01 20:00:00

Équivalent dans le champ d’application

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

GlideDateTime - setDisplayValue(String dateTime, 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 paramètre dateTime ne correspond pas au paramètre de format. 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 124. Paramètres
Nom	Type	Description
Datetime	Chaîne	La date et l’heure dans le fuseau horaire de l’utilisateur actuel.
format	Chaîne	Format à utiliser pour analyser le paramètre dateTime.

Tableau 125. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss");
gs.print(gdt.getValue());

Sortie :

2011-05-20 19:00:00

Équivalent dans le champ d’application

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

GlideDateTime : setDisplayValueInternal(String dateTime)

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 126. Paramètres
Nom	Type	Description
Datetime	Chaîne	La date et l’heure au format interne

Tableau 127. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValueInternal("2011-01-01 12:00:00");
gs.print(gdt.getValue());

Sortie :

2011-01-01 20:00:00

Équivalent dans le champ d’application

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

GlideDateTime : setDisplayValueInternalWithAlternates(String dateTime)

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.

Cette méthode tente d’analyser les valeurs de date et d’heure incomplètes.

Tableau 128. Paramètres
Nom	Type	Description
Datetime	Chaîne	La date et l’heure au format interne.

Tableau 129. Renvoie
Type	Description
nul

GlideDateTime – setDisplayValueLang(String dateTime, String style)

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 130. 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 131. 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 – 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 132. 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 133. 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 : setGlideDateTime(GlideDateTime gDT)

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 134. Paramètres
Nom	Type	Description
Gdt	GlideDateTime	Un objet GlideDateTime

Tableau 135. Renvoie
Type	Description
nul

var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.print(dt1.getValue());

Sortie :

2011-02-02 08:00:00

Équivalent dans le champ d’application

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

GlideDateTime : setInitialValue(String dateTime)

Définit la date et l’heure.

Cette méthode est équivalente à setValue(Object).

Tableau 136. Paramètres
Nom	Type	Description
Datetime	Chaîne	Date et heure d’utilisation. Accepte soit une chaîne dans le fuseau horaire GMT au format interne, soit un objet GlideDateTime.

Tableau 137. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setInitialValue("2011-01-01 12:00:00");
gs.print(gdt.getValue());

Sortie :

2011-01-01 12:00:00

GlideDateTime : setMonth(Number month)

Définit le mois stocké par l’objet GlideDateTime sur une valeur spécifiée à l’aide du fuseau horaire de l’ordinateur virtuel Java.

Utilisez setMonthLocalTime() ou setMonthUTC() à la place de cette méthode.

Tableau 138. Paramètres
Nom	Type	Description
month	Numéro	Le mois auquel le changement doit s’effectuer.

Tableau 139. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setMonth(1);
gs.print(gdt.getMonth());

Sortie :

GlideDateTime : setMonthLocalTime(nombre mois)

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

Tableau 140. Paramètres
Nom	Type	Description
month	Numéro	Le mois auquel le changement doit s’effectuer.

Tableau 141. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.print(gdt.getMonthLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime – setMonthUTC(Numéro mois)

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

Tableau 142. Paramètres
Nom	Type	Description
month	Numéro	Le mois auquel le changement doit s’effectuer.

Tableau 143. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.print(gdt.getMonthUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime : setNumericValue(Nombre millisecondes)

Définit la date et l’heure en nombre de millisecondes depuis le 1er janvier 1970 00 :00 :00 GMT.

Tableau 144. Paramètres
Nom	Type	Description
millisecondes	Numéro	Nombre de millisecondes

Tableau 145. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setNumericValue(1314777600000);
gs.print(gdt.getValue());

Sortie :

2011-08-31 08:00:00

GlideDateTime : setTZ(TimeZone, timeZone)

Définit le fuseau horaire de l’objet GlideDateTime comme étant le fuseau horaire spécifié.

Tableau 146. Paramètres
Nom	Type	Description
Fuseau horaire	Timezone	Objet de fuseau horaire

Tableau 147. Renvoie
Type	Description
nul

var tz = gs.getSession().getTimeZone();
var gdt = new GlideDateTime(); 
gdt.setTZ(tz);

GlideDateTime : setValue(Object dateTime)

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

Cette méthode est équivalente à setInitialValue().

Tableau 148. Paramètres
Nom	Type	Description
Datetime	Objet	Date et heure d’utilisation. Ce paramètre peut être de type parmi plusieurs. Chaîne dans le fuseau horaire UTC et au format interne 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(value). 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(dateTime, format) à la place. Objet GlideDateTime : Définit la valeur de l’objet selon 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(g). Objet Date Java : définit la valeur de l’objet à l’aide de la valeur stockée par l’objet Date Java. L’utilisation de la méthode de cette façon équivaut à transmettre la valeur renvoyée par l’objet Java Date getTime() à la méthode GlideDateTime setNumericValue(). Cette méthode n’accepte pas les objets de date JavaScript. Un nombre 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. L’utilisation de cette méthode équivaut à la méthode setNumericValue (milliseconds). Un entier Java ou long : définit la valeur de l’objet à l’aide de la valeur Entier ou Long en millisecondes après le 1er janvier 1970 00 :00 :00 UTC. L’utilisation de cette méthode équivaut à la méthode setNumericValue (milliseconds).

Tableau 149. Renvoie
Type	Description
nul

Réglez la date et l’heure à l’aide d’une chaîne au format aaaa-MM-jj HH :mm :ss.

var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00");
gs.print(gdt.getValue());

Sortie :

2011-02-02 08:00:00

Définissez la date et l’heure à l’aide d’un objet GlideDateTime existant.

var gdtSource = new GlideDateTime("2017-05-23 11:37:41");
var gdtDest = new GlideDateTime();
gdtDest.setValue(gdtSource);
gs.print(gdtDest.getValue());

Sortie :

2017-05-23 11:37:41

Réglez la date et l’heure à l’aide d’un nombre indiquant les millisecondes après le 1er janvier 1970 00 :00 :00 UTC.

var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue(1617634522375);
gs.print(gdt.getValue());

Sortie :

2021-04-05 14:55:22

Équivalent dans le champ d’application

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

GlideDateTime - setValueUTC(String dateTime, 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 paramètre dateTime ne correspond pas au paramètre de format. 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 150. Paramètres
Nom	Type	Description
Datetime	Chaîne	Date et heure d’utilisation.
format	Chaîne	Format à utiliser.

Tableau 151. Renvoie
Type	Description
nul

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.print(gdt.getValue());

Sortie :

2011-02-15 08:00:00

Équivalent dans le champ d’application

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

GlideDateTime - setYear(Number year)

Définit l’année stockée par l’objet GlideDateTime sur une valeur spécifiée à l’aide du fuseau horaire de l’ordinateur virtuel Java.

Utilisez setYearLocalTime() ou setYearUTC() au lieu de cette méthode.

Tableau 152. Paramètres
Nom	Type	Description
année	Numéro	Année à laquelle passer à.

Tableau 153. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setYear(2013);
gs.print(gdt.getYear());

Sortie :

GlideDateTime : setYearLocalTime(Number year)

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

Tableau 154. Paramètres
Nom	Type	Description
année	Numéro	Année à laquelle passer à.

Tableau 155. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.print(gdt.getYearLocalTime());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime - setYearUTC(Année numérique)

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

Tableau 156. Paramètres
Nom	Type	Description
année	Numéro	Année à laquelle passer à.

Tableau 157. Renvoie
Type	Description
nul

var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.print(gdt.getYearUTC());

Sortie :

Équivalent dans le champ d’application

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

GlideDateTime - subtract(GlideTime time)

Soustrait une durée spécifiée.

Tableau 158. Paramètres
Nom	Type	Description
heure	Temps Glide	Temps à soustraire

Tableau 159. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
gs.print(gdt.getTime());

Sortie :

1970-01-01 07:59:40

Équivalent dans le champ d’application

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

GlideDateTime - soustraire(Nombre de millisecondes)

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

Tableau 160. Paramètres
Nom	Type	Description
millisecondes	Numéro	Nombre de millisecondes à soustraire

Tableau 161. Renvoie
Type	Description
nul

var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.print(gdt.getValue());

Sortie :

2011-12-07 07:59:59

Équivalent dans le champ d’application

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

GlideDateTime : soustraire (début GlideDateTime, fin GlideDateTime)

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

Tableau 162. Paramètres
Nom	Type	Description
début	GlideDateTime	Objet de date de début.
fin	GlideDateTime	Objet de date de fin.

Tableau 163. 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); // Difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());

Sortie :

2 Days 23 Hours

Équivalent dans le champ d’application

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

GlideDateTime - toString()

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

Tableau 165. Renvoie
Type	Description
Objet	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.print(gdt.toString());

Sortie :

2011-08-31 08:00:00

Équivalent dans le champ d’application

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