---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDateTime - Global

# GlideDateTime - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 38 min. de leitura

A classe GlideDateTime fornece métodos para executar operações em objetos GlideDateTime.

Use os métodos GlideDateTime para executar operações de data e hora, como instanciar um objeto GlideDateTime, executar cálculos de data e hora, formatar uma data e hora ou converter entre formatos de data e hora.

Para obter orientação sobre cadeias de caracteres de entrada de data e hora com uma lista de conflitos de formato comuns, consulte [Diretrizes de formato de data e hora](https://servicenow-prod.fluidtopics.net/t5OHiOi5A1ubcXB2EjjxWw#date-and-time-format-guidelines "Você pode especificar um formato de data com uma sequência de cadeias de caracteres de padrão de data e hora específicas. Uma cadeia de caracteres padrão consiste em uma ou mais letras maiúsculas e minúsculas de A a Z. Qualquer texto entre aspas é ignorado e, em vez disso, é copiado na saída de data.").

## GlideDateTime --- GlideDateTime() {#ariaid-title2}

Instancia um novo objeto GlideDateTime com a data e hora atuais.
{#r_GDT-GlideDateTime__table_qpq_slc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum(a) |   |   |
[Tabela 1. Parâmetros]

{#r_GDT-GlideDateTime__table_qpq_slc_nt}  
Este exemplo instancia um objeto GlideDateTime.

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

Saída:

    2022-08-08 16:51:44

## GlideDateTime --- GlideDateTime(cadeia de caracteres data/hora) {#ariaid-title3}

Instancia um novo objeto GlideDateTime usando o valor de data e hora passado.
O sistema tenta corresponder o valor passado com o formato do sistema interno especificado. Se o argumento não corresponder ao formato do sistema, o sistema tentará combiná-lo com um dos seguintes formatos, nesta ordem:

* aaaa-MM-dd HH:mm:ss
* MM/dd/aaaa HH:mm:ss
* MM-dd-aaaa HH:mm:ss
* MM-dd-aaaa HH:mm
* MM-dd-aaaa
* MM/dd/aaaa
* dd-MM-aaaa HH:mm:ss
* dd-MM-aaaa HH.mm.ss
* dd-MM-aaaa HH.mm
* dd-MM-aa HH.mm.ss
* dd/MM/aaaa
* dd-MM-aaaa
* aaaa-MM-dd HH:mm
* aaaa-MM-dd
* dd.MM.aaaa HH:mm:ss
* dd.MM.aaaa HH.mm.ss
* dd.MM.aaaa hh:mm:ss a
* dd.MM.yyyy hh.mm.ss a
* dd.MM.aaaa

{#r_GDT-GlideDateTime_S__ul_xgq_hmz_lnb}  
Nota:  
O seguinte formato não é compatível:

* aaaa-MM-dd'T'HH:mm:ss.SSSZ
{#r_GDT-GlideDateTime_S__ul_udg_d5w_lcc}
{#r_GDT-GlideDateTime_S__table_ufk_jmc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | Data e hora UTC a serem definidas no objeto GlideDateTime. |
[Tabela 2. Parâmetros]

{#r_GDT-GlideDateTime_S__table_ufk_jmc_nt}  

    var gdt = new GlideDateTime("2023-01-01 12:00:00");
    gs.info(gdt);

Saída:

    2023-01-01 12:00:00

## GlideDateTime --- GlideDateTime (GlideDateTime gdt) {#ariaid-title4}

Instancia um novo objeto GlideDateTime definido com a hora de um objeto GlideDateTime especificado.
{#r_GDT-GlideDateTime_GDT__table_jqw_cnc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gdt | GlideDateTime | Objeto usado para definir a hora do novo objeto. |
[Tabela 3. Parâmetros]

{#r_GDT-GlideDateTime_GDT__table_jqw_cnc_nt}  
Este exemplo cria uma instância de um objeto GlideDateTime usando o formato `aaaa-MM-dd'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);

Saída:

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

## GlideDateTime -- add(Número milissegundos) {#ariaid-title5}

Adiciona um número especificado de milissegundos ao objeto GlideDateTime.
{#r_GDT-add_N__table_x2g_nsl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| milissegundos | Número | O número de milissegundos a serem adicionados |
[Tabela 4. Parâmetros]

{#r_GDT-add_N__table_x2g_nsl_nt} {#r_GDT-add_N__table_y2g_nsl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 5. Retorna]

{#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());

Saída:

    1314777600000
    1314777600010

### Equivalente com escopo {#r_GDT-add_N__section_bqp_jnr_mcb}

Para usar o método add() em uma aplicação com escopo, use o método com escopo correspondente: [add()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAdd_Number "Adiciona o número especificado de milissegundos ao objeto GlideDateTime atual.").

## GlideDateTime -- add(Tempo de GlideTime) {#ariaid-title6}

Adiciona um objeto GlideTime ao objeto GlideDateTime atual.
{#r_GDT-add_GT__table_e4r_xs2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| hora | [GlideTime](https://servicenow-prod.fluidtopics.net/eT_lP8RxGmDu09oPsOxNPQ#c_GlideTimeScopedAPI "A API GlideTime fornece métodos para executar operações em objetos GlideTime, como instanciar objetos GlideTime ou trabalhar com campos GlideTime.") | Objeto GlideTime cujo valor de tempo será adicionado ao objeto GlideDateTime especificado. |
[Tabela 6. Parâmetros]

{#r_GDT-add_GT__table_e4r_xs2_nt} {#r_GDT-add_GT__table_f4r_xs2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 7. Retorna]

{#r_GDT-add_GT__table_f4r_xs2_nt}  
Este exemplo mostra como adicionar 20 segundos ao tempo definido no objeto GlideDateTime do GDT.

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

Saída:

    2011-08-31 08:00:20

### Equivalente com escopo {#r_GDT-add_GT__section_prv_gnr_mcb}

Para usar o método add() em uma aplicação com escopo, use o método com escopo correspondente: [add()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAdd_GlideTime_gd "Adiciona um objeto GlideTime ao objeto GlideDateTime atual.").

## GlideDateTime -- addDays(Número de dias) {#ariaid-title7}

Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias.
Use addDaysLocalTime() e addDaysUTC() em vez deste método.
{#r_GDT-addDays_N__table_h1q_3t2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dias | Número | O número de dias a serem adicionados. Use um número negativo para subtrair. |
[Tabela 8. Parâmetros]

{#r_GDT-addDays_N__table_h1q_3t2_nt} {#r_GDT-addDays_N__table_i1q_3t2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 9. Retorna]

{#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());

Saída:

    2011-08-30

## GlideDateTime -- addDaysLocalTime(Número de dias) {#ariaid-title8}

Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias.
O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora locais.
{#r_GDT-addDaysLocalTime_N__table_ll1_xt2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dias | Número | O número de dias a serem adicionados. Use um valor negativo para subtrair. |
[Tabela 10. Parâmetros]

{#r_GDT-addDaysLocalTime_N__table_ll1_xt2_nt} {#r_GDT-addDaysLocalTime_N__table_ml1_xt2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 11. Retorna]

{#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());

Saída:

    2011-08-30

### Equivalente com escopo {#r_GDT-addDaysLocalTime_N__section_hnw_5lr_mcb}

Para usar o método addDaysLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [addDaysLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddDaysLocalTime_Number "Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora locais.").

## GlideDateTime -- addDaysUTC(Número de dias) {#ariaid-title9}

Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias.
O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora UTC.
{#r_GDT-addDaysUTC_N__table_vyt_k52_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dias | Número | O número de dias a serem adicionados. Use um valor negativo para subtrair. |
[Tabela 12. Parâmetros]

{#r_GDT-addDaysUTC_N__table_vyt_k52_nt} {#r_GDT-addDaysUTC_N__table_wyt_k52_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 13. Retorna]

{#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());

Saída:

    2011-08-30

### Equivalente com escopo {#r_GDT-addDaysUTC_N__section_ljh_ylr_mcb}

Para usar o método addDaysUTC() em uma aplicação com escopo, use o método com escopo correspondente: [addDaysUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddDaysUTC_Number "Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias. O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora UTC.").

## GlideDateTime -- addSeconds(Número de segundos) {#ariaid-title10}

Adiciona um número especificado de segundos ao objeto GlideDateTime.
{#r_GDT-addSeconds_N__table_xlx_zsl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| segundos | Número | O número de segundos a serem adicionados |
[Tabela 14. Parâmetros]

{#r_GDT-addSeconds_N__table_xlx_zsl_nt} {#r_GDT-addSeconds_N__table_ylx_zsl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 15. Retorna]

{#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());

Saída:

    2011-12-07 08:16:40

### Equivalente com escopo {#r_GDT-addSeconds_N__section_mnz_gmr_mcb}

Para usar o método addSeconds() em uma aplicação com escopo, use o método com escopo correspondente: [addSeconds()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddSeconds_Number "Adiciona o número especificado de segundos ao objeto GlideDateTime atual.").

## GlideDateTime -- addWeeks(Número de semanas) {#ariaid-title11}

Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas.
Use addWeeksLocalTime() e addWeeksUTC() em vez deste método.
{#r_GDT-addWeeks_N__table_bpk_v52_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Semanas | Número | O número de semanas a serem adicionadas. Use um número negativo para subtrair. |
[Tabela 16. Parâmetros]

{#r_GDT-addWeeks_N__table_bpk_v52_nt} {#r_GDT-addWeeks_N__table_cpk_v52_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 17. Retorna]

{#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());

Saída:

    2011-08-24

## GlideDateTime -- addWeeksLocalTime(Número de semanas) {#ariaid-title12}

Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas.
O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e adiciona ou subtrai semanas usando os valores de data e hora locais.
{#r_GDT-addWeeksLocalTime_N__table_ozv_3v2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Semanas | Número | O número de semanas a serem adicionadas. Use um número negativo para subtrair. |
[Tabela 18. Parâmetros]

{#r_GDT-addWeeksLocalTime_N__table_ozv_3v2_nt} {#r_GDT-addWeeksLocalTime_N__table_pzv_3v2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 19. Retorna]

{#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());

Saída:

    2011-08-24

### Equivalente com escopo {#r_GDT-addWeeksLocalTime_N__section_uq1_wmr_mcb}

Para usar o método addWeeksLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [addWeeksLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddWeeksLocalTime_Number "Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e adiciona ou subtrai semanas usando os valores de data e hora locais.").

## GlideDateTime -- addWeeksUTC(Número de semanas) {#ariaid-title13}

Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas.
O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e adiciona ou subtrai semanas usando os valores de data e hora UTC.
{#r_GDT-addWeeksUTC_N__table_rdr_5v2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Semanas | Número | O número de semanas a serem adicionadas. Use um número negativo para subtrair. |
[Tabela 20. Parâmetros]

{#r_GDT-addWeeksUTC_N__table_rdr_5v2_nt} {#r_GDT-addWeeksUTC_N__table_sdr_5v2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 21. Retorna]

{#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());

Saída:

    2011-08-24

### Equivalente com escopo {#r_GDT-addWeeksUTC_N__section_pnm_ymr_mcb}

Para usar o método addWeeksUTC() em uma aplicação com escopo, use o método com escopo correspondente: [addWeeksUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddWeeksUTC_Number "Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas. O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e adiciona ou subtrai semanas usando os valores de data e hora UTC.").

## GlideDateTime -- addMonths(Número de meses) {#ariaid-title14}

Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses.
Use addMonthsLocalTime() ou addMonthsUTC() em vez deste método.
{#r_GDT-addMonths_N__table_tgm_bkk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| meses | Número | O número de meses a serem adicionados. Use um número negativo para subtrair. |
[Tabela 22. Parâmetros]

{#r_GDT-addMonths_N__table_tgm_bkk_nt} {#r_GDT-addMonths_N__table_ugm_bkk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 23. Retorna]

{#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());

Saída:

    2011-10-31

## GlideDateTime -- addMonthsLocalTime(Número de meses) {#ariaid-title15}

Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses.
O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora locais.
{#r_GDT-addMonthsLocalTime_N__table_fmn_pkk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| meses | Número | O número de meses a serem adicionados. Use um valor negativo para subtrair. |
[Tabela 24. Parâmetros]

{#r_GDT-addMonthsLocalTime_N__table_fmn_pkk_nt} {#r_GDT-addMonthsLocalTime_N__table_gmn_pkk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 25. Retorna]

{#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());

Saída:

    2011-10-31

### Equivalente com escopo {#r_GDT-addMonthsLocalTime_N__section_xvc_bmr_mcb}

Para usar o método addMonthsLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [addMonthsLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddMonthsLocalTime_Number "Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora locais.").

## GlideDateTime -- addMonthsUTC(Número de meses) {#ariaid-title16}

Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses.
O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora UTC.
{#r_GDT-addMonthsUTC_N__table_lqp_1lk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| meses | Número | O número de meses a serem adicionados. Use um número negativo para subtrair. |
[Tabela 26. Parâmetros]

{#r_GDT-addMonthsUTC_N__table_lqp_1lk_nt} {#r_GDT-addMonthsUTC_N__table_mqp_1lk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 27. Retorna]

{#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());

Saída:

    2011-10-31

### Equivalente com escopo {#r_GDT-addMonthsUTC_N__section_gxn_2mr_mcb}

Para usar o método addMonthsUTC() em uma aplicação com escopo, use o método com escopo correspondente: [addMonthsUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddMonthsUTC_Number "Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses. O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora UTC.").

## GlideDateTime -- addYears(Número de anos) {#ariaid-title17}

Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos.
Use addYearsLocalTime() ou addYearsUTC() em vez deste método.
{#r_GDT-addYears_N__table_fpz_mlk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| anos | Número | O número de anos a serem adicionados. Use um valor negativo para subtrair. |
[Tabela 28. Parâmetros]

{#r_GDT-addYears_N__table_fpz_mlk_nt} {#r_GDT-addYears_N__table_gpz_mlk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 29. Retorna]

{#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());

Saída:

    2011-08-31

## GlideDateTime -- addYearsLocalTime(Número de anos) {#ariaid-title18}

Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos.
O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai anos usando os valores de data e hora locais.
{#r_GDT-addYearsLocalTime_N__table_llj_ryk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| anos | Número | O número de anos a serem adicionados. Para subtrair, use um valor negativo. |
[Tabela 30. Parâmetros]

{#r_GDT-addYearsLocalTime_N__table_llj_ryk_nt} {#r_GDT-addYearsLocalTime_N__table_mlj_ryk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 31. Retorna]

{#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());

Saída:

    2011-08-31

### Equivalente com escopo {#r_GDT-addYearsLocalTime_N__section_yhl_bnr_mcb}

Para usar o método AddYearsLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [AddYearsLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddYearsLocalTime_Number "Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai anos usando os valores de data e hora locais.").

## GlideDateTime -- addYearsUTC(Número de anos) {#ariaid-title19}

Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos.
O valor de data e hora armazenado pelo objeto GlideDateTime é interpretado como se estivesse no fuso horário UTC.
{#r_GDT-addYearsUTC_N__table_njl_czk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| anos | Número | O número de anos a serem adicionados. Use um valor negativo para subtrair. |
[Tabela 32. Parâmetros]

{#r_GDT-addYearsUTC_N__table_njl_czk_nt} {#r_GDT-addYearsUTC_N__table_ojl_czk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 33. Retorna]

{#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());

Saída:

    2011-08-31

### Equivalente com escopo {#r_GDT-addYearsUTC_N__section_yj1_2nr_mcb}

Para usar o método addYearsUTC() em uma aplicação com escopo, use o método com escopo correspondente: [addYearsUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeAddYearsUTC_Number "Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos. O valor de data e hora armazenado pelo objeto GlideDateTime é interpretado como se estivesse no fuso horário UTC.").

## GlideDateTime -- compareTo(Data/hora do objeto) {#ariaid-title20}

Compara dois objetos de data e hora para determinar se um ocorre antes do outro ou se são equivalentes.
{#r_GDT-compareTo_O__table_sc3_rbd_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Objeto | Data e hora em um objeto GlideDateTime |
[Tabela 34. Parâmetros]

{#r_GDT-compareTo_O__table_sc3_rbd_nt} {#r_GDT-compareTo_O__table_tc3_rbd_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | * 0 = As datas são iguais * 1 = A data do objeto é posterior à data especificada no parâmetro * -1 = A data do objeto é anterior à data especificada no parâmetro {#r_GDT-compareTo_O__ul_tb3_mjg_sz} |
[Tabela 35. Retorna]

{#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)

Saída:

    0
    1
    -1

### Equivalente com escopo {#r_GDT-compareTo_O__section_opf_mnr_mcb}

Para usar o método compareTo() em uma aplicação com escopo, use o método com escopo correspondente: [compareTo()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeCompareTo_Object_o "Compara dois objetos de data e hora para determinar se são equivalentes ou se um ocorre antes ou depois do outro.").

## GlideDateTime - igual a (objeto GDT) {#ariaid-title21}

Compara um objeto com um valor existente de igualdade.
{#r_GDT-equals_O__table_njf_vvl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| GDT | Objeto | O objeto a ser comparado. Pode ser um objeto GlideDateTIMe ou uma cadeia de caracteres de data e hora válida. |
[Tabela 36. Parâmetros]

{#r_GDT-equals_O__table_njf_vvl_nt} {#r_GDT-equals_O__table_ojf_vvl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se forem iguais, falso caso contrário. |
[Tabela 37. Retorna]

{#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"));

Saída:

     false

### Equivalente com escopo {#r_GDT-equals_O__section_i3p_4nr_mcb}

Para usar o método igual a () em uma aplicação com escopo, use o método com escopo correspondente: [igual a ()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeEquals_Object "Compara uma data/hora com um valor existente de igualdade.").

## GlideDateTime -- getDate() {#ariaid-title22}

Retorna a data armazenada pelo objeto GlideDateTime. Expresso no formato aaaa-MM-dd e no fuso horário do sistema, UTC por padrão.
{#r_GDT-getDate__table_mjv_xq2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 38. Parâmetros]

{#r_GDT-getDate__table_mjv_xq2_nt} {#r_GDT-getDate__table_njv_xq2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Data no fuso horário do sistema. Formato: aaaa-MM-dd e, no fuso horário do sistema, UTC por padrão. |
[Tabela 39. Retorna]

{#r_GDT-getDate__table_njv_xq2_nt}  

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

Saída:

    2011-08-31

### Equivalente com escopo {#r_GDT-getDate__section_xpq_tnr_mcb}

Para usar o método getDate() em uma aplicação com escopo, use o método com escopo correspondente: [getDate()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDate "Retorna a data armazenada pelo objeto GlideDateTime. Expresso no formato padrão, aaaa-MM-dd, e no fuso horário do sistema, GMT por padrão.").

## GlideDateTime -- getDayOfMonth() {#ariaid-title23}

Obtém o dia atual do mês no fuso horário UTC.
descontinuado Use getDayOfMonthLocalTime() e getDayOfMonthUTC() em vez deste método.
{#r_GDT-getDayOfMonth__table_orj_hg2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 40. Parâmetros]

{#r_GDT-getDayOfMonth__table_orj_hg2_nt} {#r_GDT-getDayOfMonth__table_prj_hg2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O dia do mês no fuso horário UTC, de 1 a 31. |
[Tabela 41. Retorna]

{#r_GDT-getDayOfMonth__table_prj_hg2_nt}  

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

Saída:

    2

## GlideDateTime -- getDayOfMonthLocalTime() {#ariaid-title24}

Obtém o dia do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.
{#r_GDT-getDayOfMonthLocalTime__table_e4r_wg2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 42. Parâmetros]

{#r_GDT-getDayOfMonthLocalTime__table_e4r_wg2_nt} {#r_GDT-getDayOfMonthLocalTime__table_f4r_wg2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O dia do mês no fuso horário do usuário, de 1 a 31. |
[Tabela 43. Retorna]

{#r_GDT-getDayOfMonthLocalTime__table_f4r_wg2_nt}  

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

Saída:

    2

### Equivalente com escopo {#r_GDT-getDayOfMonthLocalTime__section_ap5_d4r_mcb}

Para usar o método getDayOfMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getDayOfMonthLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDayOfMonthLocalTime "Obtém o dia do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.").

## GlideDateTime -- getDayOfMonthUTC() {#ariaid-title25}

Obtém o dia do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_GDT-getDayOfMonthUTC__table_hhb_nh2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 44. Parâmetros]

{#r_GDT-getDayOfMonthUTC__table_hhb_nh2_nt} {#r_GDT-getDayOfMonthUTC__table_ihb_nh2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O dia do mês no fuso horário UTC, de 1 a 31. |
[Tabela 45. Retorna]

{#r_GDT-getDayOfMonthUTC__table_ihb_nh2_nt}  

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

Saída:

    2

### Equivalente com escopo {#r_GDT-getDayOfMonthUTC__section_rvd_34r_mcb}

Para usar o método getDayOfMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: [getDayOfMonthUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDayOfMonthUTC "Obtém o dia do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.").

## GlideDateTime -- getDayOfWeek() {#ariaid-title26}

Recupera o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário.
Use getDayOfWeekLocalTime() e getDayOfWeekUTC() em vez deste método.
{#r_GDT-getDayOfWeek__table_yvw_zc2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 46. Parâmetros]

{#r_GDT-getDayOfWeek__table_yvw_zc2_nt} {#r_GDT-getDayOfWeek__table_zvw_zc2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor do dia da semana - Segunda-feira = 1, ... Domingo = 7. |
[Tabela 47. Retorna]

{#r_GDT-getDayOfWeek__table_zvw_zc2_nt}  

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

Saída:

    4

## GlideDateTime -- getDayOfWeekLocalTime() {#ariaid-title27}

Obtém o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário.
{#r_GDT-getDayOfWeekLocalTime__table_xmt_qd2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 48. Parâmetros]

{#r_GDT-getDayOfWeekLocalTime__table_xmt_qd2_nt} {#r_GDT-getDayOfWeekLocalTime__table_ymt_qd2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor do dia da semana - Segunda-feira = 1, ... Domingo = 7 |
[Tabela 49. Retorna]

{#r_GDT-getDayOfWeekLocalTime__table_ymt_qd2_nt}  

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

Saída:

    4

### Equivalente com escopo {#r_GDT-getDayOfWeekLocalTime__section_lmp_k4r_mcb}

Para usar o método getDayOfWeekLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getDayOfWeekLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDayOfWeekLocalTime "Obtém o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário.").

## GlideDateTime -- getDayOfWeekUTC() {#ariaid-title28}

Obtém o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_GDT-getDayOfWeekUTC__table_bwl_b22_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 50. Parâmetros]

{#r_GDT-getDayOfWeekUTC__table_bwl_b22_nt} {#r_GDT-getDayOfWeekUTC__table_cwl_b22_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor do dia da semana - Segunda-feira = 1, ... Domingo = 7 |
[Tabela 51. Retorna]

{#r_GDT-getDayOfWeekUTC__table_cwl_b22_nt}  

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

Saída:

    4

### Equivalente com escopo {#r_GDT-getDayOfWeekUTC__section_ddt_n4r_mcb}

Para usar o método getDayOfWeekUTC() em uma aplicação com escopo, use o método com escopo correspondente: [getDayOfWeekUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDayOfWeekUTC "Retorna o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.").

## GlideDateTime -- getDaysInMonth() {#ariaid-title29}

Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário da máquina virtual Java.
Use getDaysInMonthLocalTime() e getDaysInMonthUTC() em vez deste método.
{#r_GDT-getDaysInMonth__table_s3d_yj2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 52. Parâmetros]

{#r_GDT-getDaysInMonth__table_s3d_yj2_nt} {#r_GDT-getDaysInMonth__table_t3d_yj2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de dias no mês atual no fuso horário da Java Virtual Machine. |
[Tabela 53. Retorna]

{#r_GDT-getDaysInMonth__table_t3d_yj2_nt}  

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

Saída:

    31

## GlideDateTime -- getDaysInMonthLocalTime() {#ariaid-title30}

Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.
{#r_GDT-getDaysInMonthLocalTime__table_sjf_lk2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 54. Parâmetros]

{#r_GDT-getDaysInMonthLocalTime__table_sjf_lk2_nt} {#r_GDT-getDaysInMonthLocalTime__table_tjf_lk2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de dias no mês atual no fuso horário do usuário. |
[Tabela 55. Retorna]

{#r_GDT-getDaysInMonthLocalTime__table_tjf_lk2_nt}  

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

Saída:

    31

### Equivalente com escopo {#r_GDT-getDaysInMonthLocalTime__section_z35_q4r_mcb}

Para usar o método getDaysInMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getDaysInMonthLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDaysInMonthLocalTime "Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.").

## GlideDateTime -- getDaysInMonthUTC() {#ariaid-title31}

Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_GDT-getDaysInMonthUTC__table_hwd_ll2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 56. Parâmetros]

{#r_GDT-getDaysInMonthUTC__table_hwd_ll2_nt} {#r_GDT-getDaysInMonthUTC__table_iwd_ll2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC. |
[Tabela 57. Retorna]

{#r_GDT-getDaysInMonthUTC__table_iwd_ll2_nt}  

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

Saída:

    31

### Equivalente com escopo {#r_GDT-getDaysInMonthUTC__section_l4t_54r_mcb}

Para usar o método getDaysInMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: [getDaysInMonthUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDaysInMonthUTC "Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.").

## GlideDateTime -- getDisplayValue() {#ariaid-title32}

Obtém o valor de data e hora no formato de exibição e fuso horário do usuário atual.
Nota:  
Fazer referência ao objeto GlideDateTime retorna diretamente o valor de data e hora no fuso horário GMT.
{#r_GDT-getDisplayValue__table_lyf_h1d_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 58. Parâmetros]

{#r_GDT-getDisplayValue__table_lyf_h1d_nt} {#r_GDT-getDisplayValue__table_myf_h1d_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Data e hora no formato e fuso horário do usuário. Lembre-se de que, ao projetar regras de negócio ou inclusões de script, esse método pode retornar valores em formatos diferentes para usuários diferentes. |
[Tabela 59. Retorna]

{#r_GDT-getDisplayValue__table_myf_h1d_nt}  

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

Saída:

    2011-08-31 01:00:00

### Equivalente com escopo {#r_GDT-getDisplayValue__section_u2f_x4r_mcb}

Para usar o método getDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: [getDisplayValue()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDisplayValue "Obtém o valor de data e hora no formato de exibição e fuso horário do usuário atual.").

## GlideDateTime -- getDisplayValueInternal() {#ariaid-title33}

Retorna o valor de exibição no formato interno, aaaa-MM-dd HH:mm:ss. Este método é útil para campos de data/hora, mas não para campos de data.
{#r_GDT-getDisplayValueInternal__table_ocw_t1d_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 60. Parâmetros]

{#r_GDT-getDisplayValueInternal__table_ocw_t1d_nt} {#r_GDT-getDisplayValueInternal__table_pcw_t1d_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Os valores de data e hora do objeto GlideDateTime. Formato: aaaa-MM-dd HH:mm:ss no fuso horário do solicitante. |
[Tabela 61. Retorna]

{#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());

Saída:

    2011-08-31 01:00:00

### Equivalente com escopo {#r_GDT-getDisplayValueInternal__section_jng_z4r_mcb}

Para usar o método getDisplayValueInternal() em uma aplicação com escopo, use o método com escopo correspondente: [getDisplayValueInternal()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDisplayValueInternal "Obtém o valor de exibição no formato interno (aaaa-MM-dd HH:mm:ss).").

## GlideDateTime -- getDisplayValueLang(estilo cadeia de caracteres) {#ariaid-title34}

Retorna um valor de data e hora na localidade do usuário atual de acordo com o estilo de data especificado.
{#r_GDT-getDisplayValueLang_S__id_zqf_hvw_dwb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| estilo | Cadeia de caracteres | Especifica o formato de data e hora. Valores válidos: * full: retorna a data no formato de\<weekday, month, day, and year\> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). * long: retorna a data no formato de\<month, day, and year\> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). * médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). * short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão o valor <var class="keyword varname">médio</var>. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas. |
[Tabela 62. Parâmetros]

{#r_GDT-getDisplayValueLang_S__id_zqf_hvw_dwb} {#r_GDT-getDisplayValueLang_S__id_pp1_3vw_dwb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Uma representação de cadeia de caracteres da data no estilo especificado e no formato apropriado para a localidade do usuário atual. |
[Tabela 63. Retorna]

{#r_GDT-getDisplayValueLang_S__id_pp1_3vw_dwb}  
O exemplo a seguir retorna a data e a hora da localidade do usuário em todos os estilos de data.

    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"));

Saída:

    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 (estilo de cadeia de caracteres, idioma de cadeia de caracteres) {#ariaid-title35}

Retorna um valor de data e hora na localidade do usuário atual de acordo com um idioma e estilo de data especificados.
{#r_GDT-getDisplayValueLang_S_S__id_dfb_4vw_dwb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| estilo | Cadeia de caracteres | Especifica o formato de data e hora. Valores válidos: * full: retorna a data no formato de\<weekday, month, day, and year\> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). * long: retorna a data no formato de\<month, day, and year\> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). * médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). * short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão o valor <var class="keyword varname">médio</var>. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas. |
| idioma | Cadeia de caracteres | Retorna a data de acordo com um valor de idioma especificado. Aceita marcadores de idioma em conformidade com o padrão BCP-47. Por exemplo, `fr` para francês ou `en-UK` para inglês do Reino Unido. Para obter uma lista completa de valores aceitos, consulte [BCP 47 Lista de códigos de idioma](https://appmakers.dev/bcp-47-language-codes-list/). |
[Tabela 64. Parâmetros]

{#r_GDT-getDisplayValueLang_S_S__id_dfb_4vw_dwb} {#r_GDT-getDisplayValueLang_S_S__id_v5l_4vw_dwb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Uma representação de cadeia de caracteres da data no estilo especificado e no formato apropriado para a localidade do usuário atual. |
[Tabela 65. Retorna]

{#r_GDT-getDisplayValueLang_S_S__id_v5l_4vw_dwb}  
O exemplo a seguir retorna a data e a hora da localidade do usuário em todos os estilos de idioma e data.

    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"));```

Saída:

    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}

Obtém a quantidade de tempo em que o horário de verão está deslocado.
{#r_GDT-getDSTOffset__table_iyb_vvc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 66. Parâmetros]

{#r_GDT-getDSTOffset__table_iyb_vvc_nt} {#r_GDT-getDSTOffset__table_jyb_vvc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Quantidade de tempo, em milissegundos, em que o horário de verão está compensado. Retorna 0 se não houver deslocamento ou se a hora não estiver durante o horário de verão. |
[Tabela 67. Retorna]

{#r_GDT-getDSTOffset__table_jyb_vvc_nt}  

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

Saída:

    3600000

### Equivalente com escopo {#r_GDT-getDSTOffset__section_myc_rnr_mcb}

Para usar o método getDSToffset() em uma aplicação com escopo, use o método com escopo correspondente: [getDSToffset()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetDSTOffset "Obtém a quantidade de tempo em que o horário de verão está deslocado.").

## GlideDateTime -- getErrorMsg() {#ariaid-title37}

Obtém a mensagem de erro atual.
{#r_GDT-getErrorMsg__table_dks_dsl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 68. Parâmetros]

{#r_GDT-getErrorMsg__table_dks_dsl_nt} {#r_GDT-getErrorMsg__table_eks_dsl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | A mensagem de erro |
[Tabela 69. Retorna]

{#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

Saída:

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

### Equivalente com escopo {#r_GDT-getErrorMsg__section_hmx_hpr_mcb}

Para usar o método getErrorMsg() em uma aplicação com escopo, use o método com escopo correspondente: [getErrorMsg()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetErrorMsg "Obtém a mensagem de erro atual.").

## GlideDateTime -- getInternalFormattedLocalTime() {#ariaid-title38}

Retorna a hora do objeto no fuso horário local e no formato interno.
{#r_GDT-getInternalFormatedLocalTime__table_izw_h5c_kw__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 70. Parâmetros]

{#r_GDT-getInternalFormatedLocalTime__table_izw_h5c_kw} {#r_GDT-getInternalFormatedLocalTime__table_jzw_h5c_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | A hora do objeto no fuso horário local e no formato interno. |
[Tabela 71. Retorna]

{#r_GDT-getInternalFormatedLocalTime__table_jzw_h5c_kw}  
Este exemplo exibe a hora no formato de hora do sistema do fuso horário do usuário.

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

Saída:

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

### Equivalente com escopo {#r_GDT-getInternalFormatedLocalTime__section_xvx_hc2_dbb}

Para usar o método getInternalFormattedLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getInternalFormattedLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_SGDT-getInternalFormattedLocalTime "Retorna a hora do objeto no fuso horário local e no formato interno.").

## GlideDateTime -- getInternalMidight(Number dayOfTheWeek) {#ariaid-title39}

Retorna um objeto de data e hora definido como meia-noite de um dia especificado usando UTC.
{#r_GDT-getInternalMidnight_N__table_llc_mp2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| diaDaSemana | Número | O dia da semana para o qual o objeto de data/hora será retornado. |
[Tabela 72. Parâmetros]

{#r_GDT-getInternalMidnight_N__table_llc_mp2_nt} {#r_GDT-getInternalMidnight_N__table_mlc_mp2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDateTime | Um objeto GlideDateTime definido como meia-noite. |
[Tabela 73. Retorna]

{#r_GDT-getInternalMidnight_N__table_mlc_mp2_nt}  

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

Saída:

    2011-08-30 00:00:01

## GlideDateTime -- getLocalDate() {#ariaid-title40}

Obtém a data armazenada pelo objeto GlideDateTime, expressa no formato padrão, aaaa-MM-dd, e o fuso horário do usuário atual.
{#r_GDT-getLocalDate__table_ays_hr2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 74. Parâmetros]

{#r_GDT-getLocalDate__table_ays_hr2_nt} {#r_GDT-getLocalDate__table_bys_hr2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDate | A data no fuso horário do usuário. |
[Tabela 75. Retorna]

{#r_GDT-getLocalDate__table_bys_hr2_nt}  
Este exemplo exibe a hora no formato de hora do usuário no fuso horário do usuário.

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

Saída:

    2011-08-31

### Equivalente com escopo {#r_GDT-getLocalDate__section_pg3_lpr_mcb}

Para usar o método getLocalDate() em uma aplicação com escopo, use o método com escopo correspondente: [getLocalDate()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetLocalDate "Obtém a data armazenada pelo objeto GlideDateTime, expressa no formato padrão, aaaa-MM-dd, e o fuso horário do usuário atual.").

## GlideDateTime -- getLocalTime() {#ariaid-title41}

Obtém a hora no fuso horário do usuário.
{#r_GDT-getLocalTime__table_t11_4q2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 76. Parâmetros]

{#r_GDT-getLocalTime__table_t11_4q2_nt} {#r_GDT-getLocalTime__table_u11_4q2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideTime | A hora no fuso horário do usuário. |
[Tabela 77. Retorna]

{#r_GDT-getLocalTime__table_u11_4q2_nt}  

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

Saída:

    1970-01-01 01:00:00

### Equivalente com escopo {#r_GDT-getLocalTime__section_kqj_4pr_mcb}

Para usar o método getLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetLocalTime "Retorna um objeto GlideTime que representa a parte de tempo do objeto GlideDateTime no fuso horário do usuário.").

## GlideDateTime -- getMonth() {#ariaid-title42}

Recupera o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário da máquina virtual Java.
Use getMonthLocalTime() e getMonthUTC() em vez deste método.
{#r_GDT-getMonth__table_pyx_tl2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 78. Parâmetros]

{#r_GDT-getMonth__table_pyx_tl2_nt} {#r_GDT-getMonth__table_qyx_tl2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor numérico do mês, Jan = 1, Dez = 12. |
[Tabela 79. Retorna]

{#r_GDT-getMonth__table_qyx_tl2_nt}  

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

Saída:

    12

## GlideDateTime -- getMonthLocalTime() {#ariaid-title43}

Obtém o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.
{#r_GDT-getMonthLocalTime__table_lcb_gm2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 80. Parâmetros]

{#r_GDT-getMonthLocalTime__table_lcb_gm2_nt} {#r_GDT-getMonthLocalTime__table_mcb_gm2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor numérico do mês, Jan = 1, Dez = 12. |
[Tabela 81. Retorna]

{#r_GDT-getMonthLocalTime__table_mcb_gm2_nt}  

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

Saída:

    12

### Equivalente com escopo {#r_GDT-getMonthLocalTime__section_mts_pvr_mcb}

Para usar o método getMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getMonthLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetMonthLocalTime "Obtém o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.").

## GlideDateTime -- getMonthUTC() {#ariaid-title44}

Obtém o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_GDT-getMonthUTC__table_bsp_5m2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 82. Parâmetros]

{#r_GDT-getMonthUTC__table_bsp_5m2_nt} {#r_GDT-getMonthUTC__table_csp_5m2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor numérico do mês, Jan = 1, Dez = 12. |
[Tabela 83. Retorna]

{#r_GDT-getMonthUTC__table_csp_5m2_nt}  

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

Saída:

    12

### Equivalente com escopo {#r_GDT-getMonthUTC__section_dvn_svr_mcb}

Para usar o método getMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: [getMonthUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetMonthUTC "Obtém o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.").

## GlideDateTime -- getNumericValue() {#ariaid-title45}

Obtém o número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT.
{#r_GDT-getNumericValue__table_vzg_g42_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 84. Parâmetros]

{#r_GDT-getNumericValue__table_vzg_g42_nt} {#r_GDT-getNumericValue__table_wzg_g42_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT. |
[Tabela 85. Retorna]

{#r_GDT-getNumericValue__table_wzg_g42_nt}  

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

Saída:

    1314777600000

## GlideDateTime -- getSpanTime(Number dayOfWeek) {#ariaid-title46}

Recupera a quantidade de tempo decorrido desde a meia-noite de um dia especificado até a hora atual.
{#r_GDT-getSpanTime_N__table_bqw_lf2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| diaDaSemana | Número | Valor do dia da semana de 1 a 7. 1 = Segunda-feira, 7=Domingo. |
[Tabela 86. Parâmetros]

{#r_GDT-getSpanTime_N__table_bqw_lf2_nt} {#r_GDT-getSpanTime_N__table_cqw_lf2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideTime | A quantidade de tempo decorrido desde a meia-noite do dia especificado. Para exibir o resultado em termos amigáveis, defina o valor como GlideDuration. |
[Tabela 87. Retorna]

{#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());

Saída:

    2 Days 8 Hours

## GlideDateTime -- getTime() {#ariaid-title47}

Obtém o carimbo de duração do Unix.
{#r_GDT-getTime__table_lny_z42_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 88. Parâmetros]

{#r_GDT-getTime__table_lny_z42_nt} {#r_GDT-getTime__table_mny_z42_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideTime | O carimbo de duração do Unix no formato do sistema com base na hora GMT. |
[Tabela 89. Retorna]

{#r_GDT-getTime__table_mny_z42_nt}  

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

Saída:

    1970-01-01 08:00:00

### Equivalente com escopo {#r_GDT-getTime__section_fjc_xvr_mcb}

Para usar o método getTime() em uma aplicação com escopo, use o método com escopo correspondente: [getTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetTime "Retorna um objeto GlideTime que representa a parte de tempo do objeto GlideDateTime.").

## GlideDateTime -- getTZOffset() {#ariaid-title48}

Obtém a diferença de fuso horário em milissegundos.
{#r_GDT-getTZOffset__table_nk4_f5l_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 90. Parâmetros]

{#r_GDT-getTZOffset__table_nk4_f5l_nt} {#r_GDT-getTZOffset__table_ok4_f5l_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de milissegundos da compensação de fuso horário |
[Tabela 91. Retorna]

{#r_GDT-getTZOffset__table_ok4_f5l_nt}  

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

Saída:

    -28800000

### Equivalente com escopo {#r_GDT-getTZOffset__section_ihs_5vr_mcb}

Para usar o método getTZOffset() em uma aplicação com escopo, use o método com escopo correspondente: [getTZOffset()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetTZOffset "Obtém a diferença de fuso horário em milissegundos.").

## GlideDateTime -- getUserFormattedLocalTime() {#ariaid-title49}

Retorna a hora do objeto no fuso horário local no formato do usuário.
{#r_GDT-getUserFormattedLocalTime__table_lgj_ftc_kw__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 92. Parâmetros]

{#r_GDT-getUserFormattedLocalTime__table_lgj_ftc_kw} {#r_GDT-getUserFormattedLocalTime__table_mgj_ftc_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | A hora do objeto no horário local e o formato do usuário. |
[Tabela 93. Retorna]

{#r_GDT-getUserFormattedLocalTime__table_mgj_ftc_kw}  
O exemplo de código a seguir mostra como chamar este método.

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

Saída:

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

### Equivalente com escopo {#r_GDT-getUserFormattedLocalTime__section_hsv_f22_dbb}

Para usar o método getUserFormattedLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getUserFormattedLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_SGDT-getUserFormattedLocalTime "Retorna a hora do objeto no fuso horário local e no formato do usuário.").

## GlideDateTime -- getUserTimeZone() {#ariaid-title50}

Recupera o fuso horário da sessão do usuário atual.
Este método é equivalente a `gs.getSession().getTimeZone()`.
{#r_GDT-getUserTimeZone__table_eyw_b4c_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 94. Parâmetros]

{#r_GDT-getUserTimeZone__table_eyw_b4c_nt} {#r_GDT-getUserTimeZone__table_fyw_b4c_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Fuso horário | Objeto TimeZone para o usuário atual. |
[Tabela 95. Retorna]

{#r_GDT-getUserTimeZone__table_fyw_b4c_nt}  

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

Saída:

    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(Número dayOfTheWeek) {#ariaid-title51}

Recupera um objeto GlideDateTime com a hora definida como meia-noite usando o fuso horário UTC.
Este método define a data do novo objeto GlideDateTime como o dia da semana especificado dentro da semana do objeto GlideDateTime original.
{#r_GDT-getUTCMidnight_N__table_ezg_zp2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| diaDaSemana | Número | O dia da semana, de 1 a 7. Segunda-feira = 1, domingo = 7. Não insira 0 neste parâmetro. |
[Tabela 96. Parâmetros]

{#r_GDT-getUTCMidnight_N__table_ezg_zp2_nt} {#r_GDT-getUTCMidnight_N__table_fzg_zp2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDateTime | Um novo objeto GlideDateTime, definido como meia-noite. |
[Tabela 97. Retorna]

{#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.

Saída:

    2011-09-02 00:00:00

## GlideDateTime -- getValue() {#ariaid-title52}

Retorna o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss, no fuso horário UTC.
{#r_GDT-getValue__table_osc_gbd_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 98. Parâmetros]

{#r_GDT-getValue__table_osc_gbd_nt} {#r_GDT-getValue__table_psc_gbd_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Data e hora no formato interno e fuso horário do sistema. Formato: aaaa-MM-dd HH:mm:ss no fuso horário UTC. |
[Tabela 99. Retorna]

{#r_GDT-getValue__table_psc_gbd_nt}  

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

Saída:

    2011-08-31 08:00:00

### Equivalente com escopo {#r_GDT-getValue__section_kt5_zvr_mcb}

Para usar o método getValue() em uma aplicação com escopo, use o método com escopo correspondente: [getValue()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetValue "Retorna o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss, no fuso horário UTC.").

## GlideDateTime -- getWeekOfYearLocalTime() {#ariaid-title53}

Obtém o número da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.
Todas as semanas começam no domingo. A primeira semana do ano é a semana que contém pelo menos um dia do novo ano. A semana que começa no domingo de 27/12/2015 é considerada a primeira semana de 2016, já que essa semana contém 1 e 2 de janeiro.
{#r_GDT-getWeekOfYearLocalTime__table_vq5_422_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 100. Parâmetros]

{#r_GDT-getWeekOfYearLocalTime__table_vq5_422_nt} {#r_GDT-getWeekOfYearLocalTime__table_wq5_422_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número da semana atual. O maior número de semanas em um ano é 52 ou 53. |
[Tabela 101. Retorna]

{#r_GDT-getWeekOfYearLocalTime__table_wq5_422_nt}  

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

Saída:

    49

### Equivalente com escopo {#r_GDT-getWeekOfYearLocalTime__section_yh2_cwr_mcb}

Para usar o método getWeekOfYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getWeekOfYearLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetWeekOfYearLocalTime "Obtém o número da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.").

## GlideDateTime -- getWeekOfYearUTC() {#ariaid-title54}

Obtém o número da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
Todas as semanas começam no domingo. A primeira semana do ano é a semana que contém pelo menos um dia do novo ano. A semana que começa no domingo de 27/12/2015 é considerada a primeira semana de 2016, já que essa semana contém 1 e 2 de janeiro.
{#r_GDT-getWeekOfYearUTC__table_jdh_bf2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 102. Parâmetros]

{#r_GDT-getWeekOfYearUTC__table_jdh_bf2_nt} {#r_GDT-getWeekOfYearUTC__table_kdh_bf2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número da semana atual no horário UTC. O maior número de semanas em um ano é 52 ou 53. |
[Tabela 103. Retorna]

{#r_GDT-getWeekOfYearUTC__table_kdh_bf2_nt}  

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

Saída:

    49

### Equivalente com escopo {#r_GDT-getWeekOfYearUTC__section_fpl_2wr_mcb}

Para usar o método getWeekOfYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: [getWeekOfYearUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetWeekOfYearUTC "Obtém o número da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.").

## GlideDateTime -- getYear() {#ariaid-title55}

Recupera o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário da máquina virtual Java.
Use getYearLocalTime() e getYearUTC() em vez deste método.
{#r_GDT-getYear__table_jhh_dn2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 104. Parâmetros]

{#r_GDT-getYear__table_jhh_dn2_nt} {#r_GDT-getYear__table_khh_dn2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor de ano de 4 dígitos no fuso horário da Java Virtual Machine. |
[Tabela 105. Retorna]

{#r_GDT-getYear__table_khh_dn2_nt}  

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

Saída:

    2011

## GlideDateTime -- getYearLocalTime() {#ariaid-title56}

Obtém o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.
{#r_GDT-getYearLocalTime__table_tzz_4n2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 106. Parâmetros]

{#r_GDT-getYearLocalTime__table_tzz_4n2_nt} {#r_GDT-getYearLocalTime__table_uzz_4n2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor de ano de 4 dígitos no fuso horário do usuário. |
[Tabela 107. Retorna]

{#r_GDT-getYearLocalTime__table_uzz_4n2_nt}  

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

Saída:

    2011

### Equivalente com escopo {#r_GDT-getYearLocalTime__section_dys_jwr_mcb}

Para usar o método getYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [getYearLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetYearLocalTime "Obtém o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.").

## GlideDateTime -- getYearUTC() {#ariaid-title57}

Retorna o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_GDT-getYearUTC__table_dml_xn2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 108. Parâmetros]

{#r_GDT-getYearUTC__table_dml_xn2_nt} {#r_GDT-getYearUTC__table_eml_xn2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| número | Valor de ano de quatro dígitos no fuso horário UTC. |
[Tabela 109. Retorna]

{#r_GDT-getYearUTC__table_eml_xn2_nt}  

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

Saída:

    2011

### Equivalente com escopo {#r_GDT-getYearUTC__section_j4m_pwr_mcb}

Para usar o método getYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: [getYearUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeGetYearUTC "Obtém o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.").

## GlideDateTime -- hasDate() {#ariaid-title58}

Determina se a data de um objeto está definida.
{#r_GDT-hasDate__table_iqj_rnc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 110. Parâmetros]

{#r_GDT-hasDate__table_iqj_rnc_nt} {#r_GDT-hasDate__table_jqj_rnc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se a data do objeto estiver definida, caso contrário, falso. |
[Tabela 111. Retorna]

{#r_GDT-hasDate__table_jqj_rnc_nt}  

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

Saída:

    true

### Equivalente com escopo {#r_GDT-hasDate__section_yzp_rwr_mcb}

Para usar o método hasDate() em uma aplicação com escopo, use o método com escopo correspondente: [hasDate()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeHasDate "Determina se a data de um objeto está definida.").

## GlideDateTime -- isDST() {#ariaid-title59}

Determina se a hora do objeto usa um deslocamento de verão
{#r_GDT-isDST__table_ncy_jvc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 112. Parâmetros]

{#r_GDT-isDST__table_ncy_jvc_nt} {#r_GDT-isDST__table_ocy_jvc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o horário for horário de verão; caso contrário, falso. |
[Tabela 113. Retorna]

{#r_GDT-isDST__table_ocy_jvc_nt}  

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

Saída:

    true

### Equivalente com escopo {#r_GDT-isDST__section_gns_twr_mcb}

Para usar o método isDST() em uma aplicação com escopo, use o método com escopo correspondente: [isDST()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeIsDST "Determina se a hora de um objeto usa um deslocamento de horário de verão.").

## GlideDateTime -- isValid() {#ariaid-title60}

Determina se um valor é uma data e hora válidas.
{#r_GDT-isValid__table_sfh_5rl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 114. Parâmetros]

{#r_GDT-isValid__table_sfh_5rl_nt} {#r_GDT-isValid__table_tfh_5rl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o valor for válido, caso contrário, falso. |
[Tabela 115. Retorna]

{#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

Saída

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

### Equivalente com escopo {#r_GDT-isValid__section_flp_vwr_mcb}

Para usar o método isValid() em uma aplicação com escopo, use o método com escopo correspondente: [isValid()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeIsValid "Determina se um valor é uma data e hora válidas.").

## GlideDateTime -- setDayOfMonth(Número de dias) {#ariaid-title61}

Define o dia do mês com um valor especificado.
Use setDayOfMonthLocalTime(day) e setDayOfMonthUTC(day) em vez deste método.
{#r_GDT-setDayOfMonth_N__table_pp4_vh2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dia | Número | Dia do mês, de 1 a 31. |
[Tabela 116. Parâmetros]

{#r_GDT-setDayOfMonth_N__table_pp4_vh2_nt} {#r_GDT-setDayOfMonth_N__table_qp4_vh2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 117. Retorna]

{#r_GDT-setDayOfMonth_N__table_qp4_vh2_nt}  

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

Saída:

    9

## GlideDateTime -- setDayOfMonthLocalTime(Número dia) {#ariaid-title62}

Define o dia do mês com um valor especificado no fuso horário do usuário atual.
{#r_GDT-setDayOfMonthLocalTime_N__table_bvc_1j2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dia | Número | O dia do mês para o qual mudar, de 1 a 31. Se este valor for maior que o número máximo de dias no mês, o valor será definido como o último dia do mês. |
[Tabela 118. Parâmetros]

{#r_GDT-setDayOfMonthLocalTime_N__table_bvc_1j2_nt} {#r_GDT-setDayOfMonthLocalTime_N__table_cvc_1j2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 119. Retorna]

{#r_GDT-setDayOfMonthLocalTime_N__table_cvc_1j2_nt}  

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

Saída:

    9

### Equivalente com escopo {#r_GDT-setDayOfMonthLocalTime_N__section_p4c_ywr_mcb}

Para usar o método setDayOfMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [setDayOfMonthLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day "Define o dia do mês com um valor especificado no fuso horário do usuário atual.").

## GlideDateTime -- setDayOfMonthUTC(Número de dias) {#ariaid-title63}

Define o dia do mês com um valor especificado no fuso horário UTC.
{#r_GDT-setDayOfMonthUTC_N__table_mmk_mj2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dia | Número | O dia do mês para o qual mudar, de 1 a 31. Se este valor for maior que o número máximo de dias no mês, o valor será definido como o último dia do mês. |
[Tabela 120. Parâmetros]

{#r_GDT-setDayOfMonthUTC_N__table_mmk_mj2_nt} {#r_GDT-setDayOfMonthUTC_N__table_nmk_mj2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 121. Retorna]

{#r_GDT-setDayOfMonthUTC_N__table_nmk_mj2_nt}  

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

Saída:

    9

### Equivalente com escopo {#r_GDT-setDayOfMonthUTC_N__section_rxh_1xr_mcb}

Para usar o método setDayOfMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: [setDayOfMonthUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day "Define o dia do mês com um valor especificado no fuso horário UTC.").

## GlideDateTime -- setDisplayValue(cadeia de caracteres asDisplayed) {#ariaid-title64}

Define um valor de data e hora usando o formato de exibição e o fuso horário do usuário atual.
{#r_GDT-setDisplayValue_S__table_jnc_fwc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| comoExibido | Cadeia de caracteres | A data e a hora no formato de exibição e fuso horário do usuário atual. O parâmetro deve ser formatado usando o formato de exibição preferencial do usuário atual, como MM-dd-yyyy HH:mm:ss. Para atribuir a data e hora atuais a uma variável em um script de fluxo de trabalho, use\<variable\> `.setDisplayValue(gs.nowDateTime);`. |
[Tabela 122. Parâmetros]

{#r_GDT-setDisplayValue_S__table_jnc_fwc_nt} {#r_GDT-setDisplayValue_S__table_knc_fwc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 123. Retorna]

{#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());

Saída:

    2011-01-01 20:00:00

### Equivalente com escopo {#r_GDT-setDisplayValue_S__section_wyq_2xr_mcb}

Para usar o método setDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: [setDisplayValue()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed "Define um valor de data e hora usando o formato de exibição e o fuso horário do usuário atual.").

## GlideDateTime -- setDisplayValue(cadeia de caracteres dateTime, formato de cadeia de caracteres) {#ariaid-title65}

Define um valor de data e hora usando o fuso horário do usuário atual e o formato de data e hora especificado.
Este método lança uma exceção de tempo de execução se o formato de data e hora usado no parâmetro dateTime não corresponder ao parâmetro format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for detectada.
{#r_GDT-setDisplayValue_S_S__table_dqz_pzc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | A data e a hora no fuso horário do usuário atual. |
| formato | Cadeia de caracteres | O formato a ser usado para analisar o parâmetro dateTime. |
[Tabela 124. Parâmetros]

{#r_GDT-setDisplayValue_S_S__table_dqz_pzc_nt} {#r_GDT-setDisplayValue_S_S__table_eqz_pzc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 125. Retorna]

{#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());

Saída:

    2011-05-20 19:00:00

### Equivalente com escopo {#r_GDT-setDisplayValue_S_S__section_zns_gxr_mcb}

Para usar o método setDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: [setDisplayValue()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format "Define um valor de data e hora usando o fuso horário do usuário atual e o formato de data e hora especificado.").

## GlideDateTime -- setDisplayValueInternal(cadeia de caracteres dateTime) {#ariaid-title66}

Define um valor de data e hora usando o formato interno (aaaa-MM-dd HH:mm:ss) e o fuso horário do usuário atual.
{#r_GDT-setDisplayValueInternal_S__table_zrg_5wc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | A data e a hora no formato interno |
[Tabela 126. Parâmetros]

{#r_GDT-setDisplayValueInternal_S__table_zrg_5wc_nt} {#r_GDT-setDisplayValueInternal_S__table_asg_5wc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 127. Retorna]

{#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());

Saída:

    2011-01-01 20:00:00

### Equivalente com escopo {#r_GDT-setDisplayValueInternal_S__section_hrc_cxr_mcb}

Para usar o método setDisplayValueInternal() em uma aplicação com escopo, use o método com escopo correspondente: [setDisplayValueInternal()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value "Define um valor de data e hora usando o formato interno (aaaa-MM-dd HH:mm:ss) e o fuso horário do usuário atual.").

## GlideDateTime -- setDisplayValueInternalWithAlternates(cadeia de caracteres dateTime) {#ariaid-title67}

Define um valor de data e hora usando o formato interno (aaaa-MM-dd HH:mm:ss) e o fuso horário do usuário atual.
Este método tenta analisar valores de data e hora incompletos.
{#r_GDT-setDispValInternalAlt_S__table_ipl_dzc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | A data e a hora no formato interno. |
[Tabela 128. Parâmetros]

{#r_GDT-setDispValInternalAlt_S__table_ipl_dzc_nt} {#r_GDT-setDispValInternalAlt_S__table_jpl_dzc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 129. Retorna]

{#r_GDT-setDispValInternalAlt_S__table_jpl_dzc_nt}

## GlideDateTime -- setDisplayValueLang(cadeia de caracteres dateTime, estilo de cadeia de caracteres) {#ariaid-title68}

Define uma data usando um estilo e formato especificados de acordo com a localidade do usuário atual.
{#r_GDT-setDisplayValueLang_S_S__id_jjl_xvw_dwb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | Valor de data e hora do objeto GlideDate no fuso horário do usuário atual. Valores válidos são qualquer saída de data e hora da função getDisplayValueLang(). Por exemplo, usando a saída do exemplo getDisplayValueLang (Estilo de cadeia de caracteres, Linguagem de cadeia de caracteres) anteriormente neste tópico, 28 de novembro de 2022 07:03:41 ou 28.11.2022 07:03:41 são valores aceitos. |
| estilo | Cadeia de caracteres | Especifica o formato de data. Valores válidos: * full: retorna a data no formato de\<weekday, month, day, and year\> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). * long: retorna a data no formato de\<month, day, and year\> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). * médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). * short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão o valor <var class="keyword varname">médio</var>. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas. |
[Tabela 130. Parâmetros]

{#r_GDT-setDisplayValueLang_S_S__id_jjl_xvw_dwb} {#r_GDT-setDisplayValueLang_S_S__id_e41_yvw_dwb__entry__2}

| Tipo | Descrição |
|-|-|
| Vazio |   |
[Tabela 131. Retorna]

{#r_GDT-setDisplayValueLang_S_S__id_e41_yvw_dwb}  
O exemplo a seguir retorna a data e a hora nos estilos curto e completo.

    var glideDateFR = new GlideDateTime();
    glideDateFR.setDisplayValueLang("2/3/2023 17:27:56", "short");

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

Saída:

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

## GlideDateTime -- setDisplayValueLang(cadeia de caracteres data/hora, estilo de cadeia de caracteres, idioma de cadeia de caracteres) {#ariaid-title69}

Define uma data e hora usando um estilo, idioma e formato especificados de acordo com a localidade do usuário atual.
{#r_GDT-setDisplayValueLang_S_S_S__id_zks_2ww_dwb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | Valor de data e hora do objeto GlideDate no fuso horário do usuário atual. Valores válidos são qualquer saída de data e hora da função getDisplayValueLang(). Por exemplo, usando a saída do exemplo getDisplayValueLang (Estilo de cadeia de caracteres, Linguagem de cadeia de caracteres) anteriormente neste tópico, 28 de novembro de 2022 07:03:41 ou 28.11.2022 07:03:41 são valores aceitos. |
| estilo | Cadeia de caracteres | Especifica o formato de data. Valores válidos: * full: retorna a data no formato de\<weekday, month, day, and year\> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). * long: retorna a data no formato de\<month, day, and year\> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). * médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). * short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão o valor <var class="keyword varname">médio</var>. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas. |
| idioma | Cadeia de caracteres | Define o idioma usando um marcador de idioma em conformidade com o padrão BCP-47. Por exemplo, `fr` para francês ou `en-UK` para inglês do Reino Unido. Para obter uma lista completa de valores aceitos, consulte [BCP 47 Lista de códigos de idioma](https://appmakers.dev/bcp-47-language-codes-list/). |
[Tabela 132. Parâmetros]

{#r_GDT-setDisplayValueLang_S_S_S__id_zks_2ww_dwb} {#r_GDT-setDisplayValueLang_S_S_S__id_rg3_fww_dwb__entry__2}

| Tipo | Descrição |
|-|-|
| Vazio |   |
[Tabela 133. Retorna]

{#r_GDT-setDisplayValueLang_S_S_S__id_rg3_fww_dwb}  
O exemplo a seguir retorna a data e a hora nos estilos curto e completo para inglês e francês.

    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"));

Saída:

    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}

Define a data e a hora do objeto atual usando um objeto GlideDateTime existente.
Este método é equivalente a instanciar um novo objeto com um parâmetro GlideDateTime.
{#r_GDT-setGlideDateTime_GDT__table_xdg_y5c_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| GDT | GlideDateTime | Um objeto GlideDateTime |
[Tabela 134. Parâmetros]

{#r_GDT-setGlideDateTime_GDT__table_xdg_y5c_nt} {#r_GDT-setGlideDateTime_GDT__table_ydg_y5c_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 135. Retorna]

{#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());

Saída:

    2011-02-02 08:00:00

### Equivalente com escopo {#r_GDT-setGlideDateTime_GDT__section_fjw_3xr_mcb}

Para usar o método setGlideDateTime() em uma aplicação com escopo, use o método com escopo correspondente: [setGlideDateTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetGlideDateTime_g "Define a data e a hora do objeto atual usando um objeto GlideDateTime existente. Este método é equivalente a instanciar um novo objeto com um parâmetro GlideDateTime.").

## GlideDateTime -- setInitialValue(cadeia de caracteres dateTime) {#ariaid-title71}

Define a data e a hora.
Este método é equivalente a setValue(Object).
{#r_GDT-setInitialValue_S__table_i42_r5l_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | A data e a hora a serem usadas. Aceita uma cadeia de caracteres no fuso horário GMT no formato interno ou um objeto GlideDateTime. |
[Tabela 136. Parâmetros]

{#r_GDT-setInitialValue_S__table_i42_r5l_nt} {#r_GDT-setInitialValue_S__table_j42_r5l_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 137. Retorna]

{#r_GDT-setInitialValue_S__table_j42_r5l_nt}  

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

Saída:

    2011-01-01 12:00:00

## GlideDateTime -- setMonth(Número de meses) {#ariaid-title72}

Define o mês armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário da máquina virtual Java.
Use setMonthLocalTime() ou setMonthUTC() em vez deste método.
{#r_GDT-setMonth_N__table_djd_3wl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| mês | Número | O mês para o qual mudar. |
[Tabela 138. Parâmetros]

{#r_GDT-setMonth_N__table_djd_3wl_nt} {#r_GDT-setMonth_N__table_ejd_3wl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 139. Retorna]

{#r_GDT-setMonth_N__table_ejd_3wl_nt}  

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

Saída:

    1

## GlideDateTime -- setMonthLocalTime(Número de meses) {#ariaid-title73}

Define o mês armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário do usuário atual.
{#r_GDT-setMonthLocalTime_N__table_xgm_wwl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| mês | Número | O mês para o qual mudar. |
[Tabela 140. Parâmetros]

{#r_GDT-setMonthLocalTime_N__table_xgm_wwl_nt} {#r_GDT-setMonthLocalTime_N__table_ygm_wwl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 141. Retorna]

{#r_GDT-setMonthLocalTime_N__table_ygm_wwl_nt}  

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

Saída:

    1

### Equivalente com escopo {#r_GDT-setMonthLocalTime_N__section_rqq_lxr_mcb}

Para usar o método setMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [setMonthLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetMonthLocalTime_Number "Define o mês armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário do usuário atual.").

## GlideDateTime -- setMonthUTC(Número de meses) {#ariaid-title74}

Define o mês armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário UTC.
{#r_GDT-setMonthUTC_N__table_gt5_fxl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| mês | Número | O mês para o qual mudar. |
[Tabela 142. Parâmetros]

{#r_GDT-setMonthUTC_N__table_gt5_fxl_nt} {#r_GDT-setMonthUTC_N__table_ht5_fxl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 143. Retorna]

{#r_GDT-setMonthUTC_N__table_ht5_fxl_nt}  

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

Saída:

    1

### Equivalente com escopo {#r_GDT-setMonthUTC_N__section_xyx_nxr_mcb}

Para usar o método setMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: [setMonthUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetMonthUTC_Number "Define o mês armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário UTC.").

## GlideDateTime -- setNumericValue(Número milissegundos) {#ariaid-title75}

Define a data e a hora com o número de milissegundos desde 1º de janeiro de 1970 00:00:00 GMT.
{#r_GDT-setNumericValue_N__table_jsf_q42_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| milissegundos | Número | Número de milissegundos |
[Tabela 144. Parâmetros]

{#r_GDT-setNumericValue_N__table_jsf_q42_nt} {#r_GDT-setNumericValue_N__table_ksf_q42_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 145. Retorna]

{#r_GDT-setNumericValue_N__table_ksf_q42_nt}  

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

Saída:

    2011-08-31 08:00:00

## GlideDateTime -- setTZ(TimeZone timeZone) {#ariaid-title76}

Define o fuso horário do objeto GlideDateTime como o fuso horário especificado.
{#r_GDT-setTZ_TZ__table_uy3_54c_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fuso horário | Fuso horário | Um objeto de fuso horário |
[Tabela 146. Parâmetros]

{#r_GDT-setTZ_TZ__table_uy3_54c_nt} {#r_GDT-setTZ_TZ__table_vy3_54c_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 147. Retorna]

{#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}

Define a data e a hora do objeto GlideDateTime.
Este método é equivalente a setInitialValue().
{#r_GDT-setValue_O__table_yfh_fpc_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Objeto | A data e a hora a serem usadas. Este parâmetro pode ser de vários tipos. * Uma cadeia de caracteres no fuso horário UTC e no formato interno aaaa-MM-dd HH:mm:ss: define o valor do objeto para a data e hora especificadas. Usar o método dessa forma é equivalente a instanciar um novo objeto GlideDateTime usando o construtor GlideDateTime(value). Se o formato de data e hora usado não corresponder ao formato interno, o método tentará definir a data e a hora usando outros formatos disponíveis. Resolver a data e a hora dessa forma pode gerar dados imprecisos devido à ambiguidade nos valores de dia e mês. Ao usar um formato de data e hora não padrão, use setValueUTC(dateTime, format). * Um objeto GlideDateTime: define o valor do objeto como a data e a hora armazenadas pelo GlideDateTime passado no parâmetro. Usar o método dessa forma é equivalente a instanciar um novo objeto GlideDateTime usando o construtor GlideDateTime(g). * Um objeto de data Java: define o valor do objeto usando o valor armazenado pelo objeto de data Java. Usar o método dessa forma é equivalente a passar o valor retornado pelo objeto Java Date getTime() para o método GlideDateTime setNumericValue(). Este método não aceita objetos de data JavaScript. * Um número JavaScript: define o valor do objeto usando o valor do número como milissegundos após 1º de janeiro de 1970 00:00:00 UTC. Usar o método dessa forma é equivalente ao método setNumericValue(milisseconds). * Um Java inteiro ou longo: define o valor do objeto usando o valor inteiro ou longo como milissegundos após 1º de janeiro de 1970 00:00:00 UTC. Usar o método dessa forma é equivalente ao método setNumericValue(milisseconds). {#r_GDT-setValue_O__ul_j3h_4pc_nt} |
[Tabela 148. Parâmetros]

{#r_GDT-setValue_O__table_yfh_fpc_nt} {#r_GDT-setValue_O__table_zfh_fpc_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 149. Retorna]

{#r_GDT-setValue_O__table_zfh_fpc_nt}  
Defina a data e a hora usando uma cadeia de caracteres no formato aaaa-MM-dd 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());

Saída:

    2011-02-02 08:00:00

Defina a data e a hora usando um objeto GlideDateTime existente.

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

Saída:

    2017-05-23 11:37:41

Defina a data e a hora usando um número que indica milissegundos após 1º de janeiro de 1970 00:00:00 UTC.

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

Saída:

    2021-04-05 14:55:22

### Equivalente com escopo {#r_GDT-setValue_O__section_w2m_sxr_mcb}

Para usar o método setValue() em uma aplicação com escopo, use o método com escopo correspondente: [setValue()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetValue_String_o "Define a data e a hora do objeto GlideDateTime.").

## GlideDateTime - setValueUTC(cadeia de caracteres dateTime, formato de cadeia de caracteres) {#ariaid-title78}

Define um valor de data e hora usando o fuso horário UTC e o formato de data e hora especificado.
Este método lança uma exceção de tempo de execução se o formato de data e hora usado no parâmetro dateTime não corresponder ao parâmetro format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for detectada.
{#r_GDT-setValueUTC_S_S__table_p5w_35c_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Cadeia de caracteres | A data e a hora a serem usadas. |
| formato | Cadeia de caracteres | O formato a ser usado. |
[Tabela 150. Parâmetros]

{#r_GDT-setValueUTC_S_S__table_p5w_35c_nt} {#r_GDT-setValueUTC_S_S__table_q5w_35c_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 151. Retorna]

{#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());

Saída:

    2011-02-15 08:00:00

### Equivalente com escopo {#r_GDT-setValueUTC_S_S__section_ft1_qxr_mcb}

Para usar o método setValueUTC() em uma aplicação com escopo, use o método com escopo correspondente: [setValueUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format "Define um valor de data e hora usando o fuso horário UTC e o formato de data e hora especificado. Este método lançará uma exceção de tempo de execução se o formato de data e hora usado no parâmetro dt não corresponder ao parâmetro format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for detectada.").

## GlideDateTime -- setYear(Número de anos) {#ariaid-title79}

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário da máquina virtual Java.
Use setYearLocalTime() ou setYearUTC() em vez deste método.
{#r_GDT-setYear_N__table_tgf_4xl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ano | Número | O ano para o qual mudar. |
[Tabela 152. Parâmetros]

{#r_GDT-setYear_N__table_tgf_4xl_nt} {#r_GDT-setYear_N__table_ugf_4xl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 153. Retorna]

{#r_GDT-setYear_N__table_ugf_4xl_nt}  

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

Saída:

    2013

## GlideDateTime -- setYearLocalTime(Número de anos) {#ariaid-title80}

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário do usuário atual.
{#r_GDT-setYearLocalTime_N__table_vp4_1yl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ano | Número | O ano para o qual mudar. |
[Tabela 154. Parâmetros]

{#r_GDT-setYearLocalTime_N__table_vp4_1yl_nt} {#r_GDT-setYearLocalTime_N__table_wp4_1yl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 155. Retorna]

{#r_GDT-setYearLocalTime_N__table_wp4_1yl_nt}  

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

Saída:

    2013

### Equivalente com escopo {#r_GDT-setYearLocalTime_N__section_mjw_5xr_mcb}

Para usar o método setYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: [setYearLocalTime()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetYearLocalTime_Number "Define o ano armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário do usuário atual.").

## GlideDateTime -- setYearUTC(Número de ano) {#ariaid-title81}

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário UTC.
{#r_GDT-setYearUTC_N__table_fzh_jyl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ano | Número | O ano para o qual mudar. |
[Tabela 156. Parâmetros]

{#r_GDT-setYearUTC_N__table_fzh_jyl_nt} {#r_GDT-setYearUTC_N__table_gzh_jyl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 157. Retorna]

{#r_GDT-setYearUTC_N__table_gzh_jyl_nt}  

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

Saída:

    2013

### Equivalente com escopo {#r_GDT-setYearUTC_N__section_q3v_wxr_mcb}

Para usar o método setYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: [setYearUTC()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSetYearUTC_Number "Define o ano armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário UTC.").

## GlideDateTime - subtract(tempo de GlideTime) {#ariaid-title82}

Subtrai uma quantidade especificada de tempo.
{#r_GDT-subtract_GT__table_lsb_nzk_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| hora | GlideTime | O tempo para subtrair |
[Tabela 158. Parâmetros]

{#r_GDT-subtract_GT__table_lsb_nzk_nt} {#r_GDT-subtract_GT__table_msb_nzk_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 159. Retorna]

{#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());

Saída:

    1970-01-01 07:59:40

### Equivalente com escopo {#r_GDT-subtract_GT__section_ltp_byr_mcb}

Para usar o método subtract() em uma aplicação com escopo, use o método com escopo correspondente: [subtract()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSubtract_GlideTime "Subtrai uma quantidade especificada de tempo do objeto GlideDateTime atual.").

## GlideDateTime - subtract(Número milissegundos) {#ariaid-title83}

Subtrai um número especificado de milissegundos do objeto GlideDateTime.
{#r_GDT-subtract_N__table_r54_mtl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| milissegundos | Número | O número de milissegundos a serem subtraídos |
[Tabela 160. Parâmetros]

{#r_GDT-subtract_N__table_r54_mtl_nt} {#r_GDT-subtract_N__table_s54_mtl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 161. Retorna]

{#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());

Saída:

    2011-12-07 07:59:59

### Equivalente com escopo {#r_GDT-subtract_N__section_ihx_qyr_mcb}

Para usar o método subtract() em uma aplicação com escopo, use o método com escopo correspondente: [subtract()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSubtract_Number "Subtrai o número especificado de milissegundos do objeto GlideDateTime.").

## GlideDateTime - subtract (início de GlideDateTime, fim de GlideDateTime) {#ariaid-title84}

Retorna a diferença de duração entre dois objetos GlideDateTime especificados.
{#r_GDT-subtract_GDT_GDT__table_gn2_grl_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| iniciar | GlideDateTime | Objeto de data de início. |
| terminar | GlideDateTime | Objeto de data de término. |
[Tabela 162. Parâmetros]

{#r_GDT-subtract_GDT_GDT__table_gn2_grl_nt} {#r_GDT-subtract_GDT_GDT__table_hn2_grl_nt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDuration | Diferença de duração entre as duas datas especificadas. |
[Tabela 163. Retorna]

{#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());

Saída:

    2 Days 23 Hours

### Equivalente com escopo {#r_GDT-subtract_GDT_GDT__section_apm_zxr_mcb}

Para usar o método subtract() em uma aplicação com escopo, use o método com escopo correspondente: [subtract()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time "Retorna a diferença de duração entre dois objetos GlideDateTime especificados.").

## GlideDateTime -- toString() {#ariaid-title85}

Retorna o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss, e o fuso horário do sistema, UTC por padrão.
Este método é equivalente a getValue().
{#r_GDT-toString__table_lyw_ls2_nt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 164. Parâmetros]

{#r_GDT-toString__table_lyw_ls2_nt} {#r_GDT-toString__table_myw_ls2_nt__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | A data e a hora armazenadas pelo objeto GlideDateTime no fuso horário e no formato do sistema. |
[Tabela 165. Retorna]

{#r_GDT-toString__table_myw_ls2_nt}  

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

Saída:

    2011-08-31 08:00:00

### Equivalente com escopo {#r_GDT-toString__section_fxf_tyr_mcb}

Para usar o método toString() em uma aplicação com escopo, use o método com escopo correspondente: [toString()](https://servicenow-prod.fluidtopics.net/rM63LHg6OGy~hBdWP_QdHA#r_ScopedGlideDateTimeToString "Obtém o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss, e o fuso horário do sistema, UTC por padrão. Este método é equivalente a getValue().").