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


---

# GlideTime - Com escopo

# GlideTime - 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) 5 min. de leitura

A API GlideTime 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](https://servicenow-prod.fluidtopics.net/t5OHiOi5A1ubcXB2EjjxWw#date-and-time-format-guidelines "Você pode especificar um formato de data com uma sequência de cadeias de caracteres de padrão de data e hora específicas. Uma cadeia de caracteres padrão consiste em uma ou mais letras maiúsculas e minúsculas de A a Z. Qualquer texto entre aspas é ignorado e, em vez disso, é copiado na saída de data.").

## GlideTime --- GlideTime() {#ariaid-title2}

Instancia um objeto GlideTime com a hora atual.
{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r__entry__3}

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

{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r}  

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

## GlideTime -- GlideTime(Número em milissegundos) {#ariaid-title3}

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

| Nome | Tipo | Descrição |
|-|-|-|
| milissegundos | Número | Hora de adicionar à meia-noite UTC. Unidade: Milissegundos |
[Tabela 2. Parâmetros]

{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq}  
Este exemplo mostra a adição de 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 -- getByFormat(formato de cadeia de caracteres) {#ariaid-title4}

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

| 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 = 10/30/20 {#r_ScopedGlideTimeGetByFormat_String__ul_cdw_4zy_jkb} |
[Tabela 3. Parâmetros]

{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Hora no formato especificado. |
[Tabela 4. Retorna]

{#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq}  

    var gt = new GlideTime(); 
    gt.setValue('12:00:00');
    gs.info(gt.getByFormat("HH:mm"));

Saída:

    12:00

## GlideTime -- getDisplayValue() {#ariaid-title5}

Obtém a hora no formato de exibição e fuso horário do usuário atual.
Ao projetar regras de negócio ou inclusões de script, lembre-se de que este método pode retornar valores em formatos diferentes para usuários diferentes.
{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A hora no formato e fuso horário do usuário. |
[Tabela 6. Retorna]

{#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setDisplayValue("12:00:00"); // User Time Zone
    gs.info(gt.getDisplayValue()); // User Time Zone

## GlideTime -- getDisplayValueInternal() {#ariaid-title6}

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

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

{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| 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 tempo interno de HH:mm:ss. |
[Tabela 8. Retorna]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setValue("01:00:00"); //Internal Time Zone , UTC
    gs.info(gt.getDisplayValueInternal()); //User Time Zone

## GlideTime -- getHourLocalTime() {#ariaid-title7}

Retorna a parte de horas do tempo usando o fuso horário local.
{#r_SGT-getHourLocalTime__table_pwr_c2d_kw__entry__3}

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

{#r_SGT-getHourLocalTime__table_pwr_c2d_kw} {#r_SGT-getHourLocalTime__table_qwr_c2d_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Número | As horas usando o fuso horário local. |
[Tabela 10. Retorna]

{#r_SGT-getHourLocalTime__table_qwr_c2d_kw}

## GlideTime -- getHourOfDayLocalTime() {#ariaid-title8}

Retorna a parte de horas do tempo usando o fuso horário local. O número de horas é baseado em um relógio de 24 horas.
{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw__entry__3}

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

{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw} {#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw__entry__2}

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

{#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw}

## GlideTime -- getHourOfDayUTC() {#ariaid-title9}

Retorna a parte de horas do tempo usando o fuso horário UTC. O número de horas é baseado em um relógio de 24 horas.
{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw__entry__3}

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

{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw} {#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw__entry__2}

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

{#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw}

## GlideTime -- getHourUTC() {#ariaid-title10}

Retorna a parte de horas do tempo 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.
{#r_SGT-getHourUTC__table_cfh_nyc_kw__entry__3}

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

{#r_SGT-getHourUTC__table_cfh_nyc_kw} {#r_SGT-getHourUTC__table_dfh_nyc_kw__entry__2}

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

{#r_SGT-getHourUTC__table_dfh_nyc_kw}

## GlideTime -- getMinutesLocalTime() {#ariaid-title11}

Retorna o número de minutos usando o fuso horário local.
{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw__entry__3}

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

{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw} {#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de minutos usando o fuso horário local. |
[Tabela 18. Retorna]

{#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw}

## GlideTime -- getMinutesUTC() {#ariaid-title12}

Retorna o número de minutos na hora com base no fuso horário UTC.
{#r_SGT-getMinutesUTC__table_qvr_xcd_kw__entry__3}

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

{#r_SGT-getMinutesUTC__table_qvr_xcd_kw} {#r_SGT-getMinutesUTC__table_rvr_xcd_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de minutos na hora usando o fuso horário UTC. |
[Tabela 20. Retorna]

{#r_SGT-getMinutesUTC__table_rvr_xcd_kw}

## GlideTime -- getSeconds() {#ariaid-title13}

Retorna o número de segundos no minuto atual.
{#r_SGT-getSeconds__table_dkh_1fd_kw__entry__3}

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

{#r_SGT-getSeconds__table_dkh_1fd_kw} {#r_SGT-getSeconds__table_ekh_1fd_kw__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O número de segundos no minuto. |
[Tabela 22. Retorna]

{#r_SGT-getSeconds__table_ekh_1fd_kw}

## GlideTime -- getValue() {#ariaid-title14}

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

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

{#r_ScopedGlideTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O valor de tempo no formato interno e no fuso horário do sistema. |
[Tabela 24. Retorna]

{#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq}  

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

## GlideTime -- setDisplayValue(String asDisplayed) {#ariaid-title15}

Define um valor de tempo usando o formato de exibição e o fuso horário do usuário atual.
{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 26. Retorna]

{#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1}  

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

## GlideTime -- setValue(String o) {#ariaid-title16}

Define a hora do objeto GlideTime no fuso horário interno.
{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| o | Cadeia de caracteres | A hora no formato hh:mm:ss. |
[Tabela 27. Parâmetros]

{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 28. Retorna]

{#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setValue('01:00:00');  //Internal Time Zone, UTC
    gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

## GlideTime - subtract(GlideTime startTime, GlideTime endTime) {#ariaid-title17}

Obtém a diferença de duração entre dois valores de objeto GlideTime.
{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| startTime | GlideTime | O valor inicial. |
| endTime | GlideTime | O valor final. |
[Tabela 29. Parâmetros]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq} {#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| GlideDuration | A duração entre os dois valores. |
[Tabela 30. Retorna]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq}  

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