GlideDateTime : global
La classe GlideDateTime fournit des méthodes pour effectuer des opérations sur les objets GlideDateTime.
Utilisez les méthodes GlideDateTime pour effectuer des opérations de date et d’heure, telles que l’instanciation d’un objet GlideDateTime, l’exécution de calculs de date et d’heure, la mise en forme d’une date et d’une heure ou la conversion d’un format date-heure à l’autre.
Modifier un champ glide_date_time
Lorsque vous utilisez des colonnes de base de données de type glide_date_time dans les méthodes GlideDateTime , vous devez d’abord convertir la valeur du champ en objet GlideDateTime avant d’effectuer des calculs de date et d’heure. Un champ glide_date_time est représenté par un GlideElement ; l’appel de l’élément Glide : getGlideObject() renvoie un objet GlideDateTime qui prend en charge les méthodes de manipulation de date telles que addMonthsUTC(). Consultez GlideElement : getGlideObject() pour plus d'informations.
Pour obtenir des conseils sur les chaînes d’entrée de date et d’heure avec une liste de conflits de format courants, reportez-vous à .Directives relatives aux formats de date et d’heure
GlideDateTime : GlideDateTime()
Instancie un nouvel objet GlideDateTime avec la date et l’heure actuelles.
| 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(dateTime de la chaîne)
Instancie un nouvel objet GlideDateTime à l’aide de la date et de la valeur d’heure transmises.
- aaaa-MM-jj HH :mm :ss
- MM/jj/aaaa hh :mm :ss
- MM-jj-aaaa hh :mm :ss
- MM-jj-aaaa hh :mm
- mm-jj-aaaa
- 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/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 a
- jj.MM.aaaa
- aaaa-MM-jj’T’HH :mm :ss. SSSZ (SSSZ)
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | Date et heure UTC à définir dans l’objet GlideDateTime . |
Cet exemple montre comment instancier un objet GlideDateTime à l’aide d’une chaîne.
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é.
| Nom | Type | Description |
|---|---|---|
| gdt | GlideDateTime | Objet utilisé pour définir l’heure du nouvel objet. |
Cet exemple montre comment instancier un objet GlideDateTime (gdt1) à l’aide d’une chaîne au format aaaa-MM-jj HH :mm :ss et d’un deuxième objet GlideDateTime (gdt2) à l’aide de gdt1.
var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
gs.info(gdt1);
gs.info(gdt2);
Sortie :
2025-01-28 12:00:00
2025-01-28 12:00:00
GlideDateTime : ajouter (nombre de millisecondes)
Ajoute un nombre spécifié de millisecondes à l’objet GlideDateTime.
| Nom | Type | Description |
|---|---|---|
| millisecondes | Numéro | Nombre de millisecondes à ajouter |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getNumericValue());
gdt.add(10);
gs.print(gdt.getNumericValue());
1314777600000
1314777600010Équivalent dans le champ d’application
Pour utiliser la méthode add() dans une application scopée, utilisez la méthode scoped correspondante : add().
GlideDateTime : ajouter (heure GlideTime)
Ajoute un objet GlideTime à l’objet GlideDateTime actuel.
| Nom | Type | Description |
|---|---|---|
| heure | GlideTime | Objet GlideTime dont la valeur de temps doit être ajoutée à l’objet GlideDateTime spécifié. |
| Type | Description |
|---|---|
| nul |
Cet exemple montre comment ajouter 20 secondes à la durée 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 scopée, utilisez la méthode scoped 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.
Cette méthode n’est pas disponible dans les applications incluses dans le périmètre. Vous pouvez également utiliser addDaysLocalTime() ou addDaysUTC() dans les applications incluses dans le périmètre.
| Nom | Type | Description |
|---|---|---|
| jours | Numéro | Nombre de jours à ajouter. Utilisez un nombre négatif pour soustraire. |
| 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 la date et l’heure locales équivalentes à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des jours à l’aide des valeurs de date et d’heure locales.
| Nom | Type | Description |
|---|---|---|
| jours | Numéro | Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire. |
| 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 la date et l’heure UTC équivalentes à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des jours à l’aide des valeurs de date et d’heure UTC.
| Nom | Type | Description |
|---|---|---|
| jours | Numéro | Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire. |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : addDaysUTC().
GlideDateTime : addSeconds(nombre de secondes)
Ajoute un nombre spécifié de secondes à l’objet GlideDateTime.
| Nom | Type | Description |
|---|---|---|
| secondes | Numéro | Nombre de secondes à ajouter |
| 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 champ d’application, utilisez la méthode correspondante : addSeconds().
GlideDateTime : addWeeks(nombre de semaines)
Ajoute un nombre spécifié de semaines à l’objet GlideDateTime actuel. Un paramètre négatif soustrait les semaines.
Utilisez addWeeksLocalTime() et addWeeksUTC() au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| semaines | Numéro | Nombre de semaines à ajouter. Utilisez un nombre négatif pour soustraire. |
| 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 les semaines.
La méthode détermine la date et l’heure locales équivalentes à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des semaines à l’aide des valeurs de date et d’heure locales.
| Nom | Type | Description |
|---|---|---|
| semaines | Numéro | Nombre de semaines à ajouter. Utilisez un nombre négatif pour soustraire. |
| 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 les semaines.
La méthode détermine la date et l’heure UTC équivalentes à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des semaines à l’aide des valeurs de date et d’heure UTC.
| Nom | Type | Description |
|---|---|---|
| semaines | Numéro | Nombre de semaines à ajouter. Utilisez un nombre négatif pour soustraire. |
| 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 champ d’application, utilisez la méthode correspondante : addWeeksUTC().
GlideDateTime : addMonths(nombre de mois)
Ajoute un nombre spécifié de mois à l’objet GlideDateTime actuel. Un paramètre négatif soustrait les mois.
Utilisez addMonthsLocalTime() ou addMonthsUTC() au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre de mois à ajouter. Utilisez un nombre négatif pour soustraire. |
| 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 les mois.
La méthode détermine la date et l’heure locales équivalentes à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des mois à l’aide des valeurs de date et d’heure locales.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre de mois à ajouter. Utilisez une valeur négative pour soustraire. |
| 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 les mois.
La méthode détermine la date et l’heure UTC équivalentes à la valeur stockée par l’objet GlideDateTime, puis ajoute ou soustrait des mois à l’aide des valeurs de date et d’heure UTC.
Lorsque vous utilisez des colonnes de base de données de type glide_date_time, vous devez d’abord convertir la valeur du champ en objet GlideDateTime avant d’effectuer des calculs de date et d’heure. Un champ glide_date_time est représenté par un élément GlideElement. L’appel de l’élément Glide : getGlideObject() renvoie un objet GlideDateTime qui prend en charge les méthodes de manipulation de date. Consultez GlideElement : getGlideObject() pour plus d'informations.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre de mois à ajouter. Utilisez un nombre négatif pour soustraire. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.print(gdt.getDate());
Sortie :
2011-10-31
L’exemple suivant montre comment lire un champ DateTime à partir d’un enregistrement, ajouter des mois à l’aide de l’heure UTC et réécrire la valeur mise à jour dans le champ.
// Add 3 months (UTC) to a glide_date_time field on the current record
var monthsToAdd = 3;
// Convert the glide_date_time field (GlideElement) to a GlideDateTime object
var gdt = current.u_renewal_date.getGlideObject();
// Add months using UTC time
gdt.addMonthsUTC(monthsToAdd);
// Store the updated value back to the field using the internal (UTC) format
current.u_renewal_date.setValue(gdt.getValue());
Équivalent dans le champ d’application
Pour utiliser la méthode addMonthsUTC() dans une application incluse dans le champ d’application, 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 les années.
Utilisez addYearsLocalTime() ou addYearsUTC() au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| années | Numéro | Nombre d’années à ajouter. Utilisez une valeur négative pour soustraire. |
| 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 les années.
La méthode détermine la date et l’heure locales équivalentes à 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.
| Nom | Type | Description |
|---|---|---|
| années | Numéro | Nombre d’années à ajouter. Pour soustraire, utilisez une valeur négative. |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application 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 les 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.
| Nom | Type | Description |
|---|---|---|
| années | Numéro | Nombre d’années à ajouter. Utilisez une valeur négative pour soustraire. |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : addYearsUTC().
GlideDateTime : compareTo(DateTime de l’objet)
Compare deux objets de date et d’heure pour déterminer si l’un se produit avant l’autre ou s’ils sont équivalents.
| Nom | Type | Description |
|---|---|---|
| DateHeure | Objet | Date/heure dans un objet GlideDateTime |
| Type | Description |
|---|---|
| Numéro |
|
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 champ d’application, utilisez la méthode correspondante : compareTo().
GlideDateTime : égal à (objet GDT)
Compare un objet avec une valeur existante pour l’égalité.
| Nom | Type | Description |
|---|---|---|
| GDT (en anglais seulement) | Objet | Objet à comparer. Il peut s’agir d’un objet GlideDateTIme ou d’une chaîne de date et d’heure valide. |
| Type | Description |
|---|---|
| Booléen | Vrai s’ils sont égaux, faux sinon. |
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 de portée, utilisez la méthode de portée 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 champ d’application, utilisez la méthode correspondante : getDate().
GlideDateTime : getDayOfMonth()
Obtient le jour du mois dans le fuseau horaire UTC.
Déconseillé. Utilisez getDayOfMonthLocalTime() et getDayOfMonthUTC() au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Le 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 :
2
GlideDateTime : getDayOfMonthLocalTime()
Obtient le jour du mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 :
2
É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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Le 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 :
2
É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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 :
4
GlideDateTime : getDayOfWeekLocalTime()
Obtient le jour de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 :
4
É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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 :
4
É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és dans le fuseau horaire de l’ordinateur virtuel Java.
Utilisez getDaysInMonthLocalTime() et getDaysInMonthUTC() au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Nombre de jours du mois en cours dans le fuseau horaire de l’ordinateur virtuel Java. |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonth());
Sortie :
31
GlideDateTime : getDaysInMonthLocalTime()
Obtient le nombre de jours du mois stockés par l’objet GlideDateTime, exprimés dans le fuseau horaire de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Nombre de jours du mois en cours dans le fuseau horaire de l’utilisateur. |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthLocalTime());
Sortie :
31
É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és dans le fuseau horaire UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Nombre de jours du mois stockés par l’objet GlideDateTime, exprimés dans le fuseau horaire UTC. |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthUTC());
Sortie :
31
É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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 d’includes de script, que cette méthode peut renvoyer des valeurs dans des formats différents 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 de date/heure, mais pas pour les champs de date.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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é.
| Nom | Type | Description |
|---|---|---|
| Le style | Chaîne | Spécifie le format de date et d’heure. Valeurs valides :
Si une autre valeur est transmise, l’API utilisera par défaut le support. Les valeurs acceptées ne sont pas sensibles à la casse. |
| 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, langage 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.
| Nom | Type | Description |
|---|---|---|
| Le style | Chaîne | Spécifie le format de date et d’heure. Valeurs valides :
Si une autre valeur est transmise, l’API utilisera par défaut le support. Les valeurs acceptées ne sont pas sensibles à la casse. |
| language | Chaîne | Renvoie la date en fonction d’une valeur de langue spécifiée. Accepte les balises de langue conformes à la norme BCP-47. Par exemple, fr pour le français ou en-UK pour l’anglais britannique. Pour obtenir la liste complète des valeurs acceptées, consultez la liste des codes de langue BCP 47. |
| 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()
Indique la durée de décalage de l’heure d’été.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Durée de décalage, en millisecondes, de l’heure d’été. Renvoie la valeur 0 s’il n’y a pas de décalage ou si l’heure n’est pas définie sur l’heure d’été. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getDSTOffset());
Sortie :
3600000
Équivalent dans le champ d’application
Pour utiliser la méthode getDSTOffset() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : getDSTOffset().
GlideDateTime : getErrorMsg()
Obtient le message d’erreur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Objet | Le message d’erreur |
var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); //bad
gs.print(gdt.isValid()); //false
gs.print(gdt.getErrorMsg()); //reason
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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Objet | L’heure de l’objet dans le fuseau horaire local et le 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(Numéro dayOfTheWeek)
Renvoie un objet de date et d’heure défini sur minuit d’un jour spécifié à l’aide d’UTC.
| Nom | Type | Description |
|---|---|---|
| jourdelasemaine | Numéro | Jour de la semaine pour lequel renvoyer l’objet date/heure. |
| Type | Description |
|---|---|
| GlideDateTime | Un 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Date GlideDate | 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 l’utilisateur.
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 champ d’application, utilisez la méthode correspondante : getLocalDate().
GlideDateTime : getLocalTime()
Obtient l’heure dans le fuseau horaire de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| GlideTime | L’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 champ d’application, utilisez la méthode 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | La valeur numérique du mois, janvier = 1, décembre = 12. |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonth());
Sortie :
12
GlideDateTime : getMonthLocalTime()
Obtient le mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | La valeur numérique du mois, janvier = 1, décembre = 12. |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthLocalTime());
Sortie :
12
É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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | La valeur numérique du mois, janvier = 1, décembre = 12. |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthUTC());
Sortie :
12
É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 depuis le 1er janvier 1970 à 00:00:00 GMT.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Nombre de millisecondes 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(Numéro dayOfWeek)
Récupère le temps écoulé depuis minuit d’un jour spécifié jusqu’à l’heure actuelle.
| Nom | Type | Description |
|---|---|---|
| dayOfWeek | Numéro | Valeur du jour de la semaine de 1 à 7. 1 = lundi, 7 = dimanche. |
| Type | Description |
|---|---|
| GlideTime | Le temps écoulé depuis minuit le jour spécifié. Pour afficher le résultat de manière conviviale, 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| GlideTime | 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 champ d’application, utilisez la méthode correspondante : getTime().
GlideDateTime : getTZOffset()
Obtient le décalage du fuseau horaire en millisecondes.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Nombre de millisecondes de 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 champ d’application, utilisez la méthode correspondante : getTZOffset().
GlideDateTime : getUserFormattedLocalTime()
Renvoie l’heure de l’objet dans le fuseau horaire local au format de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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().
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Fuseau horaire | Objet 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(Numéro 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 de la semaine spécifié dans la semaine de l’objet GlideDateTime d’origine.
| Nom | Type | Description |
|---|---|---|
| jourdelasemaine | Numéro | Le jour de la semaine, de 13h à 13h. Lundi = 1, dimanche = 7. N’entrez pas 0 dans ce paramètre. |
| 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()
Retourne 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 nombre de semaines stockées 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Numéro de la semaine en cours. Le nombre de semaines le plus élevé dans une année est soit 52, soit 53. |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getWeekOfYearUTC());
Sortie :
49
É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 nombre de semaines stockées 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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Numéro de la semaine en cours en heure UTC. Le nombre de semaines le plus élevé dans une année est soit 52, soit 53. |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getWeekOfYearUTC());
Sortie :
49
É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.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Valeur à 4 chiffres de l’année dans le fuseau horaire de l’ordinateur virtuel Java. |
var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYear());
Sortie :
2011
GlideDateTime : getYearLocalTime()
Obtient l’année stockée par l’objet GlideDateTime, exprimée dans le fuseau horaire de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | La valeur à 4 chiffres de l’année dans le fuseau horaire de l’utilisateur. |
var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYearLocalTime());
Sortie :
2011
É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()
Retourne l’année stockée par l’objet GlideDateTime, exprimée dans le fuseau horaire UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Numéro | Valeur à quatre chiffres de l’année dans le fuseau horaire UTC. |
var gdt = new GlideDateTime(); //2011
gs.info(gdt.getYearUTC());
Sortie :
2011
Équivalent dans le champ d’application
Pour utiliser la méthode getYearUTC() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : getYearUTC().
GlideDateTime : hasDate()
Détermine si la date d’un objet est définie.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Booléen | Vrai si la date de l’objet est définie, faux 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 champ d’application, utilisez la méthode correspondante : hasDate().
GlideDateTime : isDST()
Détermine si l’heure de l’objet utilise un décalage d’heure d’été
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Booléen | Vrai si l’heure correspond à l’heure d’été, faux 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 champ d’application, utilisez la méthode correspondante : isDST().
GlideDateTime : isValid()
Détermine si une valeur est une date et une heure valides.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 champ d’application, utilisez la méthode correspondante : isValid().
GlideDateTime : setDayOfMonth(jour numérique)
Définit le jour du mois sur une valeur spécifiée.
Utilisez setDayOfMonthLocalTime(day) et setDayOfMonthUTC(day) au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| jour | Numéro | Jour du mois, de 1 à 31. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setDayOfMonth(9);
gs.print(gdt.getDayOfMonth());
Sortie :
9
GlideDateTime : setDayOfMonthLocalTime(nombre jour)
Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| jour | Numéro | Le jour du mois à changer, de 1 à 31. Si cette valeur est supérieure au nombre maximal de jours dans le mois, elle est fixée au dernier jour du mois. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.print(gdt.getDayOfMonthLocalTime());
Sortie :
9
É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(jour numérique)
Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire UTC.
| Nom | Type | Description |
|---|---|---|
| jour | Numéro | Le jour du mois à changer, de 1 à 31. Si cette valeur est supérieure au nombre maximal de jours dans le mois, elle est fixée au dernier jour du mois. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.print(gdt.getDayOfMonthUTC());
Sortie :
9
É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 (chaîne asDisplayed)
Définit une valeur de date et d’heure à l’aide du format d’affichage et du fuseau horaire de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| asDisplayed | Chaîne | Date et 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-aaaa HH :mm :ss. Pour affecter la date et l’heure actuelles à une variable dans un script de workflow, utilisez <variable>.setDisplayValue(gs.nowDateTime) ;. |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : setDisplayValue().
GlideDateTime : setDisplayValue(DateTime de la 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 lève 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 l’interception de l’exception.
| Nom | Type | Description |
|---|---|---|
| DateHeure | 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. |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : setDisplayValue().
GlideDateTime : setDisplayValueInternal(DateTime de la chaîne)
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.
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | Date et heure au format interne |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application 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.
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | La date et l’heure au format interne. |
| Type | Description |
|---|---|
| nul |
GlideDateTime : setDisplayValueLang(DateTime de la chaîne, Style de chaîne)
Définit une date à l’aide d’un style et d’un format spécifiés en fonction des paramètres régionaux de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | Valeur de date et d’heure de l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel. Les valeurs valides sont n’importe quelle sortie de date et d’heure de la fonction getDisplayValueLang(). Par exemple, l’utilisation de la sortie de l’exemple getDisplayValueLang(String style, String language) plus haut dans cette rubrique, 28 novembre 2022 07:03:41 ou 28.11.2022 07:03:41 sont des valeurs acceptées. |
| Le style | Chaîne | Spécifie le format de date. Valeurs valides :
Si une autre valeur est transmise, l’API utilisera par défaut le support. Les valeurs acceptées ne sont pas sensibles à la casse. |
| Type | Description |
|---|---|
| Nul |
L’exemple suivant renvoie la date et l’heure dans les styles court et complet.
var glideDateFR = new GlideDateTime();
glideDateFR.setDisplayValueLang("2/3/2023 17:27:56", "short");
gs.info('date: ' + glideDateFR.getDisplayValue());
gs.info('date: ' + glideDateFR.getDisplayValueLang("full"));
Sortie :
date: 2023-02-03 17:27:56
date: Friday, February 3, 2023 17:27:56
GlideDateTime : setDisplayValueLang(DateTime de la chaîne, Style de chaîne, Langage de la chaîne)
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.
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | Valeur de date et d’heure de l’objet GlideDate dans le fuseau horaire de l’utilisateur actuel. Les valeurs valides sont n’importe quelle sortie de date et d’heure de la fonction getDisplayValueLang(). Par exemple, l’utilisation de la sortie de l’exemple getDisplayValueLang(String style, String language) plus haut dans cette rubrique, 28 novembre 2022 07:03:41 ou 28.11.2022 07:03:41 sont des valeurs acceptées. |
| Le style | Chaîne | Spécifie le format de date. Valeurs valides :
Si une autre valeur est transmise, l’API utilisera par défaut le support. Les valeurs acceptées ne sont pas sensibles à la casse. |
| language | Chaîne | Définit la langue à l’aide d’une balise de langue conforme à la norme BCP-47. Par exemple, fr pour le français ou en-UK pour l’anglais britannique. Pour obtenir la liste complète des valeurs acceptées, consultez la liste des codes de langue BCP 47. |
| Type | Description |
|---|---|
| Nul |
L’exemple suivant renvoie la date et l’heure dans des styles court et complet pour l’anglais et le français.
var glideDateFR = new 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 équivaut à instancier un nouvel objet avec un paramètre GlideDateTime.
| Nom | Type | Description |
|---|---|---|
| gDT | GlideDateTime | Un objet GlideDateTime |
| 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(DateTime de la chaîne)
Définit la date et l’heure.
Cette méthode est équivalente à setValue(Object).
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | Date et heure à utiliser. Accepte soit une chaîne dans le fuseau horaire GMT au format interne, soit un objet GlideDateTime. |
| 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(Nombre mois)
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() au lieu de cette méthode.
| Nom | Type | Description |
|---|---|---|
| mois | Numéro | Mois vers lequel changer. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setMonth(1);
gs.print(gdt.getMonth());
Sortie :
1
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.
| Nom | Type | Description |
|---|---|---|
| mois | Numéro | Mois vers lequel changer. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.print(gdt.getMonthLocalTime());
Sortie :
1
Équivalent dans le champ d’application
Pour utiliser la méthode setMonthLocalTime() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : setMonthLocalTime().
GlideDateTime : setMonthUTC(Nombre mois)
Définit le mois stocké par l’objet GlideDateTime sur une valeur spécifiée à l’aide du fuseau horaire UTC.
| Nom | Type | Description |
|---|---|---|
| mois | Numéro | Mois vers lequel changer. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.print(gdt.getMonthUTC());
Sortie :
1
Équivalent dans le champ d’application
Pour utiliser la méthode setMonthUTC() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : setMonthUTC().
GlideDateTime : setNumericValue(nombre de millisecondes)
Définit la date et l’heure sur le nombre de millisecondes depuis le 1er janvier 1970 à 00:00:00 GMT.
| Nom | Type | Description |
|---|---|---|
| millisecondes | Numéro | Nombre de millisecondes |
| 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 fuseau horaire spécifié.
| Nom | Type | Description |
|---|---|---|
| Fuseau horaire | Fuseau horaire | Objet de fuseau horaire |
| Type | Description |
|---|---|
| nul |
var tz = gs.getSession().getTimeZone();
var gdt = new GlideDateTime();
gdt.setTZ(tz);
GlideDateTime : setValue(DateTime de l’objet)
Définit la date et l’heure de l’objet GlideDateTime.
Cette méthode est équivalente à setInitialValue().
| Nom | Type | Description |
|---|---|---|
| DateHeure | Objet | Date et heure à utiliser. Ce paramètre peut être de plusieurs types.
|
| Type | Description |
|---|---|
| nul |
Définissez 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
Définissez 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 champ d’application, utilisez la méthode correspondante : setValue().
GlideDateTime : setValueUTC(DateTime de la chaîne, 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 lève 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 l’interception de l’exception.
| Nom | Type | Description |
|---|---|---|
| DateHeure | Chaîne | Date et heure à utiliser. |
| format | Chaîne | Le format à utiliser. |
| 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 champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : setValueUTC().
GlideDateTime : setYear(annéenumérique)
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.
| Nom | Type | Description |
|---|---|---|
| année | Numéro | L’année du changement. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setYear(2013);
gs.print(gdt.getYear());
Sortie :
2013
GlideDateTime : setYearLocalTime(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 de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| année | Numéro | L’année du changement. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.print(gdt.getYearLocalTime());
Sortie :
2013
Équivalent dans le champ d’application
Pour utiliser la méthode setYearLocalTime() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application 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.
| Nom | Type | Description |
|---|---|---|
| année | Numéro | L’année du changement. |
| Type | Description |
|---|---|
| nul |
var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.print(gdt.getYearUTC());
Sortie :
2013
Équivalent dans le champ d’application
Pour utiliser la méthode setYearUTC() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : setYearUTC().
GlideDateTime : soustraire(heure GlideTime)
Soustrait une durée spécifiée.
| Nom | Type | Description |
|---|---|---|
| heure | GlideTime | Le temps à soustraire |
| 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 à portée, utilisez la méthode à portée correspondante : subtract().
GlideDateTime : soustraire(nombre de millisecondes)
Soustrait un nombre spécifié de millisecondes de l’objet GlideDateTime.
| Nom | Type | Description |
|---|---|---|
| millisecondes | Numéro | Le nombre de millisecondes à soustraire |
| 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 à portée, utilisez la méthode à portée correspondante : subtract().
GlideDateTime : soustraire(GlideDateTime début, GlideDateTime fin)
Renvoie la différence de durée entre deux objets GlideDateTime spécifiés.
| Nom | Type | Description |
|---|---|---|
| début | GlideDateTime | Objet de date de début. |
| fin | GlideDateTime | Objet de date de fin. |
| Type | Description |
|---|---|
| Durée 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 à portée, utilisez la méthode à portée 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().
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Objet | Date et heure stockées par l’objet GlideDateTime dans le fuseau horaire et au 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 scoped, utilisez la méthode scoped correspondante : toString().