GlideDate - Com escopo

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 10 min. de leitura

    • O escopo GlideDate A classe 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/hora com uma lista de conflitos de formato comuns, consulte Diretrizes de formato de data e hora.

    Consulte também GlideDateTime - Com escopo.

    GlideDate com escopo - GlideDate()

    Cria um objeto GlideDate com a data e hora atual.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum(a) 
    //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)

    Obtém a data no formato de data especificado.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    formato Cadeia de caracteres Formato de data desejado usando Java SimpleDateFormat . Por exemplo, "dd-MM-aaaa" para obter o dia, mês e ano, ou "EEEE" para obter o dia da semana.
    Tabela 3. Retornos
    Tipo Descrição
    Cadeia de caracteres Valor de data do objeto GlideDate no formato especificado. 
    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()

    Obtém o dia do mês armazenado pelo objeto GlideDate, expresso no fuso horário UTC.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 5. Retorna
    Tipo Descrição
    Número O dia do mês no fuso horário UTC, de 1 a 31. 
    //Today's date is 2016-05-13 
var gd =new GlideDate();
gs.info(gd.getDayOfMonthNoTZ());

    Saída:

    13

    GlideDate com escopo - getDisplayValue()

    Obtém o valor do campo de data e hora no fuso horário UTC.

    Consulte também: ObterDisplayValueInternal()

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 7. Retornos
    Tipo Descrição
    Cadeia de caracteres Valor de data do objeto GlideDate no fuso horário UTC. 
    var gd = new GlideDate(); 
gd.setValue('2025-04-21');
gs.info(gd.getDisplayValue());
    Saída: 
    2025-04-21

    GlideDate com escopo - getDisplayValueEx (estilo de cadeia de caracteres)

    Retorna a data usando o fuso horário do usuário atual e um formato especificado.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    estilo Cadeia de caracteres Formato a ser usado para a data.
    Valores válidos (não diferencia maiúsculas de minúsculas):
    • curto : M/D/AA ou D/M/AA dependendo do idioma do usuário atual. Por exemplo, 1/27/26 ou 27/1/26.
    • médio : Inclui mês, dia e ano abreviados. Por exemplo, 27 de janeiro de 2026.
    • longo : Inclui mês, dia e ano. Por exemplo, 27 de janeiro de 2026.
    • cheio : Inclui dia da semana, mês, dia e ano. Por exemplo, terça-feira, 27 de janeiro de 2026.

    A data é retornada no idioma do usuário atual. O idioma determina a ordem do mês e do dia na data.
    Tabela 9. Retornos
    Tipo Descrição
    Cadeia de caracteres A data no formato especificado.

    Este exemplo retorna a data usando o fuso horário do usuário atual e cada opção de formatação.

    var gd = new GlideDate();
gs.info(gd.getDisplayValueEx("short"));
gs.info(gd.getDisplayValueEx("medium"));
gs.info(gd.getDisplayValueEx("long"));
gs.info(gd.getDisplayValueEx("full"));

    Saída:

    1/27/26  //short
Jan 27, 2026  //medium
January 27, 2026  //long
Tuesday, January 27, 2026  //full

    GlideDate com escopo - getDisplayValueInternal()

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

    Consulte também GlideDate com escopo - getDisplayValueInternal()

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 11. Retornos
    Tipo Descrição
    Cadeia de caracteres Valor de data do objeto GlideDate no fuso horário do usuário atual.

    Formato: aaaa-MM-dd

    		 
    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)

    Retorna o valor de data na localidade do usuário de acordo com um idioma e estilo de data especificados.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    estilo Cadeia de caracteres Formato de data.
    Valores válidos:
    • cheio : Retorna a data no formato "dia da semana, mês, dia e ano" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022).
    • longo : Retorna a data no formato de mês, dia e ano> 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).
    • curto : Retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 10/24/2022 ou 24/10/2022).

    Se qualquer outro valor for passado, o padrão da API é médio . Os valores aceitos não diferenciam maiúsculas de 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 pt-UK Para inglês britânico. Para obter uma lista completa de valores aceitos, consulte BCP 47 Lista de códigos de idioma .
    Tabela 13. Retornos
    Tipo Descrição
    Cadeia de caracteres Data no estilo e no idioma especificados de acordo com a localidade do usuário atual.

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

    Obtém o mês armazenado pelo objeto GlideDate, expresso no fuso horário UTC.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 15. Retorna
    Tipo Descrição
    Número O valor numérico do mês de 1 a 12. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getMonthNoTZ());

    Saída:

    5

    GlideDate com escopo - getValue()

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

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 17. Retornos
    Tipo Descrição
    Cadeia de caracteres O valor de data do objeto GlideDate no fuso horário do sistema.

    Formato: aaaa-MM-dd

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

    GlideDate com escopo - getYearNoTZ()

    Obtém o ano armazenado pelo objeto GlideDate, expresso no fuso horário UTC.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 19. Retorna
    Tipo Descrição
    Número O valor numérico do ano. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

    Saída:

    2016

    GlideDate com escopo - setDisplayValue(cadeia de caracteres asExibida)

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

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    Exibido 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 21. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

    Saída:

    2011-01-01

    GlideDate com escopo - setDisplayValueEx(data da cadeia de caracteres, estilo da cadeia de caracteres)

    Define a data usando um formato especificado.

    Tabela 22. Parâmetros
    Nome Tipo Descrição
    data Cadeia de caracteres Valor a ser definido para a data.
    . DisplayValueEx() o método retorna datas em um formato válido ou as datas podem ser formatadas conforme mostrado abaixo.
    • M/D/AA ou D/M/AA dependendo do idioma do usuário atual. Por exemplo, 1/27/26 ou 27/1/26.
    • Mês, dia e ano abreviados. Por exemplo, 27 de janeiro de 2026.
    • Mês, dia e ano. Por exemplo, 27 de janeiro de 2026.
    • Dia da semana, mês, dia e ano. Por exemplo, terça-feira, 27 de janeiro de 2026.
    O idioma do usuário atual determina a ordem aceita de mês e dia na data. Por exemplo, se o idioma do usuário atual for inglês 3/21/26 e. 21 de março de 2026 são valores válidos enquanto 21/3/26 e. 21 de março de 2026 não são.
    estilo Cadeia de caracteres Formato a ser usado para a data.

    Você deve usar o mesmo formato fornecido datevalor.

    Valores válidos (não diferencia maiúsculas de minúsculas):
    • curto : M/D/AA ou D/M/AA dependendo do idioma do usuário atual. Por exemplo, 1/27/26 ou 27/1/26.
    • médio : Mês, dia e ano abreviados. Por exemplo, 27 de janeiro de 2026.
    • longo : Mês, dia e ano. Por exemplo, 27 de janeiro de 2026.
    • cheio : Dia da semana, mês, dia e ano. Por exemplo, terça-feira, 27 de janeiro de 2026.
    Tabela 23. Retornos
    Tipo Descrição
    Nenhum(a)

    Este exemplo define a data usando um formato especificado.

    gd = new GlideDate();
gd.setDisplayValueEx("Jan 28, 2026", "medium");
gs.info(gd.getDisplayValueEx("full"));

    Saída:

    Wednesday, January 28, 2026

    GlideDate com escopo - setDisplayValueLang(Data da cadeia de caracteres, estilo da cadeia de caracteres)

    Define uma data usando um estilo e formato especificados de acordo com a localidade do usuário atual.

    Tabela 24. Parâmetros
    Nome Tipo Descrição
    data Cadeia de caracteres Valor de data do objeto GlideDate no fuso horário do usuário atual. Os valores válidos são qualquer saída de data e hora do DisplayValueLang() função.

    Por exemplo, usando a saída do DisplayValueLang(estilo de cadeia de caracteres, idioma de cadeia de caracteres) exemplo 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:
    • cheio : Retorna a data no formato "dia da semana, mês, dia e ano" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022).
    • longo : Retorna a data no formato de mês, dia e ano> 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).
    • curto : Retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 10/24/2022 ou 24/10/2022).

    Se qualquer outro valor for passado, o padrão da API é médio . Os valores aceitos não diferenciam maiúsculas de minúsculas.
    Tabela 25. Retornos
    Tipo Descrição
    vazio

    O exemplo a seguir mostra como você pode definir a data atual da localidade do usuário para o estilo "completo" usando DisplayValueLang() .

    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(Data da cadeia de caracteres, estilo da cadeia de caracteres, idioma da cadeia de caracteres)

    Define uma data usando um estilo, idioma e formato especificados de acordo com a localidade do usuário atual.

    Tabela 26. Parâmetros
    Nome Tipo Descrição
    data Cadeia de caracteres Valor de data do objeto GlideDate no fuso horário do usuário atual. Os valores válidos são qualquer saída de data e hora do DisplayValueLang() função.

    Por exemplo, usando a saída do DisplayValueLang(estilo de cadeia de caracteres, idioma de cadeia de caracteres) exemplo 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:
    • cheio : Retorna a data no formato "dia da semana, mês, dia e ano" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022).
    • longo : Retorna a data no formato de mês, dia e ano> 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).
    • curto : Retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 10/24/2022 ou 24/10/2022).

    Se qualquer outro valor for passado, o padrão da API é médio . Os valores aceitos não diferenciam maiúsculas de minúsculas.
    idioma Cadeia de caracteres Define o idioma usando um marcador de idioma que está em conformidade com o padrão BCP-47. Por exemplo, fr Para francês ou pt-UK Para inglês britânico. Para obter uma lista completa de valores aceitos, consulte BCP 47 Lista de códigos de idioma .
    Tabela 27. Retornos
    Tipo Descrição
    Nulo

    O exemplo a seguir retorna a data e a hora em 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(cadeia de caracteres o)

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

    Tabela 28. Parâmetros
    Nome Tipo Descrição
    o Cadeia de caracteres Data e hora a serem definidas no objeto GlideDate atual.

    Formato: aaaa-MM-dd
    Tabela 29. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

    Saída:

    2015-01-01

    GlideDate com escopo - subtrair (início da GlideDate, término da GlideDate)

    Obtém a diferença de duração entre dois valores GlideDate.

    Tabela 30. Parâmetros
    Nome Tipo Descrição
    iniciar GlideDate O valor inicial.
    terminar GlideDate O valor final.
    Tabela 31. Retornos
    Tipo Descrição
    GlideDuration A duração entre os dois valores. 
    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