---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDuration - com escopo

# GlideDuration - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

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() {#ariaid-title2}

Instancia um objeto GlideDuration.
{#r_ScopedGlideDurationGlideDuration__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#r_ScopedGlideDurationGlideDuration__table_vy2_525_jq}

## GlideDuration - GlideDuration (GlideDuration outro) {#ariaid-title3}

Instancia um objeto GlideDuration clonando os valores do objeto GlideDuration passado.
{#r_ScopedGlideDurationGlideDuration_GlideDuration__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| outro | GlideDuration | Objeto GlideDuration. |
[Tabela 2. Parâmetros]

{#r_ScopedGlideDurationGlideDuration_GlideDuration__table_vy2_525_jq}  

    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) {#ariaid-title4}

Instancia um objeto GlideDuration com a duração especificada em milissegundos.
{#r_ScopedGlideDurationGlideDuration_Number__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| milissegundos | Número | Valor de duração. Unidade: Milissegundos |
[Tabela 3. Parâmetros]

{#r_ScopedGlideDurationGlideDuration_Number__table_vy2_525_jq}  

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

Saída:

    00:01:00

## GlideDuration - GlideDuration(cadeia de caracteres displayValue) {#ariaid-title5}

Instancia um objeto GlideDuration com o valor de exibição de duração especificado.
{#r_ScopedGlideDurationGlideDuration_String__table_vy2_525_jq__entry__3}

| 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. |
[Tabela 4. Parâmetros]

{#r_ScopedGlideDurationGlideDuration_String__table_vy2_525_jq}  

    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) {#ariaid-title6}

Adiciona a duração do objeto GlideDuration especificado ao objeto GlideDuration atual.
{#r_ScopedGlideDurationAdd_GlideDuration__table_vy2_525_jq__entry__3}

| 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 5. Parâmetros]

{#r_ScopedGlideDurationAdd_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDuration | Novo objeto GlideDuration cuja duração é a soma das durações dos dois objetos GlideDuration. |
[Tabela 6. Retorna]

{#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq}  

    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) {#ariaid-title7}

Retorna o valor da duração no formato especificado.
{#r_ScopedGlideDurationGetByFormat_String__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| formato | Cadeia de caracteres | Formato de duração. Formato: [formato de campo de data e hora global](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) |
[Tabela 7. Parâmetros]

{#r_ScopedGlideDurationGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDurationGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Duração atual no formato especificado. |
[Tabela 8. Retorna]

{#r_ScopedGlideDurationGetByFormat_String__table_qpt_3f5_jq}  

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

Saída

    22:00

## GlideDuration -- getDayPart() {#ariaid-title8}

Retorna o número de dias.
{#r_ScopedGlideDurationGetDayPart__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 9. Parâmetros]

{#r_ScopedGlideDurationGetDayPart__table_vy2_525_jq} {#r_ScopedGlideDurationGetDayPart__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Número de dias na duração. |
[Tabela 10. Retorna]

{#r_ScopedGlideDurationGetDayPart__table_qpt_3f5_jq}  

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

Saída:

    3

## GlideDuration com escopo - getDisplayValue() {#ariaid-title9}

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

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 11. Parâmetros]

{#r_ScopedGlideDurationGetDisplayValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetDisplayValue__table_qpt_3f5_jq__entry__2}

| 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 |
[Tabela 12. Retorna]

{#r_ScopedGlideDurationGetDisplayValue__table_qpt_3f5_jq}  

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

Saída:

    3 Days 12 Hours

## GlideDuration -- getDurationValue() {#ariaid-title10}

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

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 13. Parâmetros]

{#r_ScopedGlideDurationGetDurationValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetDurationValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de duração. Formato: d HH:mm:ss em que "d" é o número de dias. |
[Tabela 14. Retorna]

{#r_ScopedGlideDurationGetDurationValue__table_qpt_3f5_jq}  

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

Saída:

    00:01:00

## GlideDuration -- getRoundedDayPart() {#ariaid-title11}

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.
{#r_ScopedGlideDurationGetRoundedDayPart__table_vy2_565_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 15. Parâmetros]

{#r_ScopedGlideDurationGetRoundedDayPart__table_vy2_565_jq} {#r_ScopedGlideDurationGetRoundedDayPart__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor de dia do valor de exibição arredondado. |
[Tabela 16. Retorna]

{#r_ScopedGlideDurationGetRoundedDayPart__table_qpt_3f5_jq}  

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

Saída:

    4

## GlideDuration -- getValue() {#ariaid-title12}

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.
{#r_ScopedGlideDurationGetValue__table_vy2_565_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 17. Parâmetros]

{#r_ScopedGlideDurationGetValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Duração atual no objeto GlideDuration. Formato: AAAA-MM-DD HH:mm:ss |
[Tabela 18. Retorna]

{#r_ScopedGlideDurationGetValue__table_qpt_3f5_jq}  

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

Saída:

    1970-01-04 12:00:00

## GlideDuration -- setDisplayValue(String asDisplayed) {#ariaid-title13}

Define o valor de exibição da duração.
{#r_ScopedGlideDurationSetDisplayValue_String__table_vy2_525_jq__entry__3}

| 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 19. Parâmetros]

{#r_ScopedGlideDurationSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDurationSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 20. Retorna]

{#r_ScopedGlideDurationSetDisplayValue_String__table_qpt_3f5_jq1}  

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

Saída:

    3 Days 8 Hours

## GlideDuration -- setValue(Object o) {#ariaid-title14}

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.
{#r_ScopedGlideDurationSetValue_Object__table_vy2_525_jq__entry__3}

| 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 21. Parâmetros]

{#r_ScopedGlideDurationSetValue_Object__table_vy2_525_jq} {#r_ScopedGlideDurationSetValue_Object__table_qpt_3f5_jq1__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 22. Retorna]

{#r_ScopedGlideDurationSetValue_Object__table_qpt_3f5_jq1}  

    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) {#ariaid-title15}

Subtrai a duração do objeto GlideDuration especificado do objeto GlideDuration atual.
{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq__entry__3}

| 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 23. Parâmetros]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDuration | Novo objeto GlideDuration cuja duração contém o resultado da subtração da duração dos dois objetos GlideDuration. |
[Tabela 24. Retorna]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1}  

    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