GlideTime - Com escopo

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

Para obter orientação sobre cadeias de caracteres de entrada de data/hora com uma lista de conflitos de formato comuns, consulte Diretrizes de formato de data e hora.

GlideTime - GlideTime()

Instancia um objeto GlideTime com a hora atual.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

var gt = new GlideTime(); 
gs.info(gt.getDisplayValue());

GlideTime - GlideTime (número de milissegundos)

Instancia um objeto GlideTime com sua hora que começa à meia-noite UTC mais o valor passado.

O valor é ajustado para o fuso horário no qual a instância reside. Por exemplo, se a instância do usuário estiver em um fuso horário de -8 horas do UTC e 1000 for passado, a hora no objeto GlideTime será 16:00:10 (00:00:00 - 8 horas e 10 segundos.)

Tabela 2. Parâmetros

Nome	Tipo	Descrição
milissegundos	Número	Hora a ser adicionada à meia-noite UTC. Unidade: Milissegundos

Este exemplo mostra a adição de 10 segundos à meia-noite (UTC), que é ajustada para o fuso horário no qual a instância reside. Neste caso, -8 horas a partir do UTC.

var gt = new GlideTime(10000); 
gs.info(gt.getDisplayValue());

Saída:

16:00:10

GlideTime - getByFormat (formato de cadeia de caracteres)

Retorna a hora no formato especificado.

Para obter informações sobre os formatos de hora que você pode passar para este método, consulte Formato de campo de data e hora global . Você pode passar esses valores em qualquer ordem e adicionar separadores, como um traço, espaço, barra invertida ou dois pontos. Você também pode passar o caractere "a" para retornar am/pm.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
formato	Cadeia de caracteres	Cadeia de caracteres a ser usada para formatar a hora. Por exemplo, se a hora atual for 10:30:20, então: hh:mm:ss: 10:30:20 HH: 10 HH – ss: 10 –- 20 hh A: 10 AM S:m:H ss:mm:hh: 20:30:10 20:30:10 HH/mm/ss: 10/30/20

Tabela 4. Retornos

Tipo	Descrição
Cadeia de caracteres	Hora no formato especificado.

var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));

Saída:

12:00

GlideTime - getDisplayValue()

Obtém a hora no formato de exibição do usuário atual e o fuso horá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.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Cadeia de caracteres	A hora no formato e fuso horário do usuário.

var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

GlideTime - getDisplayValueInternal()

Obtém o valor de exibição no fuso horário do usuário atual e no formato interno (HH:mm:ss).

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de hora do objeto GlideTime no fuso horário do usuário atual e o formato de hora interno de HH:mm:ss.

var gt = new GlideTime();
gt.setValue("01:00:00"); //Internal Time Zone , UTC
gs.info(gt.getDisplayValueInternal()); //User Time Zone

GlideTime - getHourLocalTime()

Retorna a parte de horas do horário usando o fuso horário local.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
Número	As horas usando o fuso horário local.

GlideTime - getHourOfDayLocalTime()

Retorna a parte de horas do horário usando o fuso horário local. O número de horas é baseado em um relógio de 24 horas.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna

Tipo	Descrição
Número	As horas usando o fuso horário local. O número de horas é baseado em um relógio de 24 horas.

GlideTime - getHourOfDayUTC()

Retorna a parte de horas do horário usando o fuso horário UTC. O número de horas é baseado em um relógio de 24 horas.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Número	As horas usando o fuso horário UTC. O número de horas é baseado em um relógio de 24 horas.

GlideTime - getHourUTC()

Retorna a parte de horas do horário usando o fuso horário UTC. O número de horas é baseado em um relógio de 12 horas. Meio-dia e meia-noite são representados por 0, não 12.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna

Tipo	Descrição
Número	As horas usando o fuso horário UTC. O número de horas é baseado em um relógio de 12 horas. Meio-dia e meia-noite são representados por 0, não 12.

GlideTime - getMinutesLocalTime()

Retorna o número de minutos usando o fuso horário local.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

Tipo	Descrição
Número	O número de minutos usando o fuso horário local.

GlideTime - getMinutesUTC()

Retorna o número de minutos da hora com base no fuso horário UTC.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

Tipo	Descrição
Número	O número de minutos da hora usando o fuso horário UTC.

GlideTime - getSeconds()

Retorna o número de segundos no minuto atual.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna

Tipo	Descrição
Número	O número de segundos no minuto.

GlideTime - getValue()

Obtém o valor de hora armazenado no banco de dados pelo objeto GlideTime no formato interno, HH:mm:ss e o fuso horário do sistema.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 24. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de hora no fomat interno e no fuso horário do sistema.

var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

GlideTime - setDisplayValue(cadeia de caracteres asExibida)

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

Tabela 25. Parâmetros

Nome	Tipo	Descrição
AsExibido	Cadeia de caracteres	A hora no formato de exibição do usuário atual e no fuso horário. O parâmetro deve ser formatado usando o formato de exibição preferencial do usuário atual, como HH:mm:ss.

Tabela 26. Retornos

Tipo	Descrição
Nenhum

var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

GlideTime - setValue(cadeia de caracteres o)

Define a hora do objeto GlideTime no fuso horário interno.

Tabela 27. Parâmetros

Nome	Tipo	Descrição
o	Cadeia de caracteres	A hora no formato hh:mm:ss.

Tabela 28. Retornos

Tipo	Descrição
Nenhum

var gt = new GlideTime();
gt.setValue('01:00:00');  //Internal Time Zone, UTC
gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

GlideTime - subtrair (GlideTime startTime, GlideTime endTime)

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

Tabela 29. Parâmetros

Nome	Tipo	Descrição
startTime	GlideTime	O valor inicial.
endTime	GlideTime	O valor final.

Tabela 30. Retornos

Tipo	Descrição
GlideDuration	A duração entre os dois valores.

var gd1 = new GlideTime(); 
gd1.setDisplayValue("09:00:00"); 
var gd2 = new GlideTime(); 
gd2.setDisplayValue("09:10:00"); 
 
var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
gs.info(dur.getDisplayValue());