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


---

# GlideDate - com escopo

# GlideDate - 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) 7 min. de leitura

A classe GlideDate com escopo fornece métodos para executar operações em objetos GlideDate, como instanciar objetos GlideDate ou trabalhar com campos GlideDate.

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

## GlideDate com escopo - GlideDate() {#ariaid-title2}

Cria um objeto GlideDate com a data e hora atuais.
{#r_ScopedGlideDateGlideDate__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateGlideDate__table_vy2_525_jq}  

    //Today's date is April 21, 2021
    var gd = new GlideDate();
    gs.info(gd.getValue());

Saída:

    2021-04-21

## GlideDate com escopo -- getByFormat(formato de cadeia de caracteres) {#ariaid-title3}

Obtém a data no formato de data especificado.
{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| formato | Cadeia de caracteres | Formato de data desejado usando Java [SimpleDateFormat](https://docs.oracle.com/javase/10/docs/api/java/text/SimpleDateFormat.html). Por exemplo, `"dd-MM-yyyy"` para obter o dia, o mês e o ano ou `"EEEE"` para obter o dia da semana. |
[Tabela 2. Parâmetros]

{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de data para o objeto GlideDate no formato especificado. |
[Tabela 3. Retorna]

{#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getByFormat("dd-MM-yyyy"));

Saída:

    21-04-2021

## GlideDate com escopo -- getDayOfMonthNoTZ() {#ariaid-title4}

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

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

{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv} {#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv__entry__2}

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

{#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv}  

    //Today's date is 2016-05-13 
    var gd =new GlideDate();
    gs.info(gd.getDayOfMonthNoTZ());

Saída:

    13

## GlideDate com escopo - getDisplayValue() {#ariaid-title5}

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

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

{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de data para o objeto GlideDate no formato de exibição e fuso horário do usuário atual. 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 7. Retorna]

{#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getDisplayValue());

Saída:

    2021-04-21

## GlideDate com escopo - getDisplayValueInternal() {#ariaid-title6}

Obtém a data no formato interno (aaaa-MM-dd) e o fuso horário do usuário atual.
{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq__entry__3}

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

{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de data para o objeto GlideDate no fuso horário do usuário atual. Formato: aaaa-MM-dd |
[Tabela 9. Retorna]

{#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gs.info(gd.getDisplayValueInternal());

Saída:

    2021-04-21

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

Retorna o valor de data na localidade do usuário de acordo com um idioma e estilo de data especificados.
{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| estilo | Cadeia de caracteres | 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 passado, o padrão da API será `médio`. 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 10. Parâmetros]

{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb} {#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Data no estilo e idioma especificados de acordo com a localidade do usuário atual. |
[Tabela 11. Retorna]

{#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb}  
O exemplo a seguir retorna a data da localidade do usuário em vários idiomas e estilos.

    var gd = new GlideDate(); // This will fetch the current date


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

    gs.info('date: ' + gd.getDisplayValueLang("full", "fr"));
    gs.info('date: ' + gd.getDisplayValueLang("long", "en-GB"));
    gs.info('date: ' + gd.getDisplayValueLang("medium", "de"));
    gs.info('date: ' + gd.getDisplayValueLang("short", "es-MX"));

Saída:


    date: 2023-01-18
    date: mercredi 18 janvier 2023
    date: 18 January 2023
    date: 18.01.2023
    date: 18/01/23

## GlideDate com escopo - getMonthNoTZ() {#ariaid-title8}

Obtém o mês armazenado pelo objeto GlideDate, expresso no fuso horário UTC.
{#r_SGD-getMonthNoTZ__table_az1_3wq_yv__entry__3}

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

{#r_SGD-getMonthNoTZ__table_az1_3wq_yv} {#r_SGD-getMonthNoTZ__table_bz1_3wq_yv__entry__2}

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

{#r_SGD-getMonthNoTZ__table_bz1_3wq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getMonthNoTZ());

Saída:

    5

## GlideDate com escopo - getValue() {#ariaid-title9}

Obtém a data no formato interno (aaaa-MM-dd) e o fuso horário do sistema (UTC por padrão).
{#r_ScopedGlideDateGetValue__table_vy2_535_jq__entry__3}

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

{#r_ScopedGlideDateGetValue__table_vy2_535_jq} {#r_ScopedGlideDateGetValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O valor de data do objeto GlideDate no fuso horário do sistema. Formato: aaaa-MM-dd |
[Tabela 15. Retorna]

{#r_ScopedGlideDateGetValue__table_qpt_3f5_jq}  

    var gd = new GlideDate();
    gd.setValue('2021-04-21');
    gs.info(gd.getValue());

Saída:

    2021-04-21

## GlideDate com escopo - getYearNoTZ() {#ariaid-title10}

Obtém o ano armazenado pelo objeto GlideDate, expresso no fuso horário UTC.
{#r_SGD-getYearNoTZ__table_pnp_hxq_yv__entry__3}

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

{#r_SGD-getYearNoTZ__table_pnp_hxq_yv} {#r_SGD-getYearNoTZ__table_qnp_hxq_yv__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor numérico do ano. |
[Tabela 17. Retorna]

{#r_SGD-getYearNoTZ__table_qnp_hxq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getYearNoTZ());

Saída:

    2016

## GlideDate com escopo - setDisplayValue(String asDisplayed) {#ariaid-title11}

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

| Nome | Tipo | Descrição |
|-|-|-|
| comoExibido | Cadeia de caracteres | Data no formato de exibição e fuso horário do usuário atual. Formato: deve ser formatado usando o formato de exibição preferencial do usuário atual, como aaaa-MM-dd. |
[Tabela 18. Parâmetros]

{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate();
    gd.setDisplayValue("2011-01-01");
    gs.info(gd.getValue());

Saída:

    2011-01-01

## GlideDate com escopo - setDisplayValueLang(cadeia de caracteres data, estilo de cadeia de caracteres) {#ariaid-title12}

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

| Nome | Tipo | Descrição |
|-|-|-|
| data | Cadeia de caracteres | Valor de data para o 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, idioma de cadeia de caracteres) anterior neste tópico, 25 de outubro de 2022 ou 25.10.2022 são valores aceitos. |
| estilo | Cadeia de caracteres | 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 passado, o padrão da API será `médio`. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas. |
[Tabela 20. Parâmetros]

{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb} {#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb__entry__2}

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

{#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb}  
O exemplo a seguir mostra como você pode definir a data atual da localidade do usuário como o estilo "completo" usando setDisplayValueLang().

    glideDate.setDisplayValueLang("2/3/2023", "short");


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

Saída:

    date: 2023-02-03
    date: Friday, February 3, 2023

## GlideDate com escopo - setDisplayValueLang(cadeia de caracteres data, estilo de cadeia de caracteres, idioma de cadeia de caracteres) {#ariaid-title13}

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

| Nome | Tipo | Descrição |
|-|-|-|
| data | Cadeia de caracteres | Valor de data para o 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, idioma de cadeia de caracteres) anterior neste tópico, 25 de outubro de 2022 ou 25.10.2022 são valores aceitos. |
| estilo | Cadeia de caracteres | 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 passado, o padrão da API será `médio`. 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 22. Parâmetros]

{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb} {#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb__entry__2}

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

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

    glideDateUS.setDisplayValueLang("2/3/202", "short", "en-US" );
    glideDateFR.setDisplayValueLang("2/3/2023", "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
    en-US date: Friday, February 3, 2023
    fr-FR date: 2023-03-02
    fr-FR date: Thursday, March 2, 2023

## GlideDate com escopo - setValue(String o) {#ariaid-title14}

Define a data do objeto GlideDate atual no formato interno (aaaa-MM-dd) e o fuso horário do sistema (UTC por padrão).
{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| o | Cadeia de caracteres | Data e hora a serem definidas no objeto GlideDate atual. Formato: aaaa-MM-dd |
[Tabela 24. Parâmetros]

{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate(); 
    gd.setValue('2015-01-01');
    gs.info(gd.getValue());

Saída:

    2015-01-01

## GlideDate com escopo - subtract(GlideDate start, GlideDate end) {#ariaid-title15}

Obtém a diferença de duração entre dois valores de GlideDate.
{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| iniciar | GlideDate | O valor inicial. |
| terminar | GlideDate | O valor final. |
[Tabela 26. Parâmetros]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq} {#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDuration | A duração entre os dois valores. |
[Tabela 27. Retorna]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq}  

    var sgd1 = new GlideDate(); 
    sgd1.setDisplayValue('2014-07-18'); 
    var sgd2 = new GlideDate(); 
    sgd2.setDisplayValue('2014-07-19'); 
     
    var duration = GlideDate.subtract(sgd1, sgd2); 
    gs.info(duration.getDisplayValue());

Saída:

    1 Day