GlideTime - Com escopo

A API GlideTime 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 e 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 em milissegundos)

Instancia um objeto GlideTime com sua hora começando à 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 em relação ao UTC e 1000 for passado, a hora no objeto GlideTime será 16:00:10 (00:00:00 - 8 horas +10 segundos.)

Tabela 2. Parâmetros

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

Este exemplo mostra a adição de 10 segundos à meia-noite (UTC), que é ajustado para o fuso horário no qual a instância reside. Nesse 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 hífen, espaço, barra invertida ou dois pontos. Além disso, 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 e fuso horário do usuário atual.

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 usuários diferentes.

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 tempo do objeto GlideTime no fuso horário do usuário atual e o formato de tempo 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 tempo 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 tempo 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 tempo 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 tempo 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 na 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 na 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 tempo 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 tempo no formato interno e no fuso horário do sistema.

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

GlideTime – setDisplayValue(String asDisplayed)

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

Tabela 25. Parâmetros

Nome	Tipo	Descrição
comoExibido	Cadeia de caracteres	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 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(String 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 - subtract(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());