GlideDuration - com escopo

A classe GlideDuration fornece métodos para trabalhar com períodos de tempo conhecidos como durações.

Os objetos GlideDuration armazenam a duração como o número de dias e a hora a partir de 1º de janeiro de 1970, 00:00:00. Como resultado, os métodos setValue() e getValue() usam o objeto GlideDateTime com escopo para parâmetros e valores de retorno.

GlideDuration - GlideDuration()

Instancia um objeto GlideDuration.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

GlideDuration - GlideDuration (GlideDuration outro)

Instancia um objeto GlideDuration clonando os valores do objeto GlideDuration passado.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
outro	GlideDuration	Objeto GlideDuration.

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration(duration);
gs.info(duration2.getDisplayValue());

Saída:

3 Days 12 Hours

GlideDuration - GlideDuration (Número em milissegundos)

Instancia um objeto GlideDuration com a duração especificada em milissegundos.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
milissegundos	Número	Valor de duração. Unidade: Milissegundos

var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

Saída:

00:01:00

GlideDuration - GlideDuration(cadeia de caracteres displayValue)

Instancia um objeto GlideDuration com o valor de exibição de duração especificado.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
displayValue	Cadeia de caracteres	Valor de duração. Formato: d HH:mm:ss em que "d" é o número de dias.

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

Saída:

3 Days 15 Hours

GlideDuration - add(duração de GlideDuration)

Adiciona a duração do objeto GlideDuration especificado ao objeto GlideDuration atual.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
duração	GlideDuration	Objeto GlideDuration que contém o valor de duração a ser adicionado ao objeto GlideDuration atual.

Tabela 6. Retorna

Tipo	Descrição
GlideDuration	Novo objeto GlideDuration cuja duração é a soma das durações dos dois objetos GlideDuration.

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

Saída:

3 Days 15 Hours

GlideDuration – getByFormat(formato de cadeia de caracteres)

Retorna o valor da duração no formato especificado.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
formato	Cadeia de caracteres	Formato de duração. Formato: formato de campo de data e hora global

Tabela 8. Retorna

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

var dur = new GlideDuration('3 22:00:00');
gs.info(dur.getByFormat('HH:mm'));

Saída

22:00

GlideDuration – getDayPart()

Retorna o número de dias.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
Número	Número de dias na duração.

var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDayPart());

Saída:

3

GlideDuration com escopo - getDisplayValue()

Retorna o valor de exibição da duração em número de dias, horas e minutos.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna

Tipo	Descrição
Cadeia de caracteres	Número de dias, horas e minutos, como 2 dias, 10 horas e 36 minutos. Formato: Valor de exibição: "n" Dias "n" Horas "n" Minutos

var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDisplayValue());

Saída:

3 Days 12 Hours

GlideDuration – getDurationValue()

Retorna o valor de duração no formato "d HH:mm:ss".

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor de duração. Formato: d HH:mm:ss em que "d" é o número de dias.

var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

Saída:

00:01:00

GlideDuration – getRoundedDayPart()

Retorna o número arredondado de dias. Se a parte de tempo for superior a 12 horas, o valor de retorno será arredondado para cima. Caso contrário, será arredondado para baixo.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna

Tipo	Descrição
Número	Valor de dia do valor de exibição arredondado.

var dur = new GlideDuration('3 14:00:00');
gs.info(dur.getRoundedDayPart());

Saída:

4

GlideDuration – getValue()

Retorna o valor de data/hora interno do objeto GlideDuration atual.

Os objetos GlideDuration armazenam a duração como data e hora a partir de 1º de janeiro de 1970, 00:00:00.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

Tipo	Descrição
Cadeia de caracteres	Duração atual no objeto GlideDuration. Formato: AAAA-MM-DD HH:mm:ss

var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getValue());

Saída:

1970-01-04 12:00:00

GlideDuration – setDisplayValue(String asDisplayed)

Define o valor de exibição da duração.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
comoExibido	Cadeia de caracteres	Valor de duração de exibição a ser definido. Formato: d HH:mm:ss em que "d" é o número de dias

Tabela 20. Retorna

Tipo	Descrição
Nenhum(a)

var dur = new GlideDuration(); 
dur.setDisplayValue('3 08:00:00');
gs.info(dur.getDisplayValue());

Saída:

3 Days 8 Hours

GlideDuration – setValue(Object o)

Define o valor de data/hora interno do objeto GlideDuration.

O método define o valor de duração como a diferença entre a data/hora aprovada e o valor de data/hora base de 1º de janeiro de 1970, 00:00:00. O objeto de data/hora passado (cadeia de caracteres) é analisado em um objeto GlideDateTime.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
o	Objeto	Data e hora a serem usadas como endpoint para o tempo de duração calculado. Formato: AAAA-MM-DD HH:mm:ss

Tabela 22. Retorna

Tipo	Descrição
Nenhum(a)

var dur = new GlideDuration();
dur.setValue('1970-01-05 08:00:00'); // sets internal DateTime value. The String is parsed into a GlideDateTime object.
gs.info(dur.getDisplayValue());

Saída:

4 Days 8 Hours

GlideDuration - subtract(duração de GlideDuration)

Subtrai a duração do objeto GlideDuration especificado do objeto GlideDuration atual.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
duração	GlideDuration	Objeto GlideDuration que contém o valor de duração a ser subtraído do objeto GlideDuration atual.

Tabela 24. Retorna

Tipo	Descrição
GlideDuration	Novo objeto GlideDuration cuja duração contém o resultado da subtração da duração dos dois objetos GlideDuration.

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.subtract(duration2);
gs.info(answer.getDisplayValue());

Saída:

3 Days 9 Hours