GlideDate – Global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 10 min. de leitura

    • A classe GlideDate 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.

    GlideDate — GlideDate()

    Cria um objeto GlideDate com a data e hora atuais.

    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 – 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-yyyy" para obter o dia, o mês e o ano ou "EEEE" para obter o dia da semana.
    Tabela 3. Retorna
    Tipo Descrição
    Cadeia de caracteres Valor de data para o 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

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - getByFormat(String format).

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

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - getMonthNoTZ().

    GlideDate – getDisplayValue()

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

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 7. Retorna
    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. 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getDisplayValue());
    Saída: 
    2021-04-21

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - getDisplayValue().

    GlideDate – getDisplayValueInternal()

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

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 9. Retorna
    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

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

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - getDisplayValueInternal().

    GlideDate – getDisplayValueLang(estilo cadeia de caracteres)

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

    Tabela 10. Parâmetros
    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.
    Tabela 11. Retorna
    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.

    O exemplo a seguir retorna a data da localidade do usuário em todos os estilos.

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


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

gs.info('date: ' + gd.getDisplayValueLang("full"));
gs.info('date: ' + gd.getDisplayValueLang("long"));
gs.info('date: ' + gd.getDisplayValueLang("medium"));
gs.info('date: ' + gd.getDisplayValueLang("short"));

    Saída:

    date: 2023-01-18
Wednesday, January 18, 2023
date: January 18, 2023
date: Jan 18, 2023
date: 1/18/23

    GlideDate – getDisplayValueLang(estilo de cadeia de caracteres, idioma de cadeia de caracteres)

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

    Tabela 12. Parâmetros
    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.
    Tabela 13. Retorna
    Tipo Descrição
    Cadeia de caracteres Data no estilo e 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 – 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

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - getMonthNoTZ().

    GlideDate – getYearNoTZ()

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

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 17. 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

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - getYearNoTZ().

    GlideDate - parseDate (cadeia de caracteres data, idioma da cadeia de caracteres, país da cadeia de caracteres)

    Analisa uma data para a localidade associada aos códigos de idioma e país aprovados.

    Nota:
    Este método falhará e emitirá uma exceção se o formato de data regional não for seguido.
    Tabela 18. Parâmetros
    Nome Tipo Descrição
    data Cadeia de caracteres Data formatada em sintaxe regional.

    Formatos:

    • Datas alfanuméricas: você pode especificar meses como três caracteres, como janeiro, fev ou mar, ou soletrar totalmente o nome do mês. Os anos devem ter quatro dígitos e os dias devem ter dois dígitos. Por exemplo: "31 de janeiro de 2020" ou "31 de janeiro de 2020"
    • Datas numéricas: dias e meses devem ter dois dígitos. Quatro dígitos são altamente preferenciais para anos, embora o método suporte um ano de dois dígitos com menos precisão e uma chance maior de falha de análise. Você também deve usar o separador de data regional. Esses separadores afetam a análise com base nos valores passados language e country. Por exemplo: "31/12/2020" para a localidade dos EUA e "31.12.20" para a localidade da Estônia.
    idioma Cadeia de caracteres Código de idioma ISO-639 de dois caracteres.
    país Cadeia de caracteres Código de país ISO-3166 de dois caracteres.
    Tabela 19. Retorna
    Tipo Descrição
    Objeto Objeto GlideDate analisado que você pode usar em cálculos ou inserir em um registro.

    Este método lançará uma exceção se a data falhar na análise. Uma exceção acontece quando o formato de data não corresponde ao formato de localidade especificado (parâmetros language e country aprovados).

    O exemplo de código a seguir analisa uma data e adiciona quatro semanas a essa data.

    var date = GlideDate.parseDate("31 Dec 2020", "en", "GB");
date.addWeeksLocalTime(4);
gs.info("Project is due 4 weeks after start date, on " + date.getDisplayValue());

    Saída:

    Project is due 4 weeks after start date, on 2021-01-28

    GlideDate – setDisplayValue(String asDisplayed)

    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
    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 21. Retorna
    Tipo Descrição
    Nenhum(a) 
    var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

    Saída:

    2011-01-01

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - setDisplayValue(String asDisplayed).

    GlideDate – setDisplayValueLang(cadeia de caracteres data, cadeia de caracteres estilo)

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

    Tabela 22. Parâmetros
    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 23. Retorna
    Tipo Descrição
    vazio

    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 – setDisplayValueLang(cadeia de caracteres data, estilo de cadeia de caracteres, idioma de cadeia de caracteres)

    Define uma data usando um estilo, idioma 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 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.
    Tabela 25. Retorna
    Tipo Descrição
    Vazio

    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 – setValue(String 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 26. 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 27. Retorna
    Tipo Descrição
    Nenhum(a) 
    var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

    Saída:

    2015-01-01

    Equivalente com escopo

    Para usar este método em uma aplicação com escopo, use o método com escopo correspondente: Scoped GlideDate - setValue(String o).