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, setValue() e getValue() usam o objeto GlideDateTime com escopo para parâmetros e valores de retorno.

GlideDuration com escopo - add(duração de GlideDuration)

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

Tabela 1. 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 2. 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 com escopo - getByFormat(cadeia de caracteres format)

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

Tabela 3. Parâmetros

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

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

Retorna o número de dias.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. 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 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Cadeia de caracteres	Número de dias, horas e minutos, como 2 dias 10 horas 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 com escopo - GlideDuration()

Instancia um objeto GlideDuration.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

GlideDuration com escopo - getDurationValue()

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

Tabela 10. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 11. 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 com escopo - getRoundedDayPart()

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

Tabela 12. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 13. Retorna

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

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

Saída

4

GlideDuration com escopo - getValue()

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

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

Tabela 14. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 15. 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 com escopo - GlideDuration(GlideDuration outro)

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

Tabela 16. 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 com escopo - GlideDuration(Número milissegundos)

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

Tabela 17. 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 com escopo - GlideDuration(cadeia de caracteres displayValue)

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

Tabela 18. 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 com escopo - setDisplayValue(cadeia de caracteres asDisplayed)

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

Tabela 19. Parâmetros

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

Tabela 20. Retorna

Tipo	Descrição
Nenhum

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

Saída

3 Days 8 Hours

GlideDuration com escopo - setValue(Object o)

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

O método define o valor da duração como a diferença da data/hora passada para o valor base de data/hora de 1º de janeiro de 1970, 00:00:00. O objeto de data/hora (cadeia de caracteres) passado é 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

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