GlideDuration - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • . GlideDuration a classe 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 horas a partir de 1 de janeiro de 1970, 00:00:00. Como resultado, o SetValue() e. GetValue() Os métodos 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 passado no GlideDuration.

    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 de milissegundos)

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

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    milissegundos Número Valor da duração.

    Unidade: Milissegundos

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

    Saída:

    00:01:00

    GlideDuration - GlideDuration (valor de exibição da cadeia de caracteres)

    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 da 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 - adicionar (duração do 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. Retornos
    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. Retornos
    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.

    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 da 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 da 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, ele será arredondado para baixo.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. 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 - getValue()

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

    Os objetos GlideDuration armazenam a duração como uma 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(cadeia de caracteres asExibida)

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

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    AsExibido Cadeia de caracteres Valor de duração da exibição a ser definido.

    Formato: d HH:mm:ss, em que "d" é o número de dias

    Tabela 20. Retornos
    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 interno de data/hora do objeto GlideDuration.

    O método define o valor de duração como a diferença da data/hora aprovada e o valor de data/hora base de 1 de janeiro de 1970, 00:00:00. O objeto de data/hora aprovado (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. Retornos
    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 - subtrair (duração do GlideDuration)

    Subtrai a duração do objeto GlideDuration especificado para o 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. Retornos
    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