GlideDateTime - Global

GlideDateTime - GlideDateTime()

Instancia um novo GlideDateTime objeto com a data e hora atuais.

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

Este exemplo instancia um GlideDateTime objeto.

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

Saída:

2022-08-08 16:51:44

GlideDateTime - GlideDateTime (cadeia de caracteres DateTime)

Instancia um novo GlideDateTime objeto que usa o valor de data e hora de entrada.

O sistema tenta corresponder o valor passado ao formato do sistema interno especificado. Se o argumento não corresponder ao formato do sistema, o sistema tentará correspondê-lo a um dos seguintes formatos nesta ordem:

aaaa-MM-dd HH:mm:ss
Dd/MM/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.aaaa hh.mm.ss A.
dd.MM.aaaa

Nota:

O seguinte formato não é compatível:

aaaa-MM-dd'T'HH:mm:ss.SSSZ

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

Este exemplo mostra como instanciar um GlideDateTime objeto usando uma cadeia de caracteres.

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

Saída:

2023-01-01 12:00:00

GlideDateTime - GlideDateTime (GlideDateTime gdt)

Instancia um novo GlideDateTime objeto definido como a hora de um especificado GlideDateTime objeto.

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

Este exemplo mostra como instanciar um GlideDateTime objeto (gdt1) usando uma cadeia de caracteres no formato aaaa-MM-dd HH:mm:ss e um segundo GlideDateTime objeto (gdt2) usando gdt1.

var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
gs.info(gdt1);
gs.info(gdt2);

Saída:

2025-01-28 12:00:00
2025-01-28 12:00:00

GlideDateTime - add (número de milissegundos)

Adiciona um número especificado de milissegundos ao objeto GlideDateTime.

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

Tabela 5. Retornos
Tipo	Descrição
vazio

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

Saída:

1314777600000
1314777600010

Equivalente com escopo

Para usar o. adicionar() em uma aplicação com escopo, use o método com escopo correspondente: adicionar() .

GlideDateTime - adicionar(GlideTime)

Adiciona um objeto GlideTime ao objeto GlideDateTime atual.

Tabela 6. Parâmetros
Nome	Tipo	Descrição
hora	GlideTime	Objeto GlideTime cujo valor de tempo será adicionado ao objeto GlideDateTime especificado.

Tabela 7. Retornos
Tipo	Descrição
vazio

Este exemplo mostra como adicionar 20 segundos ao tempo definido no objeto GlideDateTime gdt.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
gs.print(gdt.toString());

Saída:

2011-08-31 08:00:20

Equivalente com escopo

Para usar o. adicionar() em uma aplicação com escopo, use o método com escopo correspondente: adicionar() .

GlideDateTime - addDays (número de dias)

Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias.

Usar AddDaysLocalTime() e. AddDaysUTC() em vez deste método.

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

Tabela 9. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-30

GlideDateTime - addDaysLocalTime (número de dias)

Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias.

O método determina a data e a hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora locais.

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

Tabela 11. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-30

Equivalente com escopo

Para usar o. AddDaysLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: AddDaysLocalTime() .

GlideDateTime - addDaysUTC (número de dias)

Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias.

O método determina a data e a hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora UTC.

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

Tabela 13. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-30

Equivalente com escopo

Para usar o. AddDaysUTC() em uma aplicação com escopo, use o método com escopo correspondente: AddDaysUTC() .

GlideDateTime - addSeconds (número de segundos)

Adiciona um número especificado de segundos ao objeto GlideDateTime.

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

Tabela 15. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-12-07 08:16:40

Equivalente com escopo

Para usar o. AddSeconds() em uma aplicação com escopo, use o método com escopo correspondente: AddSeconds() .

GlideDateTime - addWeeks (número de semanas)

Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas.

Usar AddWeeksLocalTime() e. AddWeeksUTC() em vez deste método.

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

Tabela 17. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-24

GlideDateTime - addWeeksLocalTime (número de semanas)

Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas.

O método determina a data e a hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai semanas usando os valores de data e hora locais.

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

Tabela 19. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-24

Equivalente com escopo

Para usar o. AddWeeksLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: AddWeeksLocalTime() .

GlideDateTime - addWeeksUTC(número de semanas)

Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas.

O método determina a data e a hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai semanas usando os valores de data e hora UTC.

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

Tabela 21. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-24

Equivalente com escopo

Para usar o. AddWeeksUTC() em uma aplicação com escopo, use o método com escopo correspondente: AddWeeksUTC() .

GlideDateTime - addMonths (número de meses)

Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses.

Usar AddMensesLocalTime() ou AddMensesUTC() em vez deste método.

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

Tabela 23. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-10-31

GlideDateTime - addMonthsLocalTime (número de meses)

Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses.

O método determina a data e a hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora locais.

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

Tabela 25. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-10-31

Equivalente com escopo

Para usar o. AddMensesLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: AddMensesLocalTime() .

GlideDateTime - addMonthsUTC (número de meses)

Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses.

O método determina a data e a hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora UTC.

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

Tabela 27. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-10-31

Equivalente com escopo

Para usar o. AddMensesUTC() em uma aplicação com escopo, use o método com escopo correspondente: AddMensesUTC() .

GlideDateTime - addYears (número de anos)

Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos.

Usar AddYearsLocalTime() ou AddYearsUTC() em vez deste método.

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

Tabela 29. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-31

GlideDateTime - addYearsLocalTime (número de anos)

Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos.

O método determina a data e a hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai anos usando os valores de data e hora locais.

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

Tabela 31. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-31

Equivalente com escopo

Para usar o. AddYearsLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: AddYearsLocalTime() .

GlideDateTime - addYearsUTC (número de anos)

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 estando no fuso horário UTC.

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

Tabela 33. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-31

Equivalente com escopo

Para usar o. AddYearsUTC() em uma aplicação com escopo, use o método com escopo correspondente: AddYearsUTC() .

GlideDateTime - compareTo(Data/hora do objeto)

Compara dois objetos de data e hora para determinar se um ocorre antes do outro ou se eles são equivalentes.

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

Tabela 35. Retornos
Tipo	Descrição
Número	0: 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

var initDate = new GlideDateTime("2011-08-01 12:00:00");
var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
 
gs.info(initDate.compareTo(compDate1)); // Equals (0)
gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)

Saída:

0
1
-1

Equivalente com escopo

Para usar o. CompareTo() em uma aplicação com escopo, use o método com escopo correspondente: CompareTo() .

GlideDateTime - Igual(objeto GDT)

Compara um objeto com um valor existente para igualdade.

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

Tabela 37. Retornos
Tipo	Descrição
Booliano	Verdadeiro se forem iguais, caso contrário, falso.

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

Saída:

 false

Equivalente com escopo

Para usar o. igual a() em uma aplicação com escopo, use o método com escopo correspondente: igual a() .

GlideDateTime - getDate()

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

Tabela 38. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

2011-08-31

Equivalente com escopo

Para usar o. Getdate() em uma aplicação com escopo, use o método com escopo correspondente: Getdate() .

GlideDateTime - getDayOfMonth()

Obtém o dia atual do mês no fuso horário UTC.

descontinuado Usar ObtemDeMensalLocalTime() e. ObdadoDeMensUTC() em vez deste método.

Tabela 40. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

GlideDateTime - getDayOfMonthLocalTime()

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

Tabela 42. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. ObtemDeMensalLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: ObtemDeMensalLocalTime() .

GlideDateTime - getDayOfMonthUTC()

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

Tabela 44. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. ObdadoDeMensUTC() em uma aplicação com escopo, use o método com escopo correspondente: ObdadoDeMensUTC() .

GlideDateTime - getDayOfWeek()

Recupera o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário.

Usar ObtLocalDeSemeSemana() e. GetDayOfWeekUTC() em vez deste método.

Tabela 46. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 47. Retorna
Tipo	Descrição
Número	O valor do dia da semana - segunda-feira é 1, ... Domingo: 7.

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

Saída:

GlideDateTime - getDayOfWeekLocalTime()

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

Tabela 48. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 49. Retorna
Tipo	Descrição
Número	O valor do dia da semana - segunda-feira é 1, ... Domingo: 7

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

Saída:

Equivalente com escopo

Para usar o. ObtLocalDeSemeSemana() em uma aplicação com escopo, use o método com escopo correspondente: ObtLocalDeSemeSemana() .

GlideDateTime - getDayOfWeekUTC()

Obtém o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

Tabela 50. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 51. Retorna
Tipo	Descrição
Número	O valor do dia da semana - segunda-feira é 1, ... Domingo: 7

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

Saída:

Equivalente com escopo

Para usar o. GetDayOfWeekUTC() em uma aplicação com escopo, use o método com escopo correspondente: GetDayOfWeekUTC() .

GlideDateTime - getDaysInMonth()

Obtém o número de dias no mês armazenado pelo objeto GlideDateTime, expresso no fuso horário da Java Virtual Machine.

Usar ObterDiasInMenshLocalTime() e. ObterDiasInMenshUTC() em vez deste método.

Tabela 52. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

GlideDateTime - getDaysInMonthLocalTime()

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

Tabela 54. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. ObterDiasInMenshLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: ObterDiasInMenshLocalTime() .

GlideDateTime - getDaysInMonthUTC()

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

Tabela 56. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. ObterDiasInMenshUTC() em uma aplicação com escopo, use o método com escopo correspondente: ObterDiasInMenshUTC() .

GlideDateTime - getDisplayValue()

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

Nota:

Fazer referência ao objeto GlideDateTime retorna diretamente o valor de data e hora no fuso horário GMT.

Tabela 58. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

2011-08-31 01:00:00

Equivalente com escopo

Para usar o. ObtDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: ObtDisplayValue() .

GlideDateTime - getDisplayValueInternal()

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

Tabela 60. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

// The passed in date and time is converted to the caller's time zone.
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValueInternal());

Saída:

2011-08-31 01:00:00

Equivalente com escopo

Para usar o. ObterDisplayValueInternal() em uma aplicação com escopo, use o método com escopo correspondente: ObterDisplayValueInternal() .

GlideDateTime - getDisplayValueLang (estilo de cadeia de caracteres)

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

Tabela 62. Parâmetros
Nome	Tipo	Descrição
estilo	Cadeia de caracteres	Especifica o formato de data e hora. Valores válidos: cheio Retorna a data no formato "weekday, month, day, and year" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). longo : Retorna a data no formato "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 aprovado, a API será usada por padrão `médio` . Os valores aceitos não diferenciam maiúsculas de minúsculas.

Tabela 63. Retornos
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 e a hora da localidade do usuário em todos os estilos de data.

var gdt = new GlideDateTime(); // This will fetch the current date


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

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

Saída:

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

GlideDateTime - getDisplayValueLang(estilo de cadeia de caracteres, idioma de cadeia de caracteres)

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

Tabela 64. Parâmetros
Nome	Tipo	Descrição
estilo	Cadeia de caracteres	Especifica o formato de data e hora. Valores válidos: cheio Retorna a data no formato "weekday, month, day, and year" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). longo : Retorna a data no formato "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 aprovado, a API será usada por padrão `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 que estão em conformidade com o padrão BCP-47. Por exemplo, `fr` Para francês ou `Reino Unido` Para inglês britânico. Para obter uma lista completa de valores aceitos, consulte Lista de códigos de idioma BCP 47 .

Tabela 65. Retornos
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 e a hora da localidade do usuário em todos os estilos de idioma e data.

var gdt = new GlideDateTime(); // This will fetch the current date


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

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

Saída:

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

GlideDateTime - getDSTOffset()

Obtém a quantidade de horário em que o horário de verão está deslocado.

Tabela 66. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 67. Retorna
Tipo	Descrição
Número	Tempo, em milissegundos, em que o horário de verão é deslocado. Retorna 0 se não houver deslocamento ou se a hora não estiver durante o horário de verão.

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

Saída:

Equivalente com escopo

Para usar o. GetDSTOffset() em uma aplicação com escopo, use o método com escopo correspondente: GetDSTOffset() .

GlideDateTime - getErrorMsg()

Obtém a mensagem de erro atual.

Tabela 68. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 69. Retorna
Tipo	Descrição
Objeto	A mensagem de erro

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

Saída:

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

Equivalente com escopo

Para usar o. GetErrorMsg() em uma aplicação com escopo, use o método com escopo correspondente: GetErrorMsg() .

GlideDateTime - getInternalFormattedLocalTime()

Retorna a hora do objeto no fuso horário local e no formato interno.

Tabela 70. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

Este exemplo exibe a hora no formato de hora do sistema do fuso horário do usuário.

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

Saída:

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

Equivalente com escopo

Para usar o. ObterLocalFormatedInternalLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: ObterLocalFormatedInternalLocalTime() .

GlideDateTime - getInternalMidnight(Number dayOfTheWeek)

Retorna um objeto de data e hora definido como meia-noite de um dia especificado usando UTC.

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

Tabela 73. Retornos
Tipo	Descrição
GlideDateTime	Um objeto GlideDateTime definido como meia-noite.

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

Saída:

2011-08-30 00:00:01

GlideDateTime - getLocalDate()

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.

Tabela 74. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

Este exemplo exibe a hora no formato de hora do usuário no fuso horário do usuário.

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

Saída:

2011-08-31

Equivalente com escopo

Para usar o. GetLocalDate() em uma aplicação com escopo, use o método com escopo correspondente: GetLocalDate() .

GlideDateTime - getLocalTime()

Obtém a hora no fuso horário do usuário.

Tabela 76. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

1970-01-01 01:00:00

Equivalente com escopo

Para usar o. GetLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: GetLocalTime() .

GlideDateTime - getMonth()

Recupera o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário da Java Virtual Machine.

Usar ObmentoLocalTime() e. GetMêsUTC() em vez deste método.

Tabela 78. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

GlideDateTime - getMonthLocalTime()

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

Tabela 80. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. ObmentoLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: ObmentoLocalTime() .

GlideDateTime - getMonthUTC()

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

Tabela 82. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. GetMêsUTC() em uma aplicação com escopo, use o método com escopo correspondente: GetMêsUTC() .

GlideDateTime - getNumericValue()

Obtém o número de milissegundos desde 1 de janeiro de 1970, 00:00:00 GMT.

Tabela 84. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

1314777600000

GlideDateTime - getSpanTime (número DayOfWeek)

Recupera a quantidade de tempo decorrido desde a meia-noite de um dia especificado até a hora atual.

Tabela 86. Parâmetros
Nome	Tipo	Descrição
dayOfWeek	Número	Valor do dia da semana de 1 a 7. Segunda-feira, 7 - domingo 1.

Tabela 87. Retornos
Tipo	Descrição
GlideTime	O tempo decorrido desde a meia-noite do dia especificado. Para exibir o resultado em termos fáceis de usar, defina o valor como GlideDuration.

var gdt = new GlideDateTime("2011-08-31 08:00:00"); //Wednesday
var dur = new GlideDuration();
 
var span = gdt.getSpanTime(1); //how much time since Monday 00:00:00
dur.setValue(span);
gs.print(dur.getDisplayValue());

Saída:

2 Days 8 Hours

GlideDateTime - getTime()

Obtém o carimbo de duração do Unix.

Tabela 88. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 89. Retorna
Tipo	Descrição
GlideTime	O carimbo de duração Unix no formato do sistema com base no horário GMT.

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

Saída:

1970-01-01 08:00:00

Equivalente com escopo

Para usar o. GetTime() em uma aplicação com escopo, use o método com escopo correspondente: GetTime() .

GlideDateTime - getTZOffset()

Obtém o deslocamento de fuso horário em milissegundos.

Tabela 90. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 91. Retorna
Tipo	Descrição
Número	O número de milissegundos do deslocamento de fuso horário

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

Saída:

-28800000

Equivalente com escopo

Para usar o. GetTZOffset() em uma aplicação com escopo, use o método com escopo correspondente: GetTZOffset() .

GlideDateTime - getUserFormattedLocalTime()

Retorna a hora do objeto no fuso horário local no formato do usuário.

Tabela 92. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

O exemplo de código a seguir mostra como chamar este método.

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

Saída:

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

Equivalente com escopo

Para usar o. ObterLocalFormatteLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: ObterLocalFormatteLocalTime() .

GlideDateTime - getUserTimeZone()

Recupera o fuso horário da sessão do usuário atual.

Este método é equivalente a. gs.getSession().getTimeZone() .

Tabela 94. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 95. Retorna
Tipo	Descrição
TimeZone	Objeto de fuso horário do usuário atual.

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

Saída:

sun.util.calendar.ZoneInfo[id="America/Los_Angeles",offset=-28800000,dstSavings=3600000,useDaylight=true,transitions=185,
lastRule=java.util.SimpleTimeZone[id=America/Los_Angeles,offset=-28800000,dstSavings=3600000,useDaylight=true,startYear=0,startMode=3,
startMonth=2,startDay=8,startDayOfWeek=1,startTime=7200000,startTimeMode=0,endMode=3,endMonth=10,endDay=1,endDayOfWeek=1,
endTime=7200000,endTimeMode=0]]

GlideDateTime - getUTCMidnight(number dayOfTheWeek)

Recupera um objeto GlideDateTime com a hora definida como meia-noite usando o fuso horário UTC.

Este método define a data do novo objeto GlideDateTime como o dia especificado da semana dentro da semana do objeto GlideDateTime original.

Tabela 96. Parâmetros
Nome	Tipo	Descrição
DiaDeSemana	Número	Dia da semana, de 1 a 7. Segunda-feira: 1, domingo: 7. Não insira 0 neste parâmetro.

Tabela 97. Retornos
Tipo	Descrição
GlideDateTime	Um novo objeto GlideDateTime, definido como meia-noite.

var gdt = new GlideDateTime("2011-08-31 08:00:00"); // Wednesday, 3rd day of the week.
gs.print(gdt.getUTCMidnight(5)); //Friday, 5th day of the week.

Saída:

2011-09-02 00:00:00

GlideDateTime - getValue()

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.

Tabela 98. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

2011-08-31 08:00:00

Equivalente com escopo

Para usar o. GetValue() em uma aplicação com escopo, use o método com escopo correspondente: GetValue() .

GlideDateTime - getWeekOfYearLocalTime()

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 ano novo. A semana que começa no domingo 2015-12-27 é considerada a primeira semana de 2016, pois essa semana contém 1 e 2 de janeiro.

Tabela 100. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 101. Retorna
Tipo	Descrição
Número	O número da semana atual. O número de semana mais alto em um ano é 52 ou 53.

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

Saída:

Equivalente com escopo

Para usar o. LocalTime() em uma aplicação com escopo, use o método com escopo correspondente: LocalTime() .

GlideDateTime - getWeekOfYearUTC()

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 ano novo. A semana que começa no domingo 2015-12-27 é considerada a primeira semana de 2016, pois essa semana contém 1 e 2 de janeiro.

Tabela 102. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 103. Retorna
Tipo	Descrição
Número	O número da semana atual no horário UTC. O número de semana mais alto em um ano é 52 ou 53.

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

Saída:

Equivalente com escopo

Para usar o. AnoUTC() em uma aplicação com escopo, use o método com escopo correspondente: AnoUTC() .

GlideDateTime - getYear()

Recupera o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário da Java Virtual Machine.

Usar GetYearLocalTime() e. AnoUTC() em vez deste método.

Tabela 104. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

GlideDateTime - getYearLocalTime()

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

Tabela 106. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. GetYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: GetYearLocalTime() .

GlideDateTime - getYearUTC()

Retorna o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

Tabela 108. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

Equivalente com escopo

Para usar o. AnoUTC() em uma aplicação com escopo, use o método com escopo correspondente: AnoUTC() .

GlideDateTime - hasDate()

Determina se a data de um objeto está definida.

Tabela 110. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 111. Retorna
Tipo	Descrição
Booliano	Se a data do objeto estiver definida, caso contrário, falso.

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

Saída:

true

Equivalente com escopo

Para usar o. HasDate() em uma aplicação com escopo, use o método com escopo correspondente: HasDate() .

GlideDateTime - isDST()

Determina se a hora do objeto usa um deslocamento de horário de verão

Tabela 112. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 113. Retorna
Tipo	Descrição
Booliano	Verdadeiro se a hora for o horário de verão, caso contrário, falso.

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

Saída:

true

Equivalente com escopo

Para usar o. IsDST() em uma aplicação com escopo, use o método com escopo correspondente: IsDST() .

GlideDateTime - isValid()

Determina se um valor é uma data e hora válidas.

Tabela 114. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída

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

Equivalente com escopo

Para usar o. IsValid() em uma aplicação com escopo, use o método com escopo correspondente: IsValid() .

GlideDateTime - setDayOfMonth(dia numérico)

Define o dia do mês como um valor especificado.

Usar SeDiaDeMensalLocalTime(dia) e. DeMêsUTC(dia) em vez deste método.

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

Tabela 117. Retornos
Tipo	Descrição
vazio

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

Saída:

GlideDateTime - setDayOfMonthLocalTime (número dia)

Define o dia do mês como um valor especificado no fuso horário do usuário atual.

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

Tabela 119. Retornos
Tipo	Descrição
vazio

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

Saída:

Equivalente com escopo

Para usar o. SetDiaDeMensalLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: SetDiaDeMensalLocalTime() .

GlideDateTime - setDayOfMonthUTC(dia numérico)

Define o dia do mês como um valor especificado no fuso horário UTC.

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

Tabela 121. Retornos
Tipo	Descrição
vazio

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

Saída:

Equivalente com escopo

Para usar o. DeMêsUTC() em uma aplicação com escopo, use o método com escopo correspondente: DeMêsUTC() .

GlideDateTime - setDisplayValue(cadeia de caracteres asExibida)

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

Tabela 122. Parâmetros
Nome	Tipo	Descrição
AsExibido	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-aaaa HH:mm:ss. Para atribuir a data e a hora atuais a uma variável em um script de fluxo de trabalho, use `DisplayValue(gs.nowDateTime); <variable>` .

Tabela 123. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-01-01 20:00:00

Equivalente com escopo

Para usar o. DisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: DisplayValue() .

GlideDateTime - setDisplayValue(cadeia de caracteres de data/hora, formato de cadeia de caracteres)

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 gera uma exceção de tempo de execução se o formato de data e hora usado no parâmetro DateTime não corresponder ao parâmetro de formato. Você pode recuperar a mensagem de erro chamando GetErrorMsg() No objeto GlideDateTime depois que a exceção é detectada.

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

Tabela 125. Retornos
Tipo	Descrição
vazio

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss");
gs.print(gdt.getValue());

Saída:

2011-05-20 19:00:00

Equivalente com escopo

Para usar o. DisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: DisplayValue() .

GlideDateTime - setDisplayValueInternal(cadeia de caracteres DateTime)

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.

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

Tabela 127. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-01-01 20:00:00

Equivalente com escopo

Para usar o. DisplayInternalInternalInternalDeDeDeDeDeDeDeDe em uma aplicação com escopo, use o método com escopo correspondente: DisplayInternalInternalInternalDeDeDeDeDeDeDeDe .

GlideDateTime - setDisplayValueInternalWithAlternates(cadeia de caracteres DateTime)

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

Este método tenta analisar valores de data e hora incompletos.

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

Tabela 129. Retornos
Tipo	Descrição
vazio

GlideDateTime - setDisplayValueLang(cadeia de caracteres DateTime, estilo de cadeia de caracteres)

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

Tabela 130. Parâmetros
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. Os valores válidos são qualquer saída de data e hora do ObtDisplayValueLang() 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, 28 de novembro, 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: cheio Retorna a data no formato "weekday, month, day, and year" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). longo : Retorna a data no formato "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 aprovado, a API será usada por padrão `médio` . Os valores aceitos não diferenciam maiúsculas de minúsculas.

Tabela 131. Retornos
Tipo	Descrição
Vazio

O exemplo a seguir retorna a data e a hora em estilos curto e completo.

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

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

Saída:

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

GlideDateTime - setDisplayValueLang(cadeia de caracteres DateTime, estilo de cadeia de caracteres, idioma de cadeia de caracteres)

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

Tabela 132. Parâmetros
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. Os valores válidos são qualquer saída de data e hora do ObtDisplayValueLang() 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, 28 de novembro, 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: cheio Retorna a data no formato "weekday, month, day, and year" de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). longo : Retorna a data no formato "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 aprovado, a API será usada por padrão `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 `Reino Unido` Para inglês britânico. Para obter uma lista completa de valores aceitos, consulte Lista de códigos de idioma BCP 47 .

Tabela 133. Retornos
Tipo	Descrição
Vazio

O exemplo a seguir retorna a data e a hora em estilos curto e completo para inglês e francês.

var glideDateFR = new GlideDateTime(); 

glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "short", "fr-FR" );

gs.info('en-US date: ' + glideDateUS.getDisplayValue());
gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));

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

Saída:

en-US date: 2023-02-03 18:00:00
en-US date: Friday, February 3, 2023 18:00:00
fr-FR date: 2023-03-02 18:00:00
fr-FR date: Thursday, March 2, 2023 18:00:00

GlideDateTime - setGlideDateTime(GlideDateTime GDT)

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.

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

Tabela 135. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-02-02 08:00:00

Equivalente com escopo

Para usar o. SetGlideDateTime() em uma aplicação com escopo, use o método com escopo correspondente: SetGlideDateTime() .

GlideDateTime - setInitialValue(cadeia de caracteres de data/hora)

Define a data e a hora.

Este método é equivalente a. SetValue(objeto) .

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

Tabela 137. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-01-01 12:00:00

GlideDateTime - setMonth(Number Month)

Define o mês armazenado pelo objeto GlideDateTime como um valor especificado usando o fuso horário da Java Virtual Machine.

Usar SetMenshLocalTime() ou SetMenshUTC() em vez deste método.

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

Tabela 139. Retornos
Tipo	Descrição
vazio

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

Saída:

GlideDateTime - setMonthLocalTime (número de mês)

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

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

Tabela 141. Retornos
Tipo	Descrição
vazio

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

Saída:

Equivalente com escopo

Para usar o. SetMenshLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: SetMenshLocalTime() .

GlideDateTime - setMonthUTC(mês numérico)

Define o mês armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário UTC.

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

Tabela 143. Retornos
Tipo	Descrição
vazio

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

Saída:

Equivalente com escopo

Para usar o. SetMenshUTC() em uma aplicação com escopo, use o método com escopo correspondente: SetMenshUTC() .

GlideDateTime - setNummericValue(número de milissegundos)

Define a data e a hora para o número de milissegundos desde 1 de janeiro, 1970 00:00:00 GMT.

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

Tabela 145. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-08-31 08:00:00

GlideDateTime - setTZ(fuso horário do fuso horário)

Define o fuso horário do objeto GlideDateTime como o fuso horário especificado.

Tabela 146. Parâmetros
Nome	Tipo	Descrição
fuso horário	TimeZone	Um objeto de fuso horário

Tabela 147. Retornos
Tipo	Descrição
vazio

var tz = gs.getSession().getTimeZone();
var gdt = new GlideDateTime(); 
gdt.setTZ(tz);

GlideDateTime - setValue(Object DateTime)

Define a data e a hora do objeto GlideDateTime.

Este método é equivalente a. SetInitialValue() .

Tabela 148. Parâmetros
Nome	Tipo	Descrição
Data/hora	Objeto	A data e a hora a serem usadas. Este parâmetro pode ser um de vários tipos. Uma cadeia de caracteres no fuso horário UTC e no formato interno aaaa-MM-dd HH:mm:ss: Define o valor do objeto para a data e hora especificadas. Usar o método dessa forma é equivalente a instanciar um novo objeto GlideDateTime usando GlideDateTime (valor) construtor. 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 maneira pode levar a dados imprecisos devido à ambiguidade nos valores de dia e mês. Ao usar um formato de data e hora não padrão, use ValorUTC(data/hora, formato) em vez disso. 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 GlideDateTime (g) construtor. Um objeto Java Date: Define o valor do objeto usando o valor armazenado pelo objeto Java Date. Usar o método dessa forma é equivalente a passar o valor retornado pelo objeto Java Date GetTime() GlideDateTime ValorNumericset() método. Este método não aceita objetos JavaScript Date. Um número JavaScript: Define o valor do objeto usando o valor numérico como milissegundos após 1 de janeiro, 1970 00:00:00 UTC. Usar o método dessa forma é equivalente a ValorNumericdefinido (milissegundos) método. Um Inteiro Java ou Longo: Define o valor do objeto usando o valor Inteiro ou Longo como milissegundos após 1 de janeiro, 1970 00:00:00 UTC. Usar o método dessa forma é equivalente a ValorNumericdefinido (milissegundos) método.

Tabela 149. Retornos
Tipo	Descrição
vazio

Defina a data e a hora usando uma cadeia de caracteres no formato aaaa-MM-dd HH:mm:ss.

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

Saída:

2011-02-02 08:00:00

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

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

Saída:

2017-05-23 11:37:41

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

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

Saída:

2021-04-05 14:55:22

Equivalente com escopo

Para usar o. SetValue() em uma aplicação com escopo, use o método com escopo correspondente: SetValue() .

GlideDateTime - setValueUTC(cadeia de caracteres de data/hora, formato de cadeia de caracteres)

Define um valor de data e hora usando o fuso horário UTC e o formato de data e hora especificado.

Este método gera uma exceção de tempo de execução se o formato de data e hora usado no parâmetro DateTime não corresponder ao parâmetro de formato. Você pode recuperar a mensagem de erro chamando GetErrorMsg() No objeto GlideDateTime depois que a exceção é detectada.

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

Tabela 151. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-02-15 08:00:00

Equivalente com escopo

Para usar o. ValorUTC() em uma aplicação com escopo, use o método com escopo correspondente: ValorUTC() .

GlideDateTime - setYear(Number Year)

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário da Java Virtual Machine.

Usar SetYearLocalTime() ou SetYearUTC() em vez deste método.

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

Tabela 153. Retornos
Tipo	Descrição
vazio

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

Saída:

GlideDateTime - setYearLocalTime (número de ano)

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário do usuário atual.

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

Tabela 155. Retornos
Tipo	Descrição
vazio

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

Saída:

Equivalente com escopo

Para usar o. SetYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: SetYearLocalTime() .

GlideDateTime - setYearUTC(ano numérico)

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário UTC.

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

Tabela 157. Retornos
Tipo	Descrição
vazio

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

Saída:

Equivalente com escopo

Para usar o. SetYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: SetYearUTC() .

GlideDateTime - subtrair (GlideTime Time)

Subtrai uma quantidade de tempo especificada.

Tabela 158. Parâmetros
Nome	Tipo	Descrição
hora	GlideTime	O tempo a ser subtraído

Tabela 159. Retornos
Tipo	Descrição
vazio

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
gs.print(gdt.getTime());

Saída:

1970-01-01 07:59:40

Equivalente com escopo

Para usar o. subtrair() em uma aplicação com escopo, use o método com escopo correspondente: subtrair() .

GlideDateTime - subtrair (número de milissegundos)

Subtrai um número especificado de milissegundos do objeto GlideDateTime.

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

Tabela 161. Retornos
Tipo	Descrição
vazio

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

Saída:

2011-12-07 07:59:59

Equivalente com escopo

Para usar o. subtrair() em uma aplicação com escopo, use o método com escopo correspondente: subtrair() .

GlideDateTime - subtrair (início do GlideDateTime, término do GlideDateTime)

Retorna a diferença de duração entre dois objetos GlideDateTime especificados.

Tabela 162. Parâmetros
Nome	Tipo	Descrição
início	GlideDateTime	Objeto de data de início.
término	GlideDateTime	Objeto de data de término.

Tabela 163. Retornos
Tipo	Descrição
GlideDuration	Diferença de duração entre as duas datas especificadas.

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

Saída:

2 Days 23 Hours

Equivalente com escopo

Para usar o. subtrair() em uma aplicação com escopo, use o método com escopo correspondente: subtrair() .

GlideDateTime - toString()

Retorna o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss e o fuso horário do sistema, UTC por padrão.

Este método é equivalente a. GetValue() .

Tabela 164. Parâmetros
Nome	Tipo	Descrição
Nenhum

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

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

Saída:

2011-08-31 08:00:00

Equivalente com escopo

Para usar o. ToString() em uma aplicação com escopo, use o método com escopo correspondente: ToString() .