GlideDateTime - Global

GlideDateTime — GlideDateTime()

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

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

Este exemplo instancia um objeto GlideDateTime.

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

Saída:

2022-08-08 16:51:44

GlideDateTime — GlideDateTime(cadeia de caracteres data/hora)

Instancia um novo objeto GlideDateTime usando o valor de data e hora passado.

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

aaaa-MM-dd HH:mm:ss
MM/dd/aaaa HH:mm:ss
MM-dd-aaaa HH:mm:ss
MM-dd-aaaa HH:mm
MM-dd-aaaa
MM/dd/aaaa
dd-MM-aaaa HH:mm:ss
dd-MM-aaaa HH.mm.ss
dd-MM-aaaa HH.mm
dd-MM-aa HH.mm.ss
dd/MM/aaaa
dd-MM-aaaa
aaaa-MM-dd HH:mm
aaaa-MM-dd
dd.MM.aaaa HH:mm:ss
dd.MM.aaaa HH.mm.ss
dd.MM.aaaa hh:mm:ss a
dd.MM.yyyy hh.mm.ss a
dd.MM.aaaa

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 objeto GlideDateTime.

Este exemplo mostra como instanciar um objeto GlideDateTime 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 objeto GlideDateTime definido com a hora de um objeto GlideDateTime especificado.

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 objeto GlideDateTime (gdt1) usando uma cadeia de caracteres no formato aaaa-MM-dd HH:mm:sse um segundo objeto GlideDateTime (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 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 método add() em uma aplicação com escopo, use o método com escopo correspondente: add().

GlideDateTime – add(Tempo de 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 do 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 método add() em uma aplicação com escopo, use o método com escopo correspondente: add().

GlideDateTime – addDays(Número de dias)

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

Use 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 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 método 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 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 método 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 método 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.

Use 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 hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e 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 método 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 hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e 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 método 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.

Use addMonthsLocalTime() ou addMonthsUTC() 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 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 método addMonthsLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: addMonthsLocalTime().

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 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 método addMonthsUTC() em uma aplicação com escopo, use o método com escopo correspondente: addMonthsUTC().

GlideDateTime – addYears(Número de anos)

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

Use 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 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 método 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 se estivesse 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 método 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 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 = As datas são iguais 1 = A data do objeto é posterior à data especificada no parâmetro -1 = A data do objeto é anterior à data especificada no parâmetro

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 método compareTo() em uma aplicação com escopo, use o método com escopo correspondente: compareTo().

GlideDateTime - igual a (objeto GDT)

Compara um objeto com um valor existente de 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, falso caso contrário.

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 método 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	Data no 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 método 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 Use getDayOfMonthLocalTime() e getDayOfMonthUTC() 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 método getDayOfMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getDayOfMonthLocalTime().

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 método getDayOfMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: getDayOfMonthUTC().

GlideDateTime – getDayOfWeek()

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

Use getDayOfWeekLocalTime() 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 método getDayOfWeekLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getDayOfWeekLocalTime().

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 método getDayOfWeekUTC() em uma aplicação com escopo, use o método com escopo correspondente: getDayOfWeekUTC().

GlideDateTime – getDaysInMonth()

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

Use getDaysInMonthLocalTime() e getDaysInMonthUTC() 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 do 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 método getDaysInMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getDaysInMonthLocalTime().

GlideDateTime – getDaysInMonthUTC()

Obtém o número de dias do 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 do 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 método getDaysInMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: getDaysInMonthUTC().

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. 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 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 método getDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: getDisplayValue().

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 método getDisplayValueInternal() em uma aplicação com escopo, use o método com escopo correspondente: getDisplayValueInternal().

GlideDateTime – getDisplayValueLang(estilo 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: full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão `o valor médio`. Os valores aceitos não fazem distinção entre maiúsculas e 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: full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão `o valor 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 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 tempo 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	Quantidade de tempo, em milissegundos, em que o horário de verão está compensado. Retorna 0 se não houver deslocamento ou se a hora não estiver durante o horário de verão.

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

Saída:

Equivalente com escopo

Para usar o método 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 método 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 método getInternalFormattedLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getInternalFormattedLocalTime().

GlideDateTime – getInternalMidight(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
diaDaSemana	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 método 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 método 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 máquina virtual Java.

Use getMonthLocalTime() e getMonthUTC() 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 método getMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getMonthLocalTime().

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 método getMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: getMonthUTC().

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(Number 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
diaDaSemana	Número	Valor do dia da semana de 1 a 7. 1 = Segunda-feira, 7=Domingo.

Tabela 87. Retornos
Tipo	Descrição
GlideTime	A quantidade de tempo decorrido desde a meia-noite do dia especificado. Para exibir o resultado em termos amigáveis, 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 do Unix no formato do sistema com base na hora 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 método getTime() em uma aplicação com escopo, use o método com escopo correspondente: getTime().

GlideDateTime – getTZOffset()

Obtém a diferença 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 da compensação 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 método 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 método getUserFormattedLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getUserFormattedLocalTime().

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 TimeZone para o 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(Número 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 da semana especificado dentro da semana do objeto GlideDateTime original.

Tabela 96. Parâmetros
Nome	Tipo	Descrição
diaDaSemana	Número	O 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 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 método 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 novo ano. A semana que começa no domingo de 27/12/2015 é considerada a primeira semana de 2016, já que essa semana contém 1 e 2 de janeiro.

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

Tabela 101. Retorna
Tipo	Descrição
Número	O número da semana atual. O maior número de semanas 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 método getWeekOfYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: getWeekOfYearLocalTime().

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

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 maior número de semanas 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 método getWeekOfYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: getWeekOfYearUTC().

GlideDateTime – getYear()

Recupera o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário da máquina virtual Java.

Use getYearLocalTime() e getYearUTC() em vez deste método.

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

Tabela 105. Retorna
Tipo	Descrição
Número	O valor de 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 de 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 método 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 de 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 método getYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: getYearUTC().

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	Verdadeiro 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 método 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 verão

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

Tabela 113. Retorna
Tipo	Descrição
Booliano	Verdadeiro se o horário for 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 método 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 método isValid() em uma aplicação com escopo, use o método com escopo correspondente: isValid().

GlideDateTime – setDayOfMonth(Número de dias)

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

Use setDayOfMonthLocalTime(day) e setDayOfMonthUTC(day) 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 com 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 para o qual mudar, de 1 a 31. Se este valor for maior que o número máximo de dias no mês, o valor será definido como o último dia do mês.

Tabela 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 método setDayOfMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: setDayOfMonthLocalTime().

GlideDateTime – setDayOfMonthUTC(Número de dias)

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

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

Tabela 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 método setDayOfMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: setDayOfMonthUTC().

GlideDateTime – setDisplayValue(cadeia de caracteres asDisplayed)

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
comoExibido	Cadeia de caracteres	A data e a hora no formato de exibição e fuso horário do usuário atual. O parâmetro deve ser formatado usando o formato de exibição preferencial do usuário atual, como MM-dd-yyyy HH:mm:ss. Para atribuir a data e hora atuais a uma variável em um script de fluxo de trabalho, use<variable> `.setDisplayValue(gs.nowDateTime);`.

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 método setDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: setDisplayValue().

GlideDateTime – setDisplayValue(cadeia de caracteres dateTime, 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 lança 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 format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for 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 método setDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: setDisplayValue().

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 método setDisplayValueInternal() em uma aplicação com escopo, use o método com escopo correspondente: setDisplayValueInternal().

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. Valores válidos são qualquer saída de data e hora da função getDisplayValueLang(). Por exemplo, usando a saída do exemplo getDisplayValueLang (Estilo de cadeia de caracteres, Linguagem de cadeia de caracteres) anteriormente neste tópico, 28 de novembro de 2022 07:03:41 ou 28.11.2022 07:03:41 são valores aceitos.
estilo	Cadeia de caracteres	Especifica o formato de data. Valores válidos: full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão `o valor médio`. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas.

Tabela 131. Retornos
Tipo	Descrição
Vazio

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

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

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

Saída:

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

GlideDateTime – setDisplayValueLang(cadeia de caracteres data/hora, 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. Valores válidos são qualquer saída de data e hora da função getDisplayValueLang(). Por exemplo, usando a saída do exemplo getDisplayValueLang (Estilo de cadeia de caracteres, Linguagem de cadeia de caracteres) anteriormente neste tópico, 28 de novembro de 2022 07:03:41 ou 28.11.2022 07:03:41 são valores aceitos.
estilo	Cadeia de caracteres	Especifica o formato de data. Valores válidos: full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022). long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022). médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022). short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022). Se qualquer outro valor for aprovado, a API usará como padrão `o valor 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 133. Retornos
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 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 método setGlideDateTime() em uma aplicação com escopo, use o método com escopo correspondente: setGlideDateTime().

GlideDateTime – setInitialValue(cadeia de caracteres dateTime)

Define a data e a hora.

Este método é equivalente a setValue(Object).

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(Número de meses)

Define o mês armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário da máquina virtual Java.

Use setMonthLocalTime() ou setMonthUTC() 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 meses)

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 método setMonthLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: setMonthLocalTime().

GlideDateTime – setMonthUTC(Número de meses)

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 método setMonthUTC() em uma aplicação com escopo, use o método com escopo correspondente: setMonthUTC().

GlideDateTime – setNumericValue(Número milissegundos)

Define a data e a hora com o número de milissegundos desde 1º de janeiro de 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(TimeZone timeZone)

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 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 o construtor GlideDateTime(value). Se o formato de data e hora usado não corresponder ao formato interno, o método tentará definir a data e a hora usando outros formatos disponíveis. Resolver a data e a hora dessa forma pode gerar dados imprecisos devido à ambiguidade nos valores de dia e mês. Ao usar um formato de data e hora não padrão, use setValueUTC(dateTime, format). Um objeto GlideDateTime: define o valor do objeto como a data e a hora armazenadas pelo GlideDateTime passado no parâmetro. Usar o método dessa forma é equivalente a instanciar um novo objeto GlideDateTime usando o construtor GlideDateTime(g). Um objeto de data Java: define o valor do objeto usando o valor armazenado pelo objeto de data Java. Usar o método dessa forma é equivalente a passar o valor retornado pelo objeto Java Date getTime() para o método GlideDateTime setNumericValue(). Este método não aceita objetos de data JavaScript. Um número JavaScript: define o valor do objeto usando o valor do número como milissegundos após 1º de janeiro de 1970 00:00:00 UTC. Usar o método dessa forma é equivalente ao método setNumericValue(milisseconds). Um Java inteiro ou longo: define o valor do objeto usando o valor inteiro ou longo como milissegundos após 1º de janeiro de 1970 00:00:00 UTC. Usar o método dessa forma é equivalente ao método setNumericValue(milisseconds).

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 de 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 método setValue() em uma aplicação com escopo, use o método com escopo correspondente: setValue().

GlideDateTime - setValueUTC(cadeia de caracteres dateTime, 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 lança 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 format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for 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 método setValueUTC() em uma aplicação com escopo, use o método com escopo correspondente: setValueUTC().

GlideDateTime – setYear(Número de anos)

Define o ano armazenado pelo objeto GlideDateTime com um valor especificado usando o fuso horário da máquina virtual Java.

Use 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 anos)

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 método setYearLocalTime() em uma aplicação com escopo, use o método com escopo correspondente: setYearLocalTime().

GlideDateTime – setYearUTC(Número de ano)

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 método setYearUTC() em uma aplicação com escopo, use o método com escopo correspondente: setYearUTC().

GlideDateTime - subtract(tempo de GlideTime)

Subtrai uma quantidade especificada de tempo.

Tabela 158. Parâmetros
Nome	Tipo	Descrição
hora	GlideTime	O tempo para subtrair

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 método subtract() em uma aplicação com escopo, use o método com escopo correspondente: subtract().

GlideDateTime - subtract(Número 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 método subtract() em uma aplicação com escopo, use o método com escopo correspondente: subtract().

GlideDateTime - subtract (início de GlideDateTime, fim de GlideDateTime)

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

Tabela 162. Parâmetros
Nome	Tipo	Descrição
iniciar	GlideDateTime	Objeto de data de início.
terminar	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 método subtract() em uma aplicação com escopo, use o método com escopo correspondente: subtract().

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 no 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 método toString() em uma aplicação com escopo, use o método com escopo correspondente: toString().