GlideTime - Com escopo

A classe GlideTime com escopo 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 com escopo - getByFormat(cadeia de caracteres format)

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 global de campo de data e hora. 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 1. 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.SSSZ = 10:30:20.000+0000 HH/mm/ss = 30/10/20

Tabela 2. Retorna

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 com escopo - getDisplayValue()

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

Ao projetar regras de negócios ou inclusões de script, lembre-se de que este método pode retornar valores em formatos diferentes para usuários diferentes.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. 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 com escopo - getDisplayValueInternal()

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

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. 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 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 com escopo - getHourLocalTime()

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

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

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

GlideTime com escopo - getHourOfDayLocalTime()

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

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. O número de horas é baseado em um relógio de 24 horas.

GlideTime com escopo - getHourOfDayUTC()

Retorna as horas usando o fuso horário UTC. 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 UTC. O número de horas é baseado em um relógio de 24 horas.

GlideTime com escopo - getHourUTC()

Retorna 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.

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 12 horas. Meio-dia e meia-noite são representados por 0, não 12.

GlideTime com escopo - getMinutesLocalTime()

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

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna

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

GlideTime com escopo - getMinutesUTC()

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

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

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

GlideTime com escopo - getSeconds()

Retorna o número de segundos no minuto atual.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

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

GlideTime com escopo - 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 21. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna

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

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

GlideTime com escopo - GlideTime()

Instancia um objeto GlideTime com a hora atual.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
Nenhum

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

GlideTime com escopo - GlideTime(Number 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 24. Parâmetros

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

Este exemplo mostra como adicionar 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 com escopo - setDisplayValue(cadeia de caracteres asDisplayed)

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
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. Retorna

Tipo	Descrição
Nenhum

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

GlideTime com escopo - 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. Retorna

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 com escopo - 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. Retorna

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());