--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # GlideDateTime : global # GlideDateTime : global {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 40 minutes de lecture La classe GlideDateTime fournit des méthodes permettant d'effectuer des opérations sur les objets GlideDateTime. Utilisez les méthodes GlideDateTime pour effectuer des opérations de date-heure, telles que l'instanciation d'un objet GlideDateTime, l'exécution de calculs de date-heure, la mise en forme d'une date-heure ou la conversion entre des formats date-heure. Pour obtenir des conseils sur les chaînes d'entrée de date et heure avec une liste des conflits de format courants, reportez-vous à [Directives relatives au format de la date et de l'heure](https://servicenow-prod.fluidtopics.net/VPFM7rKMmvkG7R6eDSeRwQ#date-and-time-format-guidelines "Vous pouvez spécifier un format de date avec une séquence de chaînes de modèle de date et d’heure spécifiques. Une chaîne de modèle se compose d’une ou plusieurs lettres majuscules et minuscules de A à Z. Tout texte entre guillemets est ignoré et copié dans la sortie date."). ## GlideDateTime : GlideDateTime() {#ariaid-title2} Instancie un nouvel objet GlideDateTime avec la date et l'heure actuelles. {#r_GDT-GlideDateTime__table_qpq_slc_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 1. Paramètres] {#r_GDT-GlideDateTime__table_qpq_slc_nt} Cet exemple instancie un objet GlideDateTime . var gdt = new GlideDateTime(); gs.info(gdt); Sortie : 2022-08-08 16:51:44 ## GlideDateTime : GlideDateTime(String dateTime) {#ariaid-title3} 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-aa hh :mm * mm-jj-aaaa * MM/jj/aaaa * jj-MM-aaaa hh:mm:ss * jj-MM-aa HH.mm.ss * jj-MM-aa 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 un * jj.MM.aaaa {#r_GDT-GlideDateTime_S__ul_xgq_hmz_lnb} Remarque : Le format suivant n'est pas pris en charge : * aaaa-MM-jj'T'HH :mm :ss. SSSZ (en anglais seulement) {#r_GDT-GlideDateTime_S__ul_udg_d5w_lcc} {#r_GDT-GlideDateTime_S__table_ufk_jmc_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | Chaîne | Date et heure UTC à définir dans l'objet GlideDateTime . | [Tableau 2. Paramètres] {#r_GDT-GlideDateTime_S__table_ufk_jmc_nt} var gdt = new GlideDateTime("2023-01-01 12:00:00"); gs.info(gdt); Sortie : 2023-01-01 12:00:00 ## GlideDateTime : GlideDateTime(GlideDateTime gdt) {#ariaid-title4} Instancie un nouvel objet GlideDateTime défini sur l'heure d'un objet GlideDateTime spécifié. {#r_GDT-GlideDateTime_GDT__table_jqw_cnc_nt__entry__3} | Nom | Type | Description | |-|-|-| | Le GDT | GlideDateTime | Objet utilisé pour définir l'heure du nouvel objet. | [Tableau 3. Paramètres] {#r_GDT-GlideDateTime_GDT__table_jqw_cnc_nt} 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) {#ariaid-title5} Ajoute un nombre spécifié de millisecondes à l'objet GlideDateTime. {#r_GDT-add_N__table_x2g_nsl_nt__entry__3} | Nom | Type | Description | |-|-|-| | millisecondes | Numéro | Nombre de millisecondes à ajouter | [Tableau 4. Paramètres] {#r_GDT-add_N__table_x2g_nsl_nt} {#r_GDT-add_N__table_y2g_nsl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 5. Renvoie] {#r_GDT-add_N__table_y2g_nsl_nt} 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 {#r_GDT-add_N__section_bqp_jnr_mcb} Pour utiliser la méthode add() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [add().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAdd_Number "Ajoute le nombre spécifié de millisecondes à l’objet GlideDateTime actuel.") ## GlideDateTime : ajouter (heure GlideTime) {#ariaid-title6} Ajoute un objet GlideTime à l'objet GlideDateTime actuel. {#r_GDT-add_GT__table_e4r_xs2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Diagramme des séries chronologiques | [Heure de Glide](https://servicenow-prod.fluidtopics.net/qTDAYs107lLRvuJ9WRNpmQ#c_GlideTimeScopedAPI "L’API GlideTime fournit des méthodes pour effectuer des opérations sur les objets GlideTime, telles que l’instanciation d’objets GlideTime ou l’utilisation des champs GlideTime.") | Objet GlideTime dont la valeur temporelle doit être ajoutée à l'objet GlideDateTime spécifié. | [Tableau 6. Paramètres] {#r_GDT-add_GT__table_e4r_xs2_nt} {#r_GDT-add_GT__table_f4r_xs2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 7. Renvoie] {#r_GDT-add_GT__table_f4r_xs2_nt} 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 {#r_GDT-add_GT__section_prv_gnr_mcb} Pour utiliser la méthode add() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [add().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAdd_GlideTime_gd "Ajoute un objet GlideTime à l’objet GlideDateTime actuel.") ## GlideDateTime : addDays(nombre de jours) {#ariaid-title7} Ajoute un nombre spécifié de jours à l'objet GlideDateTime actuel. Un paramètre négatif soustrait les jours. Utilisez addDaysLocalTime() et addDaysUTC() à la place de cette méthode. {#r_GDT-addDays_N__table_h1q_3t2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jours | Numéro | Nombre de jours à ajouter. Utilisez un nombre négatif à soustraire. | [Tableau 8. Paramètres] {#r_GDT-addDays_N__table_h1q_3t2_nt} {#r_GDT-addDays_N__table_i1q_3t2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 9. Renvoie] {#r_GDT-addDays_N__table_i1q_3t2_nt} 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) {#ariaid-title8} 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 des jours à l'aide des valeurs de date et d'heure locales. {#r_GDT-addDaysLocalTime_N__table_ll1_xt2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jours | Numéro | Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire. | [Tableau 10. Paramètres] {#r_GDT-addDaysLocalTime_N__table_ll1_xt2_nt} {#r_GDT-addDaysLocalTime_N__table_ml1_xt2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 11. Renvoie] {#r_GDT-addDaysLocalTime_N__table_ml1_xt2_nt} 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 {#r_GDT-addDaysLocalTime_N__section_hnw_5lr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddDaysLocalTime_Number "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 des jours à l’aide des valeurs de date et d’heure locales.") ## GlideDateTime : addDaysUTC (nombre de jours) {#ariaid-title9} 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. {#r_GDT-addDaysUTC_N__table_vyt_k52_nt__entry__3} | Nom | Type | Description | |-|-|-| | jours | Numéro | Nombre de jours à ajouter. Utilisez une valeur négative pour soustraire. | [Tableau 12. Paramètres] {#r_GDT-addDaysUTC_N__table_vyt_k52_nt} {#r_GDT-addDaysUTC_N__table_wyt_k52_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 13. Renvoie] {#r_GDT-addDaysUTC_N__table_wyt_k52_nt} 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 {#r_GDT-addDaysUTC_N__section_ljh_ylr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddDaysUTC_Number "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.") ## GlideDateTime : addSeconds(Nombre de secondes) {#ariaid-title10} Ajoute un nombre spécifié de secondes à l'objet GlideDateTime. {#r_GDT-addSeconds_N__table_xlx_zsl_nt__entry__3} | Nom | Type | Description | |-|-|-| | secondes | Numéro | Nombre de secondes à ajouter | [Tableau 14. Paramètres] {#r_GDT-addSeconds_N__table_xlx_zsl_nt} {#r_GDT-addSeconds_N__table_ylx_zsl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 15. Renvoie] {#r_GDT-addSeconds_N__table_ylx_zsl_nt} 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 {#r_GDT-addSeconds_N__section_mnz_gmr_mcb} Pour utiliser la méthode addSeconds() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [addSeconds().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddSeconds_Number "Ajoute le nombre spécifié de secondes à l’objet GlideDateTime actuel.") ## GlideDateTime : addWeeks(nombre de semaines) {#ariaid-title11} 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. {#r_GDT-addWeeks_N__table_bpk_v52_nt__entry__3} | Nom | Type | Description | |-|-|-| | semaines | Numéro | Nombre de semaines à ajouter. Utilisez un nombre négatif à soustraire. | [Tableau 16. Paramètres] {#r_GDT-addWeeks_N__table_bpk_v52_nt} {#r_GDT-addWeeks_N__table_cpk_v52_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 17. Renvoie] {#r_GDT-addWeeks_N__table_cpk_v52_nt} 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) {#ariaid-title12} 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. {#r_GDT-addWeeksLocalTime_N__table_ozv_3v2_nt__entry__3} | Nom | Type | Description | |-|-|-| | semaines | Numéro | Nombre de semaines à ajouter. Utilisez un nombre négatif à soustraire. | [Tableau 18. Paramètres] {#r_GDT-addWeeksLocalTime_N__table_ozv_3v2_nt} {#r_GDT-addWeeksLocalTime_N__table_pzv_3v2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 19. Renvoie] {#r_GDT-addWeeksLocalTime_N__table_pzv_3v2_nt} 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 {#r_GDT-addWeeksLocalTime_N__section_uq1_wmr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddWeeksLocalTime_Number "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.") ## GlideDateTime - addWeeksUTC(Nombre de semaines) {#ariaid-title13} 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 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. {#r_GDT-addWeeksUTC_N__table_rdr_5v2_nt__entry__3} | Nom | Type | Description | |-|-|-| | semaines | Numéro | Nombre de semaines à ajouter. Utilisez un nombre négatif à soustraire. | [Tableau 20. Paramètres] {#r_GDT-addWeeksUTC_N__table_rdr_5v2_nt} {#r_GDT-addWeeksUTC_N__table_sdr_5v2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 21. Renvoie] {#r_GDT-addWeeksUTC_N__table_sdr_5v2_nt} 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 {#r_GDT-addWeeksUTC_N__section_pnm_ymr_mcb} Pour utiliser la méthode addWeeksUTC() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [addWeeksUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddWeeksUTC_Number "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 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.") ## GlideDateTime : addMonths(nombre de mois) {#ariaid-title14} 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. {#r_GDT-addMonths_N__table_tgm_bkk_nt__entry__3} | Nom | Type | Description | |-|-|-| | mois | Numéro | Nombre de mois à ajouter. Utilisez un nombre négatif à soustraire. | [Tableau 22. Paramètres] {#r_GDT-addMonths_N__table_tgm_bkk_nt} {#r_GDT-addMonths_N__table_ugm_bkk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 23. Renvoie] {#r_GDT-addMonths_N__table_ugm_bkk_nt} 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) {#ariaid-title15} 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 des mois à l'aide des valeurs de date et d'heure locales. {#r_GDT-addMonthsLocalTime_N__table_fmn_pkk_nt__entry__3} | Nom | Type | Description | |-|-|-| | mois | Numéro | Nombre de mois à ajouter. Utilisez une valeur négative pour soustraire. | [Tableau 24. Paramètres] {#r_GDT-addMonthsLocalTime_N__table_fmn_pkk_nt} {#r_GDT-addMonthsLocalTime_N__table_gmn_pkk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 25. Renvoie] {#r_GDT-addMonthsLocalTime_N__table_gmn_pkk_nt} 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 {#r_GDT-addMonthsLocalTime_N__section_xvc_bmr_mcb} Pour utiliser la méthode addMonthsLocalTime() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [addMonthsLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddMonthsLocalTime_Number "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 des mois à l’aide des valeurs de date et d’heure locales.") ## GlideDateTime : addMonthsUTC(nombre de mois) {#ariaid-title16} Ajoute un nombre spécifié de mois à l'objet GlideDateTime actuel. Un paramètre négatif soustrait des 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 les mois à l'aide des valeurs de date et d'heure UTC. {#r_GDT-addMonthsUTC_N__table_lqp_1lk_nt__entry__3} | Nom | Type | Description | |-|-|-| | mois | Numéro | Nombre de mois à ajouter. Utilisez un nombre négatif à soustraire. | [Tableau 26. Paramètres] {#r_GDT-addMonthsUTC_N__table_lqp_1lk_nt} {#r_GDT-addMonthsUTC_N__table_mqp_1lk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 27. Renvoie] {#r_GDT-addMonthsUTC_N__table_mqp_1lk_nt} 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 {#r_GDT-addMonthsUTC_N__section_gxn_2mr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddMonthsUTC_Number "Ajoute un nombre spécifié de mois à l’objet GlideDateTime actuel. Un paramètre négatif soustrait des 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 les mois à l’aide des valeurs de date et d’heure UTC.") ## GlideDateTime : addYears(Nombre d'années) {#ariaid-title17} 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() à la place de cette méthode. {#r_GDT-addYears_N__table_fpz_mlk_nt__entry__3} | Nom | Type | Description | |-|-|-| | années | Numéro | Nombre d'années à ajouter. Utilisez une valeur négative pour soustraire. | [Tableau 28. Paramètres] {#r_GDT-addYears_N__table_fpz_mlk_nt} {#r_GDT-addYears_N__table_gpz_mlk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 29. Renvoie] {#r_GDT-addYears_N__table_gpz_mlk_nt} 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) {#ariaid-title18} 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 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. {#r_GDT-addYearsLocalTime_N__table_llj_ryk_nt__entry__3} | Nom | Type | Description | |-|-|-| | années | Numéro | Nombre d'années à ajouter. Pour soustraire, utilisez une valeur négative. | [Tableau 30. Paramètres] {#r_GDT-addYearsLocalTime_N__table_llj_ryk_nt} {#r_GDT-addYearsLocalTime_N__table_mlj_ryk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 31. Renvoie] {#r_GDT-addYearsLocalTime_N__table_mlj_ryk_nt} 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 {#r_GDT-addYearsLocalTime_N__section_yhl_bnr_mcb} Pour utiliser la méthode AddYearsLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [AddYearsLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddYearsLocalTime_Number "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 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.") ## GlideDateTime - addYearsUTC(Nombre d'années) {#ariaid-title19} 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. {#r_GDT-addYearsUTC_N__table_njl_czk_nt__entry__3} | Nom | Type | Description | |-|-|-| | années | Numéro | Nombre d'années à ajouter. Utilisez une valeur négative pour soustraire. | [Tableau 32. Paramètres] {#r_GDT-addYearsUTC_N__table_njl_czk_nt} {#r_GDT-addYearsUTC_N__table_ojl_czk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 33. Renvoie] {#r_GDT-addYearsUTC_N__table_ojl_czk_nt} 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 {#r_GDT-addYearsUTC_N__section_yj1_2nr_mcb} Pour utiliser la méthode addYearsUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [addYearsUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeAddYearsUTC_Number "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.") ## GlideDateTime : compareTo(Object dateTime) {#ariaid-title20} Compare deux objets de date et d'heure pour déterminer si l'un apparaît avant l'autre ou s'ils sont équivalents. {#r_GDT-compareTo_O__table_sc3_rbd_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | Objet | Date/heure dans un objet GlideDateTime | [Tableau 34. Paramètres] {#r_GDT-compareTo_O__table_sc3_rbd_nt} {#r_GDT-compareTo_O__table_tc3_rbd_nt__entry__2} | 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 {#r_GDT-compareTo_O__ul_tb3_mjg_sz} | [Tableau 35. Renvoie] {#r_GDT-compareTo_O__table_tc3_rbd_nt} 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 {#r_GDT-compareTo_O__section_opf_mnr_mcb} Pour utiliser la méthode compareTo() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le champ d'application : [compareTo().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeCompareTo_Object_o "Compare deux objets de date et d’heure pour déterminer s’ils sont équivalents ou si l’un se produit avant ou après l’autre.") ## GlideDateTime - equals(Objet GDT) {#ariaid-title21} Compare un objet avec une valeur existante pour l'égalité. {#r_GDT-equals_O__table_njf_vvl_nt__entry__3} | Nom | Type | Description | |-|-|-| | GDT (en anglais seulement) | Objet | L'objet à comparer. Il peut s'agir d'un objet GlideDateTIme ou d'une chaîne de date heure valide. | [Tableau 36. Paramètres] {#r_GDT-equals_O__table_njf_vvl_nt} {#r_GDT-equals_O__table_ojf_vvl_nt__entry__2} | Type | Description | |-|-| | Booléen | Vrai s'ils sont égaux, faux dans le cas contraire. | [Tableau 37. Renvoie] {#r_GDT-equals_O__table_ojf_vvl_nt} 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 {#r_GDT-equals_O__section_i3p_4nr_mcb} Pour utiliser la méthode equals() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [equals().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeEquals_Object "Compare une date/heure avec une valeur existante pour l’égalité.") ## GlideDateTime : getDate() {#ariaid-title22} 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. {#r_GDT-getDate__table_mjv_xq2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 38. Paramètres] {#r_GDT-getDate__table_mjv_xq2_nt} {#r_GDT-getDate__table_njv_xq2_nt__entry__2} | 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. | [Tableau 39. Renvoie] {#r_GDT-getDate__table_njv_xq2_nt} var gdt = new GlideDateTime("2011-08-31 08:00:00"); gs.info(gdt.getDate()); Sortie : 2011-08-31 ### Équivalent dans le champ d'application {#r_GDT-getDate__section_xpq_tnr_mcb} Pour utiliser la méthode getDate() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [getDate().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDate "Renvoie la date stockée par l’objet GlideDateTime. Exprimé au format standard, aaaa-MM-jj, et dans le fuseau horaire du système, GMT par défaut.") ## GlideDateTime : getDayOfMonth() {#ariaid-title23} Obtient le jour actuel du mois dans le fuseau horaire UTC. Déconseillé. Utilisez getDayOfMonthLocalTime() et getDayOfMonthUTC() à la place de cette méthode. {#r_GDT-getDayOfMonth__table_orj_hg2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 40. Paramètres] {#r_GDT-getDayOfMonth__table_orj_hg2_nt} {#r_GDT-getDayOfMonth__table_prj_hg2_nt__entry__2} | Type | Description | |-|-| | Numéro | Jour du mois dans le fuseau horaire UTC, de 1 à 31. | [Tableau 41. Renvoie] {#r_GDT-getDayOfMonth__table_prj_hg2_nt} var gdt = new GlideDateTime("2011-12-02 12:00:00"); gs.print(gdt.getDayOfMonth()); Sortie : 2 ## GlideDateTime : getDayOfMonthLocalTime() {#ariaid-title24} Obtient le jour du mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire de l'utilisateur actuel. {#r_GDT-getDayOfMonthLocalTime__table_e4r_wg2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 42. Paramètres] {#r_GDT-getDayOfMonthLocalTime__table_e4r_wg2_nt} {#r_GDT-getDayOfMonthLocalTime__table_f4r_wg2_nt__entry__2} | Type | Description | |-|-| | Numéro | Jour du mois dans le fuseau horaire de l'utilisateur, de 1 à 31. | [Tableau 43. Renvoie] {#r_GDT-getDayOfMonthLocalTime__table_f4r_wg2_nt} var gdt = new GlideDateTime("2011-12-02 12:00:00"); gs.print(gdt.getDayOfMonthLocalTime()); Sortie : 2 ### Équivalent dans le champ d'application {#r_GDT-getDayOfMonthLocalTime__section_ap5_d4r_mcb} Pour utiliser la méthode getDayOfMonthLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getDayOfMonthLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDayOfMonthLocalTime "Obtient le jour du mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : getDayOfMonthUTC() {#ariaid-title25} Obtient le jour du mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire UTC. {#r_GDT-getDayOfMonthUTC__table_hhb_nh2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 44. Paramètres] {#r_GDT-getDayOfMonthUTC__table_hhb_nh2_nt} {#r_GDT-getDayOfMonthUTC__table_ihb_nh2_nt__entry__2} | Type | Description | |-|-| | Numéro | Jour du mois dans le fuseau horaire UTC, de 1 à 31. | [Tableau 45. Renvoie] {#r_GDT-getDayOfMonthUTC__table_ihb_nh2_nt} var gdt = new GlideDateTime("2011-12-02 12:00:00"); gs.print(gdt.getDayOfMonthUTC()); Sortie : 2 ### Équivalent dans le champ d'application {#r_GDT-getDayOfMonthUTC__section_rvd_34r_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDayOfMonthUTC "Obtient le jour du mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.") ## GlideDateTime : getDayOfWeek() {#ariaid-title26} 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. {#r_GDT-getDayOfWeek__table_yvw_zc2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 46. Paramètres] {#r_GDT-getDayOfWeek__table_yvw_zc2_nt} {#r_GDT-getDayOfWeek__table_zvw_zc2_nt__entry__2} | Type | Description | |-|-| | Numéro | Valeur du jour de la semaine - Lundi = 1, ... Dimanche = 7. | [Tableau 47. Renvoie] {#r_GDT-getDayOfWeek__table_zvw_zc2_nt} var gdt = new GlideDateTime("2011-12-01 12:00:00"); gs.print(gdt.getDayOfWeek()); Sortie : 4 ## GlideDateTime : getDayOfWeekLocalTime() {#ariaid-title27} Obtient le jour de la semaine stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire de l'utilisateur. {#r_GDT-getDayOfWeekLocalTime__table_xmt_qd2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 48. Paramètres] {#r_GDT-getDayOfWeekLocalTime__table_xmt_qd2_nt} {#r_GDT-getDayOfWeekLocalTime__table_ymt_qd2_nt__entry__2} | Type | Description | |-|-| | Numéro | Valeur du jour de la semaine - Lundi = 1, ... Dimanche = 7 | [Tableau 49. Renvoie] {#r_GDT-getDayOfWeekLocalTime__table_ymt_qd2_nt} var gdt = new GlideDateTime("2011-12-01 12:00:00"); gs.print(gdt.getDayOfWeekLocalTime()); Sortie : 4 ### Équivalent dans le champ d'application {#r_GDT-getDayOfWeekLocalTime__section_lmp_k4r_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDayOfWeekLocalTime "Obtient le jour de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur.") ## GlideDateTime : getDayOfWeekUTC() {#ariaid-title28} Obtient le jour de la semaine stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire UTC. {#r_GDT-getDayOfWeekUTC__table_bwl_b22_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 50. Paramètres] {#r_GDT-getDayOfWeekUTC__table_bwl_b22_nt} {#r_GDT-getDayOfWeekUTC__table_cwl_b22_nt__entry__2} | Type | Description | |-|-| | Numéro | Valeur du jour de la semaine - Lundi = 1, ... Dimanche = 7 | [Tableau 51. Renvoie] {#r_GDT-getDayOfWeekUTC__table_cwl_b22_nt} var gdt = new GlideDateTime("2011-12-01 12:00:00"); gs.print(gdt.getDayOfWeekUTC()); Sortie : 4 ### Équivalent dans le champ d'application {#r_GDT-getDayOfWeekUTC__section_ddt_n4r_mcb} Pour utiliser la méthode getDayOfWeekUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getDayOfWeekUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDayOfWeekUTC "Renvoie le jour de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.") ## GlideDateTime : getDaysInMonth() {#ariaid-title29} 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. {#r_GDT-getDaysInMonth__table_s3d_yj2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 52. Paramètres] {#r_GDT-getDaysInMonth__table_s3d_yj2_nt} {#r_GDT-getDaysInMonth__table_t3d_yj2_nt__entry__2} | Type | Description | |-|-| | Numéro | Nombre de jours du mois en cours dans le fuseau horaire de l'ordinateur virtuel Java. | [Tableau 53. Renvoie] {#r_GDT-getDaysInMonth__table_t3d_yj2_nt} var gdt = new GlideDateTime(); //December gs.print(gdt.getDaysInMonth()); Sortie : 31 ## GlideDateTime : getDaysInMonthLocalTime() {#ariaid-title30} Obtient le nombre de jours du mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire de l'utilisateur actuel. {#r_GDT-getDaysInMonthLocalTime__table_sjf_lk2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 54. Paramètres] {#r_GDT-getDaysInMonthLocalTime__table_sjf_lk2_nt} {#r_GDT-getDaysInMonthLocalTime__table_tjf_lk2_nt__entry__2} | Type | Description | |-|-| | Numéro | Nombre de jours du mois en cours dans le fuseau horaire de l'utilisateur. | [Tableau 55. Renvoie] {#r_GDT-getDaysInMonthLocalTime__table_tjf_lk2_nt} var gdt = new GlideDateTime(); //December gs.print(gdt.getDaysInMonthLocalTime()); Sortie : 31 ### Équivalent dans le champ d'application {#r_GDT-getDaysInMonthLocalTime__section_z35_q4r_mcb} Pour utiliser la méthode getDaysInMonthLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getDaysInMonthLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDaysInMonthLocalTime "Obtient le nombre de jours du mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : getDaysInMonthUTC() {#ariaid-title31} Obtient le nombre de jours dans le mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire UTC. {#r_GDT-getDaysInMonthUTC__table_hwd_ll2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 56. Paramètres] {#r_GDT-getDaysInMonthUTC__table_hwd_ll2_nt} {#r_GDT-getDaysInMonthUTC__table_iwd_ll2_nt__entry__2} | Type | Description | |-|-| | Numéro | Nombre de jours dans le mois stockés par l'objet GlideDateTime, exprimé dans le fuseau horaire UTC. | [Tableau 57. Renvoie] {#r_GDT-getDaysInMonthUTC__table_iwd_ll2_nt} var gdt = new GlideDateTime(); //December gs.print(gdt.getDaysInMonthUTC()); Sortie : 31 ### Équivalent dans le champ d'application {#r_GDT-getDaysInMonthUTC__section_l4t_54r_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDaysInMonthUTC "Obtient le nombre de jours dans le mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.") ## GlideDateTime : getDisplayValue() {#ariaid-title32} 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. {#r_GDT-getDisplayValue__table_lyf_h1d_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 58. Paramètres] {#r_GDT-getDisplayValue__table_lyf_h1d_nt} {#r_GDT-getDisplayValue__table_myf_h1d_nt__entry__2} | Type | Description | |-|-| | Objet | Date et heure au format et fuseau horaire de l'utilisateur. Lors de la conception de règles métier ou d'includes de script, gardez à l'esprit que cette méthode peut renvoyer des valeurs dans différents formats pour différents utilisateurs. | [Tableau 59. Renvoie] {#r_GDT-getDisplayValue__table_myf_h1d_nt} 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 {#r_GDT-getDisplayValue__section_u2f_x4r_mcb} Pour utiliser la méthode getDisplayValue() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [getDisplayValue().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDisplayValue "Obtient la valeur de date et d’heure dans le format d’affichage et le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : getDisplayValueInternal() {#ariaid-title33} 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. {#r_GDT-getDisplayValueInternal__table_ocw_t1d_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 60. Paramètres] {#r_GDT-getDisplayValueInternal__table_ocw_t1d_nt} {#r_GDT-getDisplayValueInternal__table_pcw_t1d_nt__entry__2} | Type | Description | |-|-| | Objet | Les valeurs de date et d'heure de l'objet GlideDateTime. Format : aaaa-MM-jj HH :mm :ss dans le fuseau horaire de l'appelant. | [Tableau 61. Renvoie] {#r_GDT-getDisplayValueInternal__table_pcw_t1d_nt} // 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 {#r_GDT-getDisplayValueInternal__section_jng_z4r_mcb} Pour utiliser la méthode getDisplayValueInternal() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getDisplayValueInternal().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDisplayValueInternal "Obtient la valeur d’affichage au format interne (aaaa-MM-jj HH :mm :ss).") ## GlideDateTime : getDisplayValueLang(style de chaîne) {#ariaid-title34} Renvoie une valeur de date et d'heure dans les paramètres régionaux de l'utilisateur en fonction du style de date spécifié. {#r_GDT-getDisplayValueLang_S__id_zqf_hvw_dwb__entry__3} | Nom | Type | Description | |-|-|-| | style | Chaîne | Spécifie le format de date et d'heure. Valeurs valides : * complet : renvoie la date au format \ en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \ en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/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 62. Paramètres] {#r_GDT-getDisplayValueLang_S__id_zqf_hvw_dwb} {#r_GDT-getDisplayValueLang_S__id_pp1_3vw_dwb__entry__2} | 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. | [Tableau 63. Renvoie] {#r_GDT-getDisplayValueLang_S__id_pp1_3vw_dwb} 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) {#ariaid-title35} Renvoie une valeur de date et d'heure dans les paramètres régionaux de l'utilisateur en fonction d'une langue et d'un style de date spécifiés. {#r_GDT-getDisplayValueLang_S_S__id_dfb_4vw_dwb__entry__3} | Nom | Type | Description | |-|-|-| | style | Chaîne | Spécifie le format de date et d'heure. Valeurs valides : * complet : renvoie la date au format \ en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \ en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/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. | | language | 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](https://appmakers.dev/bcp-47-language-codes-list/). | [Tableau 64. Paramètres] {#r_GDT-getDisplayValueLang_S_S__id_dfb_4vw_dwb} {#r_GDT-getDisplayValueLang_S_S__id_v5l_4vw_dwb__entry__2} | 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. | [Tableau 65. Renvoie] {#r_GDT-getDisplayValueLang_S_S__id_v5l_4vw_dwb} 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() {#ariaid-title36} Obtient le décalage de l'heure d'été. {#r_GDT-getDSTOffset__table_iyb_vvc_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 66. Paramètres] {#r_GDT-getDSTOffset__table_iyb_vvc_nt} {#r_GDT-getDSTOffset__table_jyb_vvc_nt__entry__2} | 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 pendant l'heure d'été. | [Tableau 67. Renvoie] {#r_GDT-getDSTOffset__table_jyb_vvc_nt} var gdt = new GlideDateTime("2011-08-31 08:00:00"); gs.print(gdt.getDSTOffset()); Sortie : 3600000 ### Équivalent dans le champ d'application {#r_GDT-getDSTOffset__section_myc_rnr_mcb} Pour utiliser la méthode getDSTOffset() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [getDSTOffset().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetDSTOffset "Obtient le décalage de l’heure d’été.") ## GlideDateTime : getErrorMsg() {#ariaid-title37} Obtient le message d'erreur actuel. {#r_GDT-getErrorMsg__table_dks_dsl_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 68. Paramètres] {#r_GDT-getErrorMsg__table_dks_dsl_nt} {#r_GDT-getErrorMsg__table_eks_dsl_nt__entry__2} | Type | Description | |-|-| | Objet | Message d'erreur | [Tableau 69. Renvoie] {#r_GDT-getErrorMsg__table_eks_dsl_nt} 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 {#r_GDT-getErrorMsg__section_hmx_hpr_mcb} Pour utiliser la méthode getErrorMsg() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [getErrorMsg().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetErrorMsg "Obtient le message d’erreur actuel.") ## GlideDateTime : getInternalFormattedLocalTime() {#ariaid-title38} Renvoie l'heure de l'objet dans le fuseau horaire local et au format interne. {#r_GDT-getInternalFormatedLocalTime__table_izw_h5c_kw__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 70. Paramètres] {#r_GDT-getInternalFormatedLocalTime__table_izw_h5c_kw} {#r_GDT-getInternalFormatedLocalTime__table_jzw_h5c_kw__entry__2} | Type | Description | |-|-| | Objet | L'heure de l'objet dans le fuseau horaire local et le format interne. | [Tableau 71. Renvoie] {#r_GDT-getInternalFormatedLocalTime__table_jzw_h5c_kw} 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 {#r_GDT-getInternalFormatedLocalTime__section_xvx_hc2_dbb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_SGDT-getInternalFormattedLocalTime "Renvoie l’heure de l’objet dans le fuseau horaire local et au format interne.") ## GlideDateTime : getInternalMidnight(Nombre dayOfTheWeek) {#ariaid-title39} Renvoie un objet de date et d'heure défini sur minuit d'un jour spécifié selon UTC. {#r_GDT-getInternalMidnight_N__table_llc_mp2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jour de la semaine | Numéro | Jour de la semaine pour lequel renvoyer l'objet date/heure. | [Tableau 72. Paramètres] {#r_GDT-getInternalMidnight_N__table_llc_mp2_nt} {#r_GDT-getInternalMidnight_N__table_mlc_mp2_nt__entry__2} | Type | Description | |-|-| | GlideDateTime | Un objet GlideDateTime défini sur minuit. | [Tableau 73. Renvoie] {#r_GDT-getInternalMidnight_N__table_mlc_mp2_nt} var gdt = new GlideDateTime("2011-08-31 08:00:00"); gs.print(gdt.getInternalMidnight(2)); Sortie : 2011-08-30 00:00:01 ## GlideDateTime : getLocalDate() {#ariaid-title40} 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. {#r_GDT-getLocalDate__table_ays_hr2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 74. Paramètres] {#r_GDT-getLocalDate__table_ays_hr2_nt} {#r_GDT-getLocalDate__table_bys_hr2_nt__entry__2} | Type | Description | |-|-| | Date Glide | La date dans le fuseau horaire de l'utilisateur. | [Tableau 75. Renvoie] {#r_GDT-getLocalDate__table_bys_hr2_nt} 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 {#r_GDT-getLocalDate__section_pg3_lpr_mcb} Pour utiliser la méthode getLocalDate() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [getLocalDate().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetLocalDate "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.") ## GlideDateTime : getLocalTime() {#ariaid-title41} Obtient l'heure dans le fuseau horaire de l'utilisateur. {#r_GDT-getLocalTime__table_t11_4q2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 76. Paramètres] {#r_GDT-getLocalTime__table_t11_4q2_nt} {#r_GDT-getLocalTime__table_u11_4q2_nt__entry__2} | Type | Description | |-|-| | Heure de Glide | Heure dans le fuseau horaire de l'utilisateur. | [Tableau 77. Renvoie] {#r_GDT-getLocalTime__table_u11_4q2_nt} 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 {#r_GDT-getLocalTime__section_kqj_4pr_mcb} Pour utiliser la méthode getLocalTime() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [getLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetLocalTime "Renvoie un objet GlideTime qui représente la partie horaire de l’objet GlideDateTime dans le fuseau horaire de l’utilisateur.") ## GlideDateTime : getMonth() {#ariaid-title42} Récupère le mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire de l'ordinateur virtuel Java. Utilisez getMonthLocalTime() et getMonthUTC() à la place de cette méthode. {#r_GDT-getMonth__table_pyx_tl2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 78. Paramètres] {#r_GDT-getMonth__table_pyx_tl2_nt} {#r_GDT-getMonth__table_qyx_tl2_nt__entry__2} | Type | Description | |-|-| | Numéro | La valeur numérique du mois, janv=1, déc=12. | [Tableau 79. Renvoie] {#r_GDT-getMonth__table_qyx_tl2_nt} var gdt = new GlideDateTime(); //December gs.print(gdt.getMonth()); Sortie : 12 ## GlideDateTime : getMonthLocalTime() {#ariaid-title43} Obtient le mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire de l'utilisateur actuel. {#r_GDT-getMonthLocalTime__table_lcb_gm2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 80. Paramètres] {#r_GDT-getMonthLocalTime__table_lcb_gm2_nt} {#r_GDT-getMonthLocalTime__table_mcb_gm2_nt__entry__2} | Type | Description | |-|-| | Numéro | La valeur numérique du mois, janv=1, déc=12. | [Tableau 81. Renvoie] {#r_GDT-getMonthLocalTime__table_mcb_gm2_nt} var gdt = new GlideDateTime(); //December gs.print(gdt.getMonthLocalTime()); Sortie : 12 ### Équivalent dans le champ d'application {#r_GDT-getMonthLocalTime__section_mts_pvr_mcb} Pour utiliser la méthode getMonthLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getMonthLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetMonthLocalTime "Obtient le mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : getMonthUTC() {#ariaid-title44} Obtient le mois stocké par l'objet GlideDateTime, exprimé dans le fuseau horaire UTC. {#r_GDT-getMonthUTC__table_bsp_5m2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 82. Paramètres] {#r_GDT-getMonthUTC__table_bsp_5m2_nt} {#r_GDT-getMonthUTC__table_csp_5m2_nt__entry__2} | Type | Description | |-|-| | Numéro | La valeur numérique du mois, janv=1, déc=12. | [Tableau 83. Renvoie] {#r_GDT-getMonthUTC__table_csp_5m2_nt} var gdt = new GlideDateTime(); //December gs.print(gdt.getMonthUTC()); Sortie : 12 ### Équivalent dans le champ d'application {#r_GDT-getMonthUTC__section_dvn_svr_mcb} Pour utiliser la méthode getMonthUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getMonthUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetMonthUTC "Obtient le mois stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.") ## GlideDateTime : getNumericValue() {#ariaid-title45} Obtient le nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 GMT. {#r_GDT-getNumericValue__table_vzg_g42_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 84. Paramètres] {#r_GDT-getNumericValue__table_vzg_g42_nt} {#r_GDT-getNumericValue__table_wzg_g42_nt__entry__2} | Type | Description | |-|-| | Numéro | Nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 GMT. | [Tableau 85. Renvoie] {#r_GDT-getNumericValue__table_wzg_g42_nt} var gdt = new GlideDateTime("2011-08-31 08:00:00"); gs.print(gdt.getNumericValue()); Sortie : 1314777600000 ## GlideDateTime : getSpanTime(Number dayOfWeek) {#ariaid-title46} Récupère le temps écoulé depuis minuit d'un jour spécifié jusqu'à l'heure actuelle. {#r_GDT-getSpanTime_N__table_bqw_lf2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jourdela semaine | Numéro | Valeur du jour de la semaine comprise entre 1 et 7. 1 = Lundi, 7=Dimanche. | [Tableau 86. Paramètres] {#r_GDT-getSpanTime_N__table_bqw_lf2_nt} {#r_GDT-getSpanTime_N__table_cqw_lf2_nt__entry__2} | Type | Description | |-|-| | Heure de Glide | Temps écoulé depuis minuit du jour spécifié. Pour afficher le résultat en termes conviviaux, définissez la valeur sur GlideDuration. | [Tableau 87. Renvoie] {#r_GDT-getSpanTime_N__table_cqw_lf2_nt} 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() {#ariaid-title47} Obtient l'horodatage de durée Unix. {#r_GDT-getTime__table_lny_z42_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 88. Paramètres] {#r_GDT-getTime__table_lny_z42_nt} {#r_GDT-getTime__table_mny_z42_nt__entry__2} | Type | Description | |-|-| | Heure de Glide | Horodatage de durée Unix au format système basé sur l'heure GMT. | [Tableau 89. Renvoie] {#r_GDT-getTime__table_mny_z42_nt} 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 {#r_GDT-getTime__section_fjc_xvr_mcb} Pour utiliser la méthode getTime() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [getTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetTime "Renvoie un objet GlideTime qui représente la partie temporelle de l’objet GlideDateTime.") ## GlideDateTime : getTZOffset() {#ariaid-title48} Obtient le décalage du fuseau horaire en millisecondes. {#r_GDT-getTZOffset__table_nk4_f5l_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 90. Paramètres] {#r_GDT-getTZOffset__table_nk4_f5l_nt} {#r_GDT-getTZOffset__table_ok4_f5l_nt__entry__2} | Type | Description | |-|-| | Numéro | Nombre de millisecondes du décalage du fuseau horaire | [Tableau 91. Renvoie] {#r_GDT-getTZOffset__table_ok4_f5l_nt} var gdt = new GlideDateTime(); gdt.getLocalTime(); // PST local time gs.print(gdt.getTZOffset()); Sortie : -28800000 ### Équivalent dans le champ d'application {#r_GDT-getTZOffset__section_ihs_5vr_mcb} Pour utiliser la méthode getTZOffset() dans une application incluse dans le périmètre, utilisez la méthode correspondante délimitée : [getTZOffset().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetTZOffset "Obtient le décalage du fuseau horaire en millisecondes.") ## GlideDateTime : getUserFormattedLocalTime() {#ariaid-title49} Renvoie l'heure de l'objet dans le fuseau horaire local au format de l'utilisateur. {#r_GDT-getUserFormattedLocalTime__table_lgj_ftc_kw__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 92. Paramètres] {#r_GDT-getUserFormattedLocalTime__table_lgj_ftc_kw} {#r_GDT-getUserFormattedLocalTime__table_mgj_ftc_kw__entry__2} | Type | Description | |-|-| | Objet | L'heure de l'objet dans l'heure locale et le format de l'utilisateur. | [Tableau 93. Renvoie] {#r_GDT-getUserFormattedLocalTime__table_mgj_ftc_kw} 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 {#r_GDT-getUserFormattedLocalTime__section_hsv_f22_dbb} Pour utiliser la méthode getUserFormattedLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getUserFormattedLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_SGDT-getUserFormattedLocalTime "Renvoie l’heure de l’objet dans le fuseau horaire local et au format utilisateur.") ## GlideDateTime : getUserTimeZone() {#ariaid-title50} Récupère le fuseau horaire de la session utilisateur actuelle. Cette méthode est équivalente à `gs.getSession().getTimeZone()`. {#r_GDT-getUserTimeZone__table_eyw_b4c_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 94. Paramètres] {#r_GDT-getUserTimeZone__table_eyw_b4c_nt} {#r_GDT-getUserTimeZone__table_fyw_b4c_nt__entry__2} | Type | Description | |-|-| | Fuseau horaire | Fuseau horaire de l'utilisateur actuel. | [Tableau 95. Renvoie] {#r_GDT-getUserTimeZone__table_fyw_b4c_nt} 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) {#ariaid-title51} 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 le jour spécifié de la semaine dans la semaine de l'objet GlideDateTime d'origine. {#r_GDT-getUTCMidnight_N__table_ezg_zp2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jour de la semaine | Numéro | Le jour de la semaine, de 13h à 7h. Lundi = 1, Dimanche = 7. Ne saisissez pas 0 dans ce paramètre. | [Tableau 96. Paramètres] {#r_GDT-getUTCMidnight_N__table_ezg_zp2_nt} {#r_GDT-getUTCMidnight_N__table_fzg_zp2_nt__entry__2} | Type | Description | |-|-| | GlideDateTime | Un nouvel objet GlideDateTime, défini sur minuit. | [Tableau 97. Renvoie] {#r_GDT-getUTCMidnight_N__table_fzg_zp2_nt} 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() {#ariaid-title52} 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. {#r_GDT-getValue__table_osc_gbd_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 98. Paramètres] {#r_GDT-getValue__table_osc_gbd_nt} {#r_GDT-getValue__table_psc_gbd_nt__entry__2} | 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. | [Tableau 99. Renvoie] {#r_GDT-getValue__table_psc_gbd_nt} 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 {#r_GDT-getValue__section_kt5_zvr_mcb} Pour utiliser la méthode getValue() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [getValue().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetValue "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.") ## GlideDateTime : getWeekOfYearLocalTime() {#ariaid-title53} 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. {#r_GDT-getWeekOfYearLocalTime__table_vq5_422_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 100. Paramètres] {#r_GDT-getWeekOfYearLocalTime__table_vq5_422_nt} {#r_GDT-getWeekOfYearLocalTime__table_wq5_422_nt__entry__2} | 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 ou 53. | [Tableau 101. Renvoie] {#r_GDT-getWeekOfYearLocalTime__table_wq5_422_nt} var gdt = new GlideDateTime("2011-12-01 12:00:00"); gs.print(gdt.getWeekOfYearUTC()); Sortie : 49 ### Équivalent dans le champ d'application {#r_GDT-getWeekOfYearLocalTime__section_yh2_cwr_mcb} Pour utiliser la méthode getWeekOfYearLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getWeekOfYearLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetWeekOfYearLocalTime "Obtient le numéro de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : getWeekOfYearUTC() {#ariaid-title54} 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. {#r_GDT-getWeekOfYearUTC__table_jdh_bf2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 102. Paramètres] {#r_GDT-getWeekOfYearUTC__table_jdh_bf2_nt} {#r_GDT-getWeekOfYearUTC__table_kdh_bf2_nt__entry__2} | Type | Description | |-|-| | Numéro | Le numéro de la semaine en cours à l'heure UTC. Le nombre de semaines le plus élevé dans une année est soit 52 ou 53. | [Tableau 103. Renvoie] {#r_GDT-getWeekOfYearUTC__table_kdh_bf2_nt} var gdt = new GlideDateTime("2011-12-01 12:00:00"); gs.print(gdt.getWeekOfYearUTC()); Sortie : 49 ### Équivalent dans le champ d'application {#r_GDT-getWeekOfYearUTC__section_fpl_2wr_mcb} Pour utiliser la méthode getWeekOfYearUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getWeekOfYearUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetWeekOfYearUTC "Obtient le numéro de la semaine stocké par l’objet GlideDateTime, exprimé dans le fuseau horaire UTC.") ## GlideDateTime : getYear() {#ariaid-title55} 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. {#r_GDT-getYear__table_jhh_dn2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 104. Paramètres] {#r_GDT-getYear__table_jhh_dn2_nt} {#r_GDT-getYear__table_khh_dn2_nt__entry__2} | Type | Description | |-|-| | Numéro | La valeur à 4 chiffres de l'année dans le fuseau horaire de l'ordinateur virtuel Java. | [Tableau 105. Renvoie] {#r_GDT-getYear__table_khh_dn2_nt} var gdt = new GlideDateTime(); //2011 gs.print(gdt.getYear()); Sortie : 2011 ## GlideDateTime : getYearLocalTime() {#ariaid-title56} Obtient l'année stockée par l'objet GlideDateTime, exprimée dans le fuseau horaire de l'utilisateur actuel. {#r_GDT-getYearLocalTime__table_tzz_4n2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 106. Paramètres] {#r_GDT-getYearLocalTime__table_tzz_4n2_nt} {#r_GDT-getYearLocalTime__table_uzz_4n2_nt__entry__2} | Type | Description | |-|-| | Numéro | La valeur à 4 chiffres de l'année dans le fuseau horaire de l'utilisateur. | [Tableau 107. Renvoie] {#r_GDT-getYearLocalTime__table_uzz_4n2_nt} var gdt = new GlideDateTime(); //2011 gs.print(gdt.getYearLocalTime()); Sortie : 2011 ### Équivalent dans le champ d'application {#r_GDT-getYearLocalTime__section_dys_jwr_mcb} Pour utiliser la méthode getYearLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getYearLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetYearLocalTime "Obtient l’année stockée par l’objet GlideDateTime, exprimée dans le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : getYearUTC() {#ariaid-title57} Renvoie l'année stockée par l'objet GlideDateTime, exprimée dans le fuseau horaire UTC. {#r_GDT-getYearUTC__table_dml_xn2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 108. Paramètres] {#r_GDT-getYearUTC__table_dml_xn2_nt} {#r_GDT-getYearUTC__table_eml_xn2_nt__entry__2} | Type | Description | |-|-| | Numéro | Valeur de l'année à quatre chiffres dans le fuseau horaire UTC. | [Tableau 109. Renvoie] {#r_GDT-getYearUTC__table_eml_xn2_nt} var gdt = new GlideDateTime(); //2011 gs.info(gdt.getYearUTC()); Sortie : 2011 ### Équivalent dans le champ d'application {#r_GDT-getYearUTC__section_j4m_pwr_mcb} Pour utiliser la méthode getYearUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getYearUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeGetYearUTC "Obtient l’année stockée par l’objet GlideDateTime, exprimée dans le fuseau horaire UTC.") ## GlideDateTime : hasDate() {#ariaid-title58} Détermine si la date d'un objet est définie. {#r_GDT-hasDate__table_iqj_rnc_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 110. Paramètres] {#r_GDT-hasDate__table_iqj_rnc_nt} {#r_GDT-hasDate__table_jqj_rnc_nt__entry__2} | Type | Description | |-|-| | Booléen | Vrai si la date de l'objet est définie, faux dans les autres cas. | [Tableau 111. Renvoie] {#r_GDT-hasDate__table_jqj_rnc_nt} var gdt = new GlideDateTime("2011-08-31 08:00:00"); gs.print(gdt.hasDate()); Sortie : true ### Équivalent dans le champ d'application {#r_GDT-hasDate__section_yzp_rwr_mcb} Pour utiliser la méthode hasDate() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [hasDate().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeHasDate "Détermine si la date d’un objet est définie.") ## GlideDateTime : isDST() {#ariaid-title59} Détermine si l'heure de l'objet utilise un décalage de l'heure d'été {#r_GDT-isDST__table_ncy_jvc_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 112. Paramètres] {#r_GDT-isDST__table_ncy_jvc_nt} {#r_GDT-isDST__table_ocy_jvc_nt__entry__2} | Type | Description | |-|-| | Booléen | Vrai si l'heure est l'heure d'été, faux dans les autres cas. | [Tableau 113. Renvoie] {#r_GDT-isDST__table_ocy_jvc_nt} var gdt = new GlideDateTime("2011-08-31 00:00:00"); gs.print(gdt.isDST()); //true Sortie : true ### Équivalent dans le champ d'application {#r_GDT-isDST__section_gns_twr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeIsDST "Détermine si l’heure d’un objet utilise un décalage de l’heure d’été.") ## GlideDateTime : isValid() {#ariaid-title60} Détermine si une valeur est une date et une heure valides. {#r_GDT-isValid__table_sfh_5rl_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 114. Paramètres] {#r_GDT-isValid__table_sfh_5rl_nt} {#r_GDT-isValid__table_tfh_5rl_nt__entry__2} | Type | Description | |-|-| | Booléen | Vrai si la valeur est valide, faux dans les autres cas. | [Tableau 115. Renvoie] {#r_GDT-isValid__table_tfh_5rl_nt} 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 {#r_GDT-isValid__section_flp_vwr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeIsValid "Détermine si une valeur est une date et une heure valides.") ## GlideDateTime : setDayOfMonth(Numéro jour) {#ariaid-title61} Définit le jour du mois sur une valeur spécifiée. Utilisez setDayOfMonthLocalTime(day) et setDayOfMonthUTC(day) au lieu de cette méthode. {#r_GDT-setDayOfMonth_N__table_pp4_vh2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jour | Numéro | Jour du mois, du 1er au 31. | [Tableau 116. Paramètres] {#r_GDT-setDayOfMonth_N__table_pp4_vh2_nt} {#r_GDT-setDayOfMonth_N__table_qp4_vh2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 117. Renvoie] {#r_GDT-setDayOfMonth_N__table_qp4_vh2_nt} var gdt = new GlideDateTime(); gdt.setDayOfMonth(9); gs.print(gdt.getDayOfMonth()); Sortie : 9 ## GlideDateTime : setDayOfMonthLocalTime(numéro de jour) {#ariaid-title62} Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire de l'utilisateur actuel. {#r_GDT-setDayOfMonthLocalTime_N__table_bvc_1j2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jour | Numéro | Le jour du mois auquel passer de 1 à 31. Si cette valeur est supérieure au nombre maximal de jours du mois, elle est définie sur le dernier jour du mois. | [Tableau 118. Paramètres] {#r_GDT-setDayOfMonthLocalTime_N__table_bvc_1j2_nt} {#r_GDT-setDayOfMonthLocalTime_N__table_cvc_1j2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 119. Renvoie] {#r_GDT-setDayOfMonthLocalTime_N__table_cvc_1j2_nt} var gdt = new GlideDateTime(); gdt.setDayOfMonthLocalTime(9); gs.print(gdt.getDayOfMonthLocalTime()); Sortie : 9 ### Équivalent dans le champ d'application {#r_GDT-setDayOfMonthLocalTime_N__section_p4c_ywr_mcb} Pour utiliser la méthode setDayOfMonthLocalTime() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [setDayOfMonthLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day "Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : setDayOfMonthUTC(Nombre de jours) {#ariaid-title63} Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire UTC. {#r_GDT-setDayOfMonthUTC_N__table_mmk_mj2_nt__entry__3} | Nom | Type | Description | |-|-|-| | jour | Numéro | Le jour du mois auquel passer de 1 à 31. Si cette valeur est supérieure au nombre maximal de jours du mois, elle est définie sur le dernier jour du mois. | [Tableau 120. Paramètres] {#r_GDT-setDayOfMonthUTC_N__table_mmk_mj2_nt} {#r_GDT-setDayOfMonthUTC_N__table_nmk_mj2_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 121. Renvoie] {#r_GDT-setDayOfMonthUTC_N__table_nmk_mj2_nt} var gdt = new GlideDateTime(); gdt.setDayOfMonthUTC(9); gs.print(gdt.getDayOfMonthUTC()); Sortie : 9 ### Équivalent dans le champ d'application {#r_GDT-setDayOfMonthUTC_N__section_rxh_1xr_mcb} Pour utiliser la méthode setDayOfMonthUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [setDayOfMonthUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day "Définit le jour du mois sur une valeur spécifiée dans le fuseau horaire UTC.") ## GlideDateTime : setDisplayValue(String asDisplayed) {#ariaid-title64} Définit une valeur de date et d'heure en utilisant le format d'affichage et le fuseau horaire de l'utilisateur actuel. {#r_GDT-setDisplayValue_S__table_jnc_fwc_nt__entry__3} | 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 `.setDisplayValue(gs.nowDateTime) ;`. | [Tableau 122. Paramètres] {#r_GDT-setDisplayValue_S__table_jnc_fwc_nt} {#r_GDT-setDisplayValue_S__table_knc_fwc_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 123. Renvoie] {#r_GDT-setDisplayValue_S__table_knc_fwc_nt} 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 {#r_GDT-setDisplayValue_S__section_wyq_2xr_mcb} Pour utiliser la méthode setDisplayValue() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [setDisplayValue().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed "Définit une valeur de date et d’heure en utilisant le format d’affichage et le fuseau horaire de l’utilisateur actuel.") ## GlideDateTime - setDisplayValue(String dateTime, format de chaîne) {#ariaid-title65} Définit une valeur de date et d'heure en utilisant le fuseau horaire de l'utilisateur actuel et le format de date et d'heure spécifiés. 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 format. Vous pouvez récupérer le message d'erreur en appelant getErrorMsg() sur l'objet GlideDateTime une fois l'exception interceptée. {#r_GDT-setDisplayValue_S_S__table_dqz_pzc_nt__entry__3} | 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. | [Tableau 124. Paramètres] {#r_GDT-setDisplayValue_S_S__table_dqz_pzc_nt} {#r_GDT-setDisplayValue_S_S__table_eqz_pzc_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 125. Renvoie] {#r_GDT-setDisplayValue_S_S__table_eqz_pzc_nt} 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 {#r_GDT-setDisplayValue_S_S__section_zns_gxr_mcb} Pour utiliser la méthode setDisplayValue() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [setDisplayValue().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format "Définit une valeur de date et d’heure en utilisant le fuseau horaire de l’utilisateur actuel et le format de date et d’heure spécifiés.") ## GlideDateTime : setDisplayValueInternal(String dateTime) {#ariaid-title66} 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. {#r_GDT-setDisplayValueInternal_S__table_zrg_5wc_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | Chaîne | La date et l'heure au format interne | [Tableau 126. Paramètres] {#r_GDT-setDisplayValueInternal_S__table_zrg_5wc_nt} {#r_GDT-setDisplayValueInternal_S__table_asg_5wc_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 127. Renvoie] {#r_GDT-setDisplayValueInternal_S__table_asg_5wc_nt} 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 {#r_GDT-setDisplayValueInternal_S__section_hrc_cxr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value "Définit une valeur de date et d’heure à l’aide du format interne (aaaa-MM-jj, HH :mm :ss) et du fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : setDisplayValueInternalWithAlternates(String dateTime) {#ariaid-title67} 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. {#r_GDT-setDispValInternalAlt_S__table_ipl_dzc_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | Chaîne | La date et l'heure au format interne. | [Tableau 128. Paramètres] {#r_GDT-setDispValInternalAlt_S__table_ipl_dzc_nt} {#r_GDT-setDispValInternalAlt_S__table_jpl_dzc_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 129. Renvoie] {#r_GDT-setDispValInternalAlt_S__table_jpl_dzc_nt} ## GlideDateTime : setDisplayValueLang(String dateTime, String style) {#ariaid-title68} 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. {#r_GDT-setDisplayValueLang_S_S__id_jjl_xvw_dwb__entry__3} | 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 date et heure sortie de la fonction getDisplayValueLang(). Par exemple, en utilisant 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 \ en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \ en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/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 130. Paramètres] {#r_GDT-setDisplayValueLang_S_S__id_jjl_xvw_dwb} {#r_GDT-setDisplayValueLang_S_S__id_e41_yvw_dwb__entry__2} | Type | Description | |-|-| | Nul | | [Tableau 131. Renvoie] {#r_GDT-setDisplayValueLang_S_S__id_e41_yvw_dwb} L'exemple suivant renvoie la date et l'heure dans les styles bref 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(String dateTime, String style, String language) {#ariaid-title69} 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. {#r_GDT-setDisplayValueLang_S_S_S__id_zks_2ww_dwb__entry__3} | 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 date et heure sortie de la fonction getDisplayValueLang(). Par exemple, en utilisant 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 \ en fonction des paramètres régionaux de l'utilisateur (par exemple, lundi 24 octobre 2022). * long : renvoie la date au format \ en fonction des paramètres régionaux de l'utilisateur (par exemple, 24 octobre 2022). * moyen : similaire à long mais renvoie la date avec un mois abrégé (par exemple, 24 octobre 2022). * court : renvoie la date au format MM/DD/YY ou DD/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. | | 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](https://appmakers.dev/bcp-47-language-codes-list/). | [Tableau 132. Paramètres] {#r_GDT-setDisplayValueLang_S_S_S__id_zks_2ww_dwb} {#r_GDT-setDisplayValueLang_S_S_S__id_rg3_fww_dwb__entry__2} | Type | Description | |-|-| | Nul | | [Tableau 133. Renvoie] {#r_GDT-setDisplayValueLang_S_S_S__id_rg3_fww_dwb} 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) {#ariaid-title70} 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. {#r_GDT-setGlideDateTime_GDT__table_xdg_y5c_nt__entry__3} | Nom | Type | Description | |-|-|-| | gDT | GlideDateTime | Un objet GlideDateTime | [Tableau 134. Paramètres] {#r_GDT-setGlideDateTime_GDT__table_xdg_y5c_nt} {#r_GDT-setGlideDateTime_GDT__table_ydg_y5c_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 135. Renvoie] {#r_GDT-setGlideDateTime_GDT__table_ydg_y5c_nt} 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 {#r_GDT-setGlideDateTime_GDT__section_fjw_3xr_mcb} Pour utiliser la méthode setGlideDateTime() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [setGlideDateTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetGlideDateTime_g "Définit la date et l’heure de l’objet actuel à l’aide d’un objet GlideDateTime existant. Cette méthode est équivalente à l’instanciation d’un nouvel objet avec un paramètre GlideDateTime.") ## GlideDateTime : setInitialValue(String dateTime) {#ariaid-title71} Définit la date et l'heure. Cette méthode est équivalente à setValue(Object). {#r_GDT-setInitialValue_S__table_i42_r5l_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | 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 136. Paramètres] {#r_GDT-setInitialValue_S__table_i42_r5l_nt} {#r_GDT-setInitialValue_S__table_j42_r5l_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 137. Renvoie] {#r_GDT-setInitialValue_S__table_j42_r5l_nt} 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(Numéro mois) {#ariaid-title72} 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. {#r_GDT-setMonth_N__table_djd_3wl_nt__entry__3} | Nom | Type | Description | |-|-|-| | mois | Numéro | Mois auquel passer à. | [Tableau 138. Paramètres] {#r_GDT-setMonth_N__table_djd_3wl_nt} {#r_GDT-setMonth_N__table_ejd_3wl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 139. Renvoie] {#r_GDT-setMonth_N__table_ejd_3wl_nt} var gdt = new GlideDateTime(); gdt.setMonth(1); gs.print(gdt.getMonth()); Sortie : 1 ## GlideDateTime : setMonthLocalTime(Numéro mois) {#ariaid-title73} Définit le mois stocké par l'objet GlideDateTime sur une valeur spécifiée à l'aide du fuseau horaire de l'utilisateur actuel. {#r_GDT-setMonthLocalTime_N__table_xgm_wwl_nt__entry__3} | Nom | Type | Description | |-|-|-| | mois | Numéro | Mois auquel passer à. | [Tableau 140. Paramètres] {#r_GDT-setMonthLocalTime_N__table_xgm_wwl_nt} {#r_GDT-setMonthLocalTime_N__table_ygm_wwl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 141. Renvoie] {#r_GDT-setMonthLocalTime_N__table_ygm_wwl_nt} var gdt = new GlideDateTime(); gdt.setMonthLocalTime(1); gs.print(gdt.getMonthLocalTime()); Sortie : 1 ### Équivalent dans le champ d'application {#r_GDT-setMonthLocalTime_N__section_rqq_lxr_mcb} Pour utiliser la méthode setMonthLocalTime() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [setMonthLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetMonthLocalTime_Number "Définit le mois stocké par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : setMonthUTC(Numéro mois) {#ariaid-title74} Définit le mois stocké par l'objet GlideDateTime sur une valeur spécifiée utilisant le fuseau horaire UTC. {#r_GDT-setMonthUTC_N__table_gt5_fxl_nt__entry__3} | Nom | Type | Description | |-|-|-| | mois | Numéro | Mois auquel passer à. | [Tableau 142. Paramètres] {#r_GDT-setMonthUTC_N__table_gt5_fxl_nt} {#r_GDT-setMonthUTC_N__table_ht5_fxl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 143. Renvoie] {#r_GDT-setMonthUTC_N__table_ht5_fxl_nt} var gdt = new GlideDateTime(); gdt.setMonthUTC(1); gs.print(gdt.getMonthUTC()); Sortie : 1 ### Équivalent dans le champ d'application {#r_GDT-setMonthUTC_N__section_xyx_nxr_mcb} Pour utiliser la méthode setMonthUTC() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [setMonthUTC().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetMonthUTC_Number "Définit le mois stocké par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire UTC.") ## GlideDateTime : setNumericValue(Nombre de millisecondes) {#ariaid-title75} Définit la date et l'heure au nombre de millisecondes écoulées depuis le 1er janvier 1970 00:00:00 GMT. {#r_GDT-setNumericValue_N__table_jsf_q42_nt__entry__3} | Nom | Type | Description | |-|-|-| | millisecondes | Numéro | Nombre de millisecondes | [Tableau 144. Paramètres] {#r_GDT-setNumericValue_N__table_jsf_q42_nt} {#r_GDT-setNumericValue_N__table_ksf_q42_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 145. Renvoie] {#r_GDT-setNumericValue_N__table_ksf_q42_nt} var gdt = new GlideDateTime(); gdt.setNumericValue(1314777600000); gs.print(gdt.getValue()); Sortie : 2011-08-31 08:00:00 ## GlideDateTime : setTZ (fuseau horaire, fuseau horaire) {#ariaid-title76} Définit le fuseau horaire de l'objet GlideDateTime comme étant le fuseau horaire spécifié. {#r_GDT-setTZ_TZ__table_uy3_54c_nt__entry__3} | Nom | Type | Description | |-|-|-| | Fuseau horaire | Fuseau horaire | Un objet de fuseau horaire | [Tableau 146. Paramètres] {#r_GDT-setTZ_TZ__table_uy3_54c_nt} {#r_GDT-setTZ_TZ__table_vy3_54c_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 147. Renvoie] {#r_GDT-setTZ_TZ__table_vy3_54c_nt} var tz = gs.getSession().getTimeZone(); var gdt = new GlideDateTime(); gdt.setTZ(tz); ## GlideDateTime : setValue(Object dateTime) {#ariaid-title77} Définit la date et l'heure de l'objet GlideDateTime. Cette méthode est équivalente à setInitialValue(). {#r_GDT-setValue_O__table_yfh_fpc_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | Objet | Date et heure d'utilisation. Il peut s'agir d'un paramètre de type. * Une chaîne dans le fuseau horaire UTC et au format interne aaaa-MM-jj HH :mm :ss : définit la valeur de l'objet à la date et à l'heure spécifiées. L'utilisation de cette méthode équivaut à instancier 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 conduire à des données inexactes en raison de l'ambiguïté des valeurs du jour et du mois. Si vous utilisez un format de date et d'heure non standard, utilisez plutôt setValueUTC(dateTime, format). * Un objet GlideDateTime : définit la valeur de l'objet sur la date et l'heure stockées par le GlideDateTime passé dans le paramètre. L'utilisation de cette méthode équivaut à instancier 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 cette méthode équivaut à transmettre la valeur retournée par l'objet Java Date getTime() à la méthode GlideDateTime setNumericValue(). Cette méthode n'accepte pas les objets Date JavaScript. * Un nombre JavaScript : définit la valeur de l'objet à l'aide de la valeur numérique 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 entière ou longue en millisecondes après le 1er janvier 1970 00:00:00 UTC. L'utilisation de cette méthode équivaut à la méthode setNumericValue(milliseconds). {#r_GDT-setValue_O__ul_j3h_4pc_nt} | [Tableau 148. Paramètres] {#r_GDT-setValue_O__table_yfh_fpc_nt} {#r_GDT-setValue_O__table_zfh_fpc_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 149. Renvoie] {#r_GDT-setValue_O__table_zfh_fpc_nt} 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 {#r_GDT-setValue_O__section_w2m_sxr_mcb} Pour utiliser la méthode setValue() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [setValue().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetValue_String_o "Définit la date et l’heure de l’objet GlideDateTime.") ## GlideDateTime - setValueUTC(String dateTime, format de chaîne) {#ariaid-title78} 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és. 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 format. Vous pouvez récupérer le message d'erreur en appelant getErrorMsg() sur l'objet GlideDateTime une fois l'exception interceptée. {#r_GDT-setValueUTC_S_S__table_p5w_35c_nt__entry__3} | Nom | Type | Description | |-|-|-| | DateHeure | Chaîne | Date et heure d'utilisation. | | format | Chaîne | Format à utiliser. | [Tableau 150. Paramètres] {#r_GDT-setValueUTC_S_S__table_p5w_35c_nt} {#r_GDT-setValueUTC_S_S__table_q5w_35c_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 151. Renvoie] {#r_GDT-setValueUTC_S_S__table_q5w_35c_nt} 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 {#r_GDT-setValueUTC_S_S__section_ft1_qxr_mcb} 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().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format "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és. Cette méthode lève une exception d’exécution si le format de date et d’heure utilisé dans le dt paramètre ne correspond pas au format paramètre. Vous pouvez récupérer le message d’erreur en appelant getErrorMsg() sur l’objet GlideDateTime une fois l’exception interceptée.") ## GlideDateTime : setYear(Number year) {#ariaid-title79} 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() à la place de cette méthode. {#r_GDT-setYear_N__table_tgf_4xl_nt__entry__3} | Nom | Type | Description | |-|-|-| | année | Numéro | Année à laquelle passer à. | [Tableau 152. Paramètres] {#r_GDT-setYear_N__table_tgf_4xl_nt} {#r_GDT-setYear_N__table_ugf_4xl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 153. Renvoie] {#r_GDT-setYear_N__table_ugf_4xl_nt} var gdt = new GlideDateTime(); gdt.setYear(2013); gs.print(gdt.getYear()); Sortie : 2013 ## GlideDateTime : setYearLocalTime(Numéro d'année) {#ariaid-title80} 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. {#r_GDT-setYearLocalTime_N__table_vp4_1yl_nt__entry__3} | Nom | Type | Description | |-|-|-| | année | Numéro | Année à laquelle passer à. | [Tableau 154. Paramètres] {#r_GDT-setYearLocalTime_N__table_vp4_1yl_nt} {#r_GDT-setYearLocalTime_N__table_wp4_1yl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 155. Renvoie] {#r_GDT-setYearLocalTime_N__table_wp4_1yl_nt} var gdt = new GlideDateTime(); gdt.setYearLocalTime(2013); gs.print(gdt.getYearLocalTime()); Sortie : 2013 ### Équivalent dans le champ d'application {#r_GDT-setYearLocalTime_N__section_mjw_5xr_mcb} Pour utiliser la méthode setYearLocalTime() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [setYearLocalTime().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetYearLocalTime_Number "Définit l’année stockée par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire de l’utilisateur actuel.") ## GlideDateTime : setYearUTC(Numéro d'année) {#ariaid-title81} Définit l'année stockée par l'objet GlideDateTime sur une valeur spécifiée utilisant le fuseau horaire UTC. {#r_GDT-setYearUTC_N__table_fzh_jyl_nt__entry__3} | Nom | Type | Description | |-|-|-| | année | Numéro | Année à laquelle passer à. | [Tableau 156. Paramètres] {#r_GDT-setYearUTC_N__table_fzh_jyl_nt} {#r_GDT-setYearUTC_N__table_gzh_jyl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 157. Renvoie] {#r_GDT-setYearUTC_N__table_gzh_jyl_nt} var gdt = new GlideDateTime(); gdt.setYearUTC(2013); gs.print(gdt.getYearUTC()); Sortie : 2013 ### Équivalent dans le champ d'application {#r_GDT-setYearUTC_N__section_q3v_wxr_mcb} 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()](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSetYearUTC_Number "Définit l’année stockée par l’objet GlideDateTime sur la valeur spécifiée à l’aide du fuseau horaire UTC."). ## GlideDateTime - soustraire(heure GlideTime) {#ariaid-title82} Soustrait une durée spécifiée. {#r_GDT-subtract_GT__table_lsb_nzk_nt__entry__3} | Nom | Type | Description | |-|-|-| | Diagramme des séries chronologiques | Heure de Glide | Le temps à soustraire | [Tableau 158. Paramètres] {#r_GDT-subtract_GT__table_lsb_nzk_nt} {#r_GDT-subtract_GT__table_msb_nzk_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 159. Renvoie] {#r_GDT-subtract_GT__table_msb_nzk_nt} 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 {#r_GDT-subtract_GT__section_ltp_byr_mcb} Pour utiliser la méthode subtract() dans une application incluse dans le champ d'application, utilisez la méthode correspondante dans le champ d'application : [subtract().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSubtract_GlideTime "Soustrait une durée spécifiée de l’objet GlideDateTime actuel.") ## GlideDateTime - soustraire(Nombre de millisecondes) {#ariaid-title83} Soustrait un nombre spécifié de millisecondes de l'objet GlideDateTime. {#r_GDT-subtract_N__table_r54_mtl_nt__entry__3} | Nom | Type | Description | |-|-|-| | millisecondes | Numéro | Nombre de millisecondes à soustraire | [Tableau 160. Paramètres] {#r_GDT-subtract_N__table_r54_mtl_nt} {#r_GDT-subtract_N__table_s54_mtl_nt__entry__2} | Type | Description | |-|-| | nul | | [Tableau 161. Renvoie] {#r_GDT-subtract_N__table_s54_mtl_nt} 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 {#r_GDT-subtract_N__section_ihx_qyr_mcb} Pour utiliser la méthode subtract() dans une application incluse dans le champ d'application, utilisez la méthode correspondante dans le champ d'application : [subtract().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSubtract_Number "Soustrait le nombre spécifié de millisecondes de l’objet GlideDateTime.") ## GlideDateTime - soustraire (début GlideDateTime, fin GlideDateTime) {#ariaid-title84} Renvoie la différence de durée entre deux objets GlideDateTime spécifiés. {#r_GDT-subtract_GDT_GDT__table_gn2_grl_nt__entry__3} | Nom | Type | Description | |-|-|-| | début | GlideDateTime | Objet de date de début. | | fin | GlideDateTime | Objet de date de fin. | [Tableau 162. Paramètres] {#r_GDT-subtract_GDT_GDT__table_gn2_grl_nt} {#r_GDT-subtract_GDT_GDT__table_hn2_grl_nt__entry__2} | Type | Description | |-|-| | GlideDuration (en anglais seulement) | Différence de durée entre les deux dates spécifiées. | [Tableau 163. Renvoie] {#r_GDT-subtract_GDT_GDT__table_hn2_grl_nt} 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 {#r_GDT-subtract_GDT_GDT__section_apm_zxr_mcb} Pour utiliser la méthode subtract() dans une application incluse dans le champ d'application, utilisez la méthode correspondante dans le champ d'application : [subtract().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time "Renvoie la différence de durée entre deux objets GlideDateTime spécifiés.") ## GlideDateTime - toString() {#ariaid-title85} 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(). {#r_GDT-toString__table_lyw_ls2_nt__entry__3} | Nom | Type | Description | |-|-|-| | Aucun | | | [Tableau 164. Paramètres] {#r_GDT-toString__table_lyw_ls2_nt} {#r_GDT-toString__table_myw_ls2_nt__entry__2} | Type | Description | |-|-| | Objet | La date et l'heure stockées par l'objet GlideDateTime dans le fuseau horaire et au format du système. | [Tableau 165. Renvoie] {#r_GDT-toString__table_myw_ls2_nt} 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 {#r_GDT-toString__section_fxf_tyr_mcb} Pour utiliser la méthode toString() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [toString().](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#r_ScopedGlideDateTimeToString "Obtient la valeur de date et d’heure stockée par l’objet GlideDateTime au format interne, aaaa-MM-jj HH :mm :ss, et le fuseau horaire du système, UTC par défaut. Cette méthode est équivalente à getValue().")