---
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 - com escopo

# GlideDateTime - com escopo {#ariaid-title1}

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

A classe GlideDateTime com escopo 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 com escopo -- GlideDateTime() {#ariaid-title2}

Instancia um novo objeto GlideDateTime com a data e hora atuais.
{#r_ScopedGlideDateTimeGlideDateTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGlideDateTime__table_vy2_525_jq}  
Este exemplo instancia um objeto GlideDateTime.

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

Saída:

    2022-08-08 16:51:44

## GlideDateTime com escopo - GlideDateTime (valor de cadeia de caracteres) {#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_ScopedGlideDateTimeGlideDateTime_String_value__ul_xgq_hmz_lnb}  
Nota:  
O seguinte formato não é compatível:

* aaaa-MM-dd'T'HH:mm:ss.SSSZ
{#r_ScopedGlideDateTimeGlideDateTime_String_value__ul_udg_d5w_lcc}
{#r_ScopedGlideDateTimeGlideDateTime_String_value__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGlideDateTime_String_value__table_vy2_525_jq}  

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

Saída:

    2023-01-01 12:00:00

## GlideDateTime com escopo - GlideDateTime(GlideDateTime g) {#ariaid-title4}

Instancia um novo objeto GlideDateTime definido com a hora de um objeto GlideDateTime especificado.
{#r_ScopedGlideDateTimeGlideDateTime_GlideDateTime_g__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGlideDateTime_GlideDateTime_g__table_vy2_525_jq}  
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 com escopo - add(GlideTime gd) {#ariaid-title5}

Adiciona um objeto GlideTime ao objeto GlideDateTime atual.
{#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gd | GlideTime | Objeto GlideTime cujo valor de tempo será adicionado ao objeto GlideDateTime especificado. |
[Tabela 4. Parâmetros]

{#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_vy2_525_jq} {#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Retorna]

{#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.add(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

Saída:

    08:00:20

## GlideDateTime com escopo - add(Número milissegundos) {#ariaid-title6}

Adiciona o número especificado de milissegundos ao objeto GlideDateTime atual.
{#r_ScopedGlideDateTimeAdd_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAdd_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAdd_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 7. Retorna]

{#r_ScopedGlideDateTimeAdd_Number__table_qpt_3f5_jq}  

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

Saída:

    1314777600000 1314777600010

## GlideDateTime com escopo - addDaysLocalTime(Number days) {#ariaid-title7}

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_ScopedGlideDateTimeAddDaysLocalTime_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddDaysLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddDaysLocalTime_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 9. Retorna]

{#r_ScopedGlideDateTimeAddDaysLocalTime_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-08-30

## GlideDateTime com escopo -- addDaysUTC(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 UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora UTC.
{#r_ScopedGlideDateTimeAddDaysUTC_Number__table_vy2_525_jq__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 10. Parâmetros]

{#r_ScopedGlideDateTimeAddDaysUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddDaysUTC_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 11. Retorna]

{#r_ScopedGlideDateTimeAddDaysUTC_Number__table_qpt_3f5_jq}  

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

Saída:

     2011-08-30

## GlideDateTime com escopo - addMonthsLocalTime(Número de meses) {#ariaid-title9}

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_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 13. Retorna]

{#r_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-10-31

## GlideDateTime com escopo -- addMonthsUTC(Número de meses) {#ariaid-title10}

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_ScopedGlideDateTimeAddMonthsUTC_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddMonthsUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddMonthsUTC_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 15. Retorna]

{#r_ScopedGlideDateTimeAddMonthsUTC_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-10-31

## GlideDateTime com escopo - addSeconds (Número de segundos) {#ariaid-title11}

Adiciona o número especificado de segundos ao objeto GlideDateTime atual.
{#r_ScopedGlideDateTimeAddSeconds_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddSeconds_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddSeconds_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 17. Retorna]

{#r_ScopedGlideDateTimeAddSeconds_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-12-07 08:16:40

## GlideDateTime com escopo - 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_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 19. Retorna]

{#r_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-08-24

## GlideDateTime com escopo - 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_ScopedGlideDateTimeAddWeeksUTC_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddWeeksUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddWeeksUTC_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 21. Retorna]

{#r_ScopedGlideDateTimeAddWeeksUTC_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-08-24

## GlideDateTime com escopo - addYearsLocalTime(Número de anos) {#ariaid-title14}

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_ScopedGlideDateTimeAddYearsLocalTime_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddYearsLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddYearsLocalTime_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 23. Retorna]

{#r_ScopedGlideDateTimeAddYearsLocalTime_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-08-31

## GlideDateTime com escopo - addYearsUTC(Número de anos) {#ariaid-title15}

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_ScopedGlideDateTimeAddYearsUTC_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddYearsUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddYearsUTC_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 25. Retorna]

{#r_ScopedGlideDateTimeAddYearsUTC_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-08-31

## GlideDateTime com escopo - depois (GlideDateTime gdt) {#ariaid-title16}

Determina se a data e a hora do objeto GlideDateTime ocorrem após a data e a hora do objeto especificado.
{#r_SGDT-after_GDT__table_op2_nqq_yv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gdt | GlideDateTime | Data e hora de verificação. |
[Tabela 26. Parâmetros]

{#r_SGDT-after_GDT__table_op2_nqq_yv} {#r_SGDT-after_GDT__table_pp2_nqq_yv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se a data e a hora do objeto GlideDateTime são posteriores à data e hora especificadas pelo parâmetro. Valores possíveis: * verdadeiro: a data e a hora do objeto GlideDateTime são posteriores à data e hora do objeto especificado. * falso: data e hora do objeto GlideDateTime são anteriores ou iguais à data e hora do objeto especificado. {#r_SGDT-after_GDT__ul_xcn_m2j_zpb} |
[Tabela 27. Retorna]

{#r_SGDT-after_GDT__table_pp2_nqq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.after(gdt2)); 

Saída:

    False

## GlideDateTime com escopo - before(GlideDateTime gdt) {#ariaid-title17}

Determina se a data e a hora do objeto GlideDateTime ocorrem antes da data e hora do objeto GlideDateTime especificado.
{#r_SGDT-before_GDT__table_j5h_vrq_yv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gdt | GlideDateTime | Data e hora de verificação. |
[Tabela 28. Parâmetros]

{#r_SGDT-before_GDT__table_j5h_vrq_yv} {#r_SGDT-before_GDT__table_k5h_vrq_yv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se a data e a hora do objeto GlideDateTime são anteriores à data e hora especificadas pelo parâmetro. Valores possíveis: * verdadeiro: data e hora do objeto GlideDateTime são anteriores à data e hora especificadas. * falso: data e hora do objeto GlideDateTime são posteriores ou iguais às data e hora especificadas. {#r_SGDT-before_GDT__ul_xcn_m2j_zpb} |
[Tabela 29. Retorna]

{#r_SGDT-before_GDT__table_k5h_vrq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.before(gdt2));  

Saída

    true

## GlideDateTime com escopo -- compareTo(Object o) {#ariaid-title18}

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

| Nome | Tipo | Descrição |
|-|-|-|
| o | Objeto | Objeto de data e hora no formato GlideDateTime |
[Tabela 30. Parâmetros]

{#r_ScopedGlideDateTimeCompareTo_Object_o__table_vy2_525_jq} {#r_ScopedGlideDateTimeCompareTo_Object_o__table_qpt_3f5_jq__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_ScopedGlideDateTimeCompareTo_Object_o__ul_tb3_mjg_sz} |
[Tabela 31. Retorna]

{#r_ScopedGlideDateTimeCompareTo_Object_o__table_qpt_3f5_jq}  

    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

## GlideDateTime com escopo - é igual a (Data/hora do objeto) {#ariaid-title19}

Compara uma data/hora com um valor existente de igualdade.
{#r_ScopedGlideDateTimeEquals_Object__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| data/hora | Objeto GlideDateTime ou cadeia de caracteres | A data/hora a ser comparada. |
[Tabela 32. Parâmetros]

{#r_ScopedGlideDateTimeEquals_Object__table_vy2_525_jq} {#r_ScopedGlideDateTimeEquals_Object__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeEquals_Object__table_qpt_3f5_jq}  

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

Saída:

    false

## GlideDateTime com escopo -- getDate() {#ariaid-title20}

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

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

{#r_ScopedGlideDateTimeGetDate__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDate__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Data no fuso horário do sistema. |
[Tabela 35. Retorna]

{#r_ScopedGlideDateTimeGetDate__table_qpt_3f5_jq}  

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

Saída:

    2011-08-31

## GlideDateTime com escopo -- getDayOfMonthLocalTime() {#ariaid-title21}

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

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

{#r_ScopedGlideDateTimeGetDayOfMonthLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfMonthLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDayOfMonthLocalTime__table_qpt_3f5_jq}  

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

Saída:

    2

## GlideDateTime com escopo -- getDayOfMonthUTC() {#ariaid-title22}

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

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

{#r_ScopedGlideDateTimeGetDayOfMonthUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfMonthUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDayOfMonthUTC__table_qpt_3f5_jq}  

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

Saída:

    02

## GlideDateTime com escopo -- getDayOfWeekLocalTime() {#ariaid-title23}

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

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

{#r_ScopedGlideDateTimeGetDayOfWeekLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfWeekLocalTime__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor do dia da semana, no fuso horário do usuário, de 1 a 7. Segunda-feira é igual a 1, domingo é igual a 7. |
[Tabela 41. Retorna]

{#r_ScopedGlideDateTimeGetDayOfWeekLocalTime__table_qpt_3f5_jq}  

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

Saída:

    4

## GlideDateTime com escopo -- getDayOfWeekUTC() {#ariaid-title24}

Retorna o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor do dia da semana de 1 a 7. Segunda-feira é igual a 1, domingo é igual a 7. |
[Tabela 43. Retorna]

{#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_qpt_3f5_jq}  

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

Saída:

    4

## GlideDateTime com escopo -- getDaysInMonthLocalTime() {#ariaid-title25}

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

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

{#r_ScopedGlideDateTimeGetDaysInMonthLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDaysInMonthLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDaysInMonthLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
    gs.info(gdt.getDaysInMonthLocalTime());

Saída:

    30

## GlideDateTime com escopo -- getDaysInMonthUTC() {#ariaid-title26}

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

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

{#r_ScopedGlideDateTimeGetDaysInMonthUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDaysInMonthUTC__table_qpt_3f5_jq__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 47. Retorna]

{#r_ScopedGlideDateTimeGetDaysInMonthUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getDaysInMonthUTC());

Saída:

    30

## GlideDateTime com escopo -- getDisplayValue() {#ariaid-title27}

Obtém o valor de data e hora no formato de exibição e fuso horário do usuário atual.
{#r_ScopedGlideDateTimeGetDisplayValue__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | 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 49. Retorna]

{#r_ScopedGlideDateTimeGetDisplayValue__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)

Saída:

    2011-08-31 01:00:00

## GlideDateTime com escopo -- getDisplayValueInternal() {#ariaid-title28}

Obtém o valor de exibição no formato interno (aaaa-MM-dd HH:mm:ss).
{#r_ScopedGlideDateTimeGetDisplayValueInternal__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Os valores de data e hora do objeto GlideDateTime no fuso horário do usuário atual e o formato interno de data e hora de `aaaa-MM-dd HH:mm:ss`. |
[Tabela 51. Retorna]

{#r_ScopedGlideDateTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00"); 
    gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)

Saída:

    2011-08-31 01:00:00

## GlideDateTime com escopo - getDisplayValueLang (estilo de cadeia de caracteres, idioma de cadeia de caracteres) {#ariaid-title29}

Retorna um valor de data e hora na localidade dos usuários atuais de acordo com um idioma e estilo de data especificados.
{#r_SGDT-getDisplayValueLang_S_S__id_wvq_jww_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 52. Parâmetros]

{#r_SGDT-getDisplayValueLang_S_S__id_wvq_jww_dwb} {#r_SGDT-getDisplayValueLang_S_S__id_sdf_kww_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 53. Retorna]

{#r_SGDT-getDisplayValueLang_S_S__id_sdf_kww_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 com escopo -- getDSTOffset() {#ariaid-title30}

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

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

{#r_ScopedGlideDateTimeGetDSTOffset__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDSTOffset__table_qpt_3f5_jq__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 55. Retorna]

{#r_ScopedGlideDateTimeGetDSTOffset__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
    gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

Saída:

    3600000

## GlideDateTime com escopo -- getErrorMsg() {#ariaid-title31}

Obtém a mensagem de erro atual.
{#r_ScopedGlideDateTimeGetErrorMsg__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetErrorMsg__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetErrorMsg__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetErrorMsg__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime(); 
    gdt.setDisplayValue("2011-aa-01 00:00:00"); 
    gs.info(gdt.getErrorMsg());

Saída:

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

## GlideDateTime com escopo -- getInternalFormattedLocalTime() {#ariaid-title32}

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

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

{#r_SGDT-getInternalFormattedLocalTime__table_lvp_5vc_kw} {#r_SGDT-getInternalFormattedLocalTime__table_mvp_5vc_kw__entry__2}

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

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

## GlideDateTime com escopo -- getLocalDate() {#ariaid-title33}

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_ScopedGlideDateTimeGetLocalDate__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetLocalDate__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetLocalDate__table_qpt_3f5_jq__entry__2}

| Tipo |   |
|-|-|
| GlideDate | A data no fuso horário do usuário. |
[Tabela 61. Retorna]

{#r_ScopedGlideDateTimeGetLocalDate__table_qpt_3f5_jq}  

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

Saída:

    2011-08-31

## GlideDateTime com escopo -- getLocalTime() {#ariaid-title34}

Retorna um objeto GlideTime que representa a parte de tempo do objeto GlideDateTime no fuso horário do usuário.
{#r_ScopedGlideDateTimeGetLocalTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gt = gdt.getLocalTime();
    gs.info("local time is " + gt.getByFormat('hh:mm:ss'));

Saída:

    local time is 01:00:00

## GlideDateTime com escopo -- getMonthLocalTime() {#ariaid-title35}

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

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

{#r_ScopedGlideDateTimeGetMonthLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetMonthLocalTime__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor numérico do mês. |
[Tabela 65. Retorna]

{#r_ScopedGlideDateTimeGetMonthLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getMonthLocalTime());

Saída:

    11

## GlideDateTime com escopo -- getMonthUTC() {#ariaid-title36}

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

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

{#r_ScopedGlideDateTimeGetMonthUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetMonthUTC__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor numérico do mês. |
[Tabela 67. Retorna]

{#r_ScopedGlideDateTimeGetMonthUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getMonthUTC());

Saída:

    11

## GlideDateTime com escopo -- getNumericValue() {#ariaid-title37}

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

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

{#r_ScopedGlideDateTimeNumericValue__table_vy2_525_jq} {#r_ScopedGlideDateTimeNumericValue__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeNumericValue__table_qpt_3f5_jq}  

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

Saída:

    1314777600000

## GlideDateTime com escopo -- getTime() {#ariaid-title38}

Retorna um objeto GlideTime que representa a parte de tempo do objeto GlideDateTime.
{#r_ScopedGlideDateTimeGetTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gt = gdt.getTime();
    gs.info(gt.getByFormat('hh:mm:ss'));

Saída:

    08:00:00

## GlideDateTime com escopo -- getTZOffset() {#ariaid-title39}

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

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

{#r_ScopedGlideDateTimeGetTZOffset__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetTZOffset__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetTZOffset__table_qpt_3f5_jq}  

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

Saída:

    -25200000

## GlideDateTime com escopo -- getUserFormattedLocalTime() {#ariaid-title40}

Retorna a hora do objeto no fuso horário local e no formato do usuário.
{#r_SGDT-getUserFormattedLocalTime__table_ddv_fvc_kw__entry__3}

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

{#r_SGDT-getUserFormattedLocalTime__table_ddv_fvc_kw} {#r_SGDT-getUserFormattedLocalTime__table_edv_fvc_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A hora do objeto no fuso horário local e no formato do usuário. |
[Tabela 75. Retorna]

{#r_SGDT-getUserFormattedLocalTime__table_edv_fvc_kw}  
Este exemplo mostra a hora do objeto no fuso horário local.

    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

## GlideDateTime com escopo -- getValue() {#ariaid-title41}

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_ScopedGlideDateTimeGetValue__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetValue__table_qpt_3f5_jq__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 77. Retorna]

{#r_ScopedGlideDateTimeGetValue__table_qpt_3f5_jq}  

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

Saída:

    2014-08-31 08:00:00

## GlideDateTime com escopo -- getWeekOfYearLocalTime() {#ariaid-title42}

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_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_qpt_3f5_jq__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 79. Retorna]

{#r_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
    gs.info(gdt.getWeekOfYearLocalTime());

Saída:

    49

## GlideDateTime com escopo -- getWeekOfYearUTC() {#ariaid-title43}

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_ScopedGlideDateTimeGetWeekOfYearUTC__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetWeekOfYearUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetWeekOfYearUTC__table_qpt_3f5_jq__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 81. Retorna]

{#r_ScopedGlideDateTimeGetWeekOfYearUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
    gs.info(gdt.getWeekOfYearUTC());

Saída:

    49

## GlideDateTime com escopo -- getYearLocalTime() {#ariaid-title44}

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

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

{#r_ScopedGlideDateTimeGetYearLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetYearLocalTime__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor de ano de quatro dígitos no fuso horário do usuário. |
[Tabela 83. Retorna]

{#r_ScopedGlideDateTimeGetYearLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00");
    gs.info(gdt.getYearLocalTime());

Saída:

    2011

## GlideDateTime com escopo -- getYearUTC() {#ariaid-title45}

Obtém o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.
{#r_ScopedGlideDateTimeGetYearUTC__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetYearUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetYearUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetYearUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
    gs.info(gdt.getYearUTC());

Saída:

    2011

## GlideDateTime com escopo - hasDate() {#ariaid-title46}

Determina se a data de um objeto está definida.
{#r_ScopedGlideDateTimeHasDate__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeHasDate__table_vy2_525_jq} {#r_ScopedGlideDateTimeHasDate__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeHasDate__table_qpt_3f5_jq}  

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

Saída:

    true

## GlideDateTime com escopo - isDST() {#ariaid-title47}

Determina se a hora de um objeto usa um deslocamento de horário de verão.
{#r_ScopedGlideDateTimeIsDST__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeIsDST__table_vy2_525_jq} {#r_ScopedGlideDateTimeIsDST__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeIsDST__table_qpt_3f5_jq}  

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

Saída:

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

## GlideDateTime com escopo - isValid() {#ariaid-title48}

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

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

{#r_ScopedGlideDateTimeIsValid__table_vy2_525_jq} {#r_ScopedGlideDateTimeIsValid__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeIsValid__table_qpt_3f5_jq}  

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

Saída:

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

## GlideDateTime com escopo - onOrAfter(GlideDateTime gdt) {#ariaid-title49}

Determina se a data e a hora do objeto GlideDateTime ocorrem em ou após a data e hora do objeto GlideDateTime especificado.
{#r_SGDT-onOrAfter_GDT__table_sst_nsq_yv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gdt | GlideDateTime | Data e hora de verificação. |
[Tabela 92. Parâmetros]

{#r_SGDT-onOrAfter_GDT__table_sst_nsq_yv} {#r_SGDT-onOrAfter_GDT__table_tst_nsq_yv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se a data e a hora do objeto GlideDateTime são em ou após a data e a hora especificadas pelo parâmetro. Valores possíveis: * verdadeiro: a data e hora do objeto GlideDateTime são em ou após a data e hora do objeto especificado. * falso: data e hora do objeto GlideDateTime são anteriores à data e hora do objeto especificado. {#r_SGDT-onOrAfter_GDT__ul_xcn_m2j_zpb} |
[Tabela 93. Retorna]

{#r_SGDT-onOrAfter_GDT__table_tst_nsq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.onOrAfter(gdt2));   

Saída

    false

## GlideDateTime com escopo - onOrBefore(GlideDateTime gdt) {#ariaid-title50}

Determina se a data e a hora do objeto GlideDateTime ocorrem em ou antes da data e hora do objeto GlideDateTime especificado.
{#r_SGDT-onOrBefore_GDT__table_srp_2tq_yv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gdt | GlideDateTime | Data e hora de verificação. |
[Tabela 94. Parâmetros]

{#r_SGDT-onOrBefore_GDT__table_srp_2tq_yv} {#r_SGDT-onOrBefore_GDT__table_trp_2tq_yv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se a data e a hora do objeto GlideDateTime estão em ou antes da data e hora especificadas pelo parâmetro. Valores possíveis: * verdadeiro: data e hora do objeto GlideDateTime é igual ou anterior à data e hora do objeto especificado. * falso: a data e a hora do objeto GlideDateTime são posteriores à data e hora do objeto especificado. {#r_SGDT-onOrBefore_GDT__ul_xcn_m2j_zpb} |
[Tabela 95. Retorna]

{#r_SGDT-onOrBefore_GDT__table_trp_2tq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.onOrBefore(gdt2));   

Saída

    true

## GlideDateTime com escopo -- setDayOfMonthLocalTime(Number day) {#ariaid-title51}

Define o dia do mês com um valor especificado no fuso horário do usuário atual.
{#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_vy2_525_jq__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 96. Parâmetros]

{#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 97. Retorna]

{#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_qpt_3f5_jq}  

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

Saída:

    9

## GlideDateTime com escopo -- setDayOfMonthUTC(Número de dias) {#ariaid-title52}

Define o dia do mês com um valor especificado no fuso horário UTC.
{#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_vy2_525_jq__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 98. Parâmetros]

{#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 99. Retorna]

{#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_qpt_3f5_jq}  

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

Saída:

    9

## GlideDateTime com escopo - setDisplayValue(String asDisplayed) {#ariaid-title53}

Define um valor de data e hora usando o formato de exibição e o fuso horário do usuário atual.
{#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_vy2_525_jq__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 a <var class="keyword varname">variável</var> `.setDisplayValue(gs.nowDateTime);`. |
[Tabela 100. Parâmetros]

{#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 101. Retorna]

{#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-02-02 12:00:00");
    gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific) 
    gs.info(gdt.getValue());

Saída:

    2014-01-01 20:00:00

## GlideDateTime com escopo - setDisplayValue (valor de cadeia de caracteres, formato de cadeia de caracteres) {#ariaid-title54}

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çará uma exceção de tempo de execução se o formato de data e hora usado no parâmetro value 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_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Cadeia de caracteres | Data e hora no fuso horário do usuário atual. |
| formato | Cadeia de caracteres | Formato de data e hora a ser usado para analisar o parâmetro value. Use os seguintes valores para descrever o parâmetro value : * dd: dia do mês * MM: mês do ano * aaaa: ano * HH: hora * mm: minutos * ss: segundos {#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__ul_h13_nvr_ckb} Por exemplo: "dd-MM-yyyy HH:mm:ss" ou "MM-dd-yyyy HH:mm". |
[Tabela 102. Parâmetros]

{#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 103. Retorna]

{#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-02-02 12:00:00");
    gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
    gs.info(gdt.getValue());

Saída

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

## GlideDateTime com escopo -- setDisplayValueInternal(String value) {#ariaid-title55}

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_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 105. Retorna]

{#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-02-02 12:00:00");
    gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
    gs.info(gdt.getValue());

Saída:

    2014-01-01 20:00:00

## GlideDateTime com escopo - setDisplayValueLang(cadeia de caracteres dateTime, estilo de cadeia de caracteres) {#ariaid-title56}

Define uma data e hora usando um estilo e formato especificados de acordo com a localidade do usuário atual.
{#r_SGDT-setDisplayValueLang_S_S__id_wc2_nww_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 106. Parâmetros]

{#r_SGDT-setDisplayValueLang_S_S__id_wc2_nww_dwb} {#r_SGDT-setDisplayValueLang_S_S__id_srr_nww_dwb__entry__2}

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

{#r_SGDT-setDisplayValueLang_S_S__id_srr_nww_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 com escopo - setDisplayValueLang(cadeia de caracteres dateTime, estilo de cadeia de caracteres, idioma de cadeia de caracteres) {#ariaid-title57}

Define uma data e hora usando um estilo, idioma e formato especificados de acordo com a localidade do usuário atual.
{#r_SGDT-setDisplayValueLang_S_S_S__id_sgm_qww_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 108. Parâmetros]

{#r_SGDT-setDisplayValueLang_S_S_S__id_sgm_qww_dwb} {#r_SGDT-setDisplayValueLang_S_S_S__id_nst_qww_dwb__entry__2}

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

{#r_SGDT-setDisplayValueLang_S_S_S__id_nst_qww_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 com escopo - setGlideDateTime(GlideDateTime g) {#ariaid-title58}

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_ScopedGlideDateTimeSetGlideDateTime_g__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| g | GlideDateTime | O objeto a ser usado para definir o valor de data/hora. |
[Tabela 110. Parâmetros]

{#r_ScopedGlideDateTimeSetGlideDateTime_g__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetGlideDateTime_g__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 111. Retorna]

{#r_ScopedGlideDateTimeSetGlideDateTime_g__table_qpt_3f5_jq}  

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

Saída:

    2011-02-02 08:00:00

## GlideDateTime com escopo -- setMonthLocalTime(Number month) {#ariaid-title59}

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

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

{#r_ScopedGlideDateTimeSetMonthLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetMonthLocalTime_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 113. Retorna]

{#r_ScopedGlideDateTimeSetMonthLocalTime_Number__table_qpt_3f5_jq}  

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

Saída:

    1

## GlideDateTime com escopo -- setMonthUTC(Número de meses) {#ariaid-title60}

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

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

{#r_ScopedGlideDateTimeSetMonthUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetMonthUTC_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 115. Retorna]

{#r_ScopedGlideDateTimeSetMonthUTC_Number__table_qpt_3f5_jq}  

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

Saída:

    1

## GlideDateTime com escopo - setValue(String o) {#ariaid-title61}

Define a data e a hora do objeto GlideDateTime.
{#r_ScopedGlideDateTimeSetValue_String_o__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| o | Cadeia de caracteres | 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 de 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(String 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(String dt, String 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 (GlideDateTime g). * Um número JavaScript. Define o valor do objeto usando o valor de Número como milissegundos após 1º de janeiro de 1970 00:00:00 UTC. {#r_ScopedGlideDateTimeSetValue_String_o__ul_jp2_mhc_fr} |
[Tabela 116. Parâmetros]

{#r_ScopedGlideDateTimeSetValue_String_o__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetValue_String_o__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 117. Retorna]

{#r_ScopedGlideDateTimeSetValue_String_o__table_qpt_3f5_jq}  

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

Saída:

    2011-02-02 08:00:00

## GlideDateTime com escopo - setValueUTC(cadeia de caracteres dt, formato de cadeia de caracteres) {#ariaid-title62}

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

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

{#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 119. Retorna]

{#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-01-01 12:00:00");
    gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
    gs.info(gdt.getValue());

Saída:

    2011-02-15 08:00:00

## GlideDateTime com escopo - setYearLocalTime(Número de anos) {#ariaid-title63}

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

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

{#r_ScopedGlideDateTimeSetYearLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetYearLocalTime_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 121. Retorna]

{#r_ScopedGlideDateTimeSetYearLocalTime_Number__table_qpt_3f5_jq}  

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

Saída:

    2013

## GlideDateTime com escopo - setYearUTC(Número de ano) {#ariaid-title64}

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

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

{#r_ScopedGlideDateTimeSetYearUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetYearUTC_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 123. Retorna]

{#r_ScopedGlideDateTimeSetYearUTC_Number__table_qpt_3f5_jq}  

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

Saída:

    2013

## GlideDateTime com escopo - subtract(GlideTime time) {#ariaid-title65}

Subtrai uma quantidade especificada de tempo do objeto GlideDateTime atual.
{#r_ScopedGlideDateTimeSubtract_GlideTime__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| hora | GlideTime | O valor de tempo a ser subtraído. |
[Tabela 124. Parâmetros]

{#r_ScopedGlideDateTimeSubtract_GlideTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeSubtract_GlideTime__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 125. Retorna]

{#r_ScopedGlideDateTimeSubtract_GlideTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.subtract(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

Saída:

    07:59:40

## GlideDateTime com escopo - subtract(Número milissegundos) {#ariaid-title66}

Subtrai o número especificado de milissegundos do objeto GlideDateTime.
{#r_ScopedGlideDateTimeSubtract_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeSubtract_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSubtract_Number__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 127. Retorna]

{#r_ScopedGlideDateTimeSubtract_Number__table_qpt_3f5_jq}  

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

Saída:

    2011-12-07 07:59:59

## GlideDateTime com escopo - subtract (início de GlideDateTime, fim de GlideDateTime) {#ariaid-title67}

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

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

{#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time__table_vy2_525_jq} {#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time__table_qpt_3f5_jq}  

    var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
    var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
     
    var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
    gs.info(dur.getDisplayValue());

Saída:

    2 Days 23 Hours

## GlideDateTime com escopo - toString() {#ariaid-title68}

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().
{#r_ScopedGlideDateTimeToString__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeToString__table_vy2_525_jq} {#r_ScopedGlideDateTimeToString__table_qpt_3f5_jq__entry__2}

| Tipo |   |
|-|-|
| Cadeia de caracteres | A data e a hora armazenadas pelo objeto GlideDateTime no fuso horário e no formato do sistema. |
[Tabela 131. Retorna]

{#r_ScopedGlideDateTimeToString__table_qpt_3f5_jq}  

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

Saída:

    2011-08-31 08:00:00