GlideTime - Com escopo

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 8 min. de leitura

    • . GlideTime A API 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/hora com uma lista de conflitos de formato comuns, consulte Diretrizes de formato de data e hora.

    GlideTime - GlideTime()

    Instancia um objeto GlideTime com a hora atual.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum 
    var gt = new GlideTime(); 
gs.info(gt.getDisplayValue());

    GlideTime - GlideTime (número de milissegundos)

    Instancia um objeto GlideTime com sua hora começando à meia-noite UTC mais o valor passado.

    O valor é ajustado para o fuso horário em que a instância reside. Por exemplo, se a instância do usuário estiver em um fuso horário a -8 horas do UTC e 1000 for passado, a hora no objeto GlideTime será 16:00:10 (00:00:00 a 8 horas e 10 segundos.)

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    milissegundos Número Hora a ser adicionada à meia-noite UTC.

    Unidade: Milissegundos

    Este exemplo mostra a adição de 10 segundos à meia-noite (UTC), que é ajustada para o fuso horário no qual a instância reside. Neste 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)

    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 . Você pode passar esses valores em qualquer ordem e adicionar separadores, como traço, espaço, barra invertida ou dois pontos. Além disso, você também pode passar o caractere "a" para retornar am/pm.

    Tabela 3. Parâmetros
    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:
    • 10:30:20
    • 10
    • -- ss: 10 -- 20
    • AM: 10 AM
    • S:m:H ss:mm:hh: 20:30:10 20:30:10
    • HH/mm/ss é igual a 10/30/20
    Tabela 4. Retornos
    Tipo Descrição
    Cadeia de caracteres Hora no formato especificado. 
    var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));
    Saída: 
    12:00

    GlideTime - getDisplayValue()

    Obtém a hora no formato de exibição e fuso horário do usuário atual.

    Ao projetar regras de negócios ou inclusões de script, lembre-se de que esse método pode retornar valores em formatos diferentes para usuários diferentes.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres A hora no formato e fuso horário do usuário. 
    var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

    GlideTime - getDisplayValueEx (estilo de cadeia de caracteres)

    Retorna a hora usando o fuso horário do usuário atual e um formato especificado.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    estilo Cadeia de caracteres Formato a ser usado para a hora.
    Valores válidos (não diferencia maiúsculas de minúsculas):
    • curto : HH:MM (AM/PM)
    • médio : HH:mm:ss (AM/PM)
    • longo Abreviação do fuso horário HH:mm:ss (AM/PM)
    • cheio Fuso horário: HH:mm:ss (AM/PM)

    A hora é retornada no idioma do usuário atual. O idioma determina se a hora é retornada no formato de 12 horas ou 24 horas.
    Tabela 8. Retornos
    Tipo Descrição
    Cadeia de caracteres A hora no formato especificado.

    Este exemplo retorna a hora usando o fuso horário do usuário atual e cada opção de formatação.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueEx("short"));
gs.info(gt.getDisplayValueEx("medium"));
gs.info(gt.getDisplayValueEx("long"));
gs.info(gt.getDisplayValueEx("full"));

    Saída:

    8:52 AM  //short
8:52:24 AM  //medium
8:52:24 AM PST  //long
8:52:24 AM Pacific Standard Time  //full

    GlideTime - getDisplayValueInternal()

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

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres O valor de hora do objeto GlideTime no fuso horário do usuário atual e o formato de hora interno HH:mm:ss. 
    var gt = new GlideTime();
gt.setValue("01:00:00"); //Internal Time Zone , UTC
gs.info(gt.getDisplayValueInternal()); //User Time Zone

    GlideTime - getDisplayValueLang(estilo de cadeia de caracteres, idioma da cadeia de caracteres)

    Retorna a hora usando o fuso horário do usuário atual e um formato e idioma especificados.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    estilo Cadeia de caracteres Formato a ser usado para a hora.
    Valores válidos (não diferencia maiúsculas de minúsculas):
    • curto : HH:MM (AM/PM)
    • médio : HH:mm:ss (AM/PM)
    • longo Abreviação do fuso horário HH:mm:ss (AM/PM)
    • cheio Fuso horário: HH:mm:ss (AM/PM)
    idioma Cadeia de caracteres Opcional. Idioma para retornar a hora, fornecido como um marcador de idioma BCP 47. Por exemplo, para retornar a hora em japonês, use o marcador sim .

    O idioma determina se a hora é retornada no formato de 12 horas ou 24 horas. Por exemplo, os horários em inglês usam o formato de 12 horas, enquanto os horários em japonês usam o formato de 24 horas.

    Padrão: Idioma do usuário atual.
    Tabela 12. Retornos
    Tipo Descrição
    Cadeia de caracteres A hora no formato e idioma especificados.

    Este exemplo retorna a hora em espanhol usando o fuso horário do usuário atual e cada opção de formatação.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueLang("short", "es"));
gs.info(gt.getDisplayValueLang("medium", "es"));
gs.info(gt.getDisplayValueLang("long", "es"));
gs.info(gt.getDisplayValueLang("full", "es"));

    Saída:

    9:25  //short
9:25:44  //medium
9:25:44 PST  //long
9:25:44 (hora estándar del Pacífico)  //full

    GlideTime - getHourLocalTime()

    Retorna a parte de horas do horário usando o fuso horário local.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Número As horas usando o fuso horário local.

    GlideTime - getHourOfDayLocalTime()

    Retorna a parte de horas do horário usando o fuso horário local. O número de horas é baseado em um relógio de 24 horas.

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

    GlideTime - getHourOfDayUTC()

    Retorna a parte de horas do horário usando o fuso horário UTC. O número de horas é baseado em um relógio de 24 horas.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    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.

    GlideTime - getHourUTC()

    Retorna a parte de horas do horário 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 19. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 20. Retorna
    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.

    GlideTime - getMinutesLocalTime()

    Retorna o número de minutos usando o fuso horário local.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    Número O número de minutos usando o fuso horário local.

    GlideTime - getMinutesUTC()

    Retorna o número de minutos na hora com base no fuso horário UTC.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Número O número de minutos na hora usando o fuso horário UTC.

    GlideTime - getSeconds()

    Retorna o número de segundos no minuto atual.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 26. Retorna
    Tipo Descrição
    Número O número de segundos no minuto.

    GlideTime - getValue()

    Obtém o valor de hora armazenado no banco de dados pelo objeto GlideTime no formato interno, HH:mm:ss e o fuso horário do sistema.

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 28. Retorna
    Tipo Descrição
    Cadeia de caracteres O valor de hora no fomat interno e no fuso horário do sistema. 
    var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

    GlideTime - setDisplayValue(cadeia de caracteres asExibido)

    Define um valor de hora usando o formato de exibição e o fuso horário do usuário atual.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    Exibido 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 30. Retornos
    Tipo Descrição
    Nenhum 
    var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

    GlideTime - setDisplayValueEx(Tempo da cadeia de caracteres, estilo da cadeia de caracteres)

    Define a hora usando o fuso horário do usuário atual e um formato especificado.

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    hora Cadeia de caracteres Valor a ser definido para o tempo.
    . DisplayValueEx() o método retorna horas em um formato válido ou as horas podem ser formatadas conforme mostrado abaixo.
    • HH:MM (AM/PM)
    • HH:mm:ss (AM/PM)
    • Abreviação do fuso horário HH:mm:ss (AM/PM)
    • Fuso horário HH:mm:ss (AM/PM)
    O idioma do usuário atual determina se os valores de 12 hora (AM/PM) ou 24 horas são aceitos. Por exemplo, se o idioma do usuário atual for inglês 6:25 PST é um valor válido enquanto 18:25 PST não é.
    estilo Cadeia de caracteres Formato a ser usado para a hora.

    Você deve usar o mesmo formato fornecido timevalor.

    Valores válidos (não diferencia maiúsculas de minúsculas):
    • curto : HH:MM (AM/PM)
    • médio : HH:mm:ss (AM/PM)
    • longo Abreviação do fuso horário HH:mm:ss (AM/PM)
    • cheio Fuso horário: HH:mm:ss (AM/PM)
    Tabela 32. Retornos
    Tipo Descrição
    Nenhum(a)

    Este exemplo define a hora usando o fuso horário do usuário atual e um formato especificado.

    gt = new GlideTime();
gt.setDisplayValueEx("8:25:25 AM", "medium");
gs.info(gt.getDisplayValueEx("full"));

    Saída:

    8:25:25 AM Pacific Standard Time

    GlideTime - setDisplayValueLang(String time, estilo de cadeia de caracteres, idioma da cadeia de caracteres)

    Define a hora usando o fuso horário do usuário atual e um formato e idioma especificados.

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    hora Cadeia de caracteres Valor a ser definido para o tempo.
    . DisplayValueLang() e. DisplayValueEx() os métodos retornam horas em um formato válido ou as horas podem ser formatadas conforme mostrado abaixo.
    • HH:MM (AM/PM)
    • HH:mm:ss (AM/PM)
    • Abreviação do fuso horário HH:mm:ss (AM/PM)
    • Fuso horário HH:mm:ss (AM/PM)
    . languageO parâmetro determina se os valores de tempo de 12 hora (AM/PM) ou 24 horas são aceitos. Por exemplo, se o idioma for pt (Inglês), 6:25 PST é um valor válido enquanto 18:25 PST não é.
    estilo Cadeia de caracteres Formato a ser usado para a hora.

    Você deve usar o mesmo formato fornecido timevalor.

    Valores válidos (não diferencia maiúsculas de minúsculas):
    • curto : HH:MM (AM/PM)
    • médio : HH:mm:ss (AM/PM)
    • longo Abreviação do fuso horário HH:mm:ss (AM/PM)
    • cheio Fuso horário: HH:mm:ss (AM/PM)
    idioma Cadeia de caracteres Idioma para definir a hora, fornecido como um marcador de idioma BCP 47. Por exemplo, para definir a hora em japonês, use o marcador sim .
    Tabela 34. Retornos
    Tipo Descrição
    Nenhum(a)

    Este exemplo define a hora em inglês usando o fuso horário do usuário atual e a recupera em espanhol.

    gt = new GlideTime();
gt.setDisplayValueLang("4:15:00 PM PST", "long", "en");
gs.info(gt.getDisplayValueLang("full", "es"));

    Saída:

    16:15:00 (hora estándar del Pacífico)

    GlideTime - setValue(cadeia de caracteres o)

    Define a hora do objeto GlideTime no fuso horário interno.

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    o Cadeia de caracteres A hora no formato hh:mm:ss.
    Tabela 36. Retornos
    Tipo Descrição
    Nenhum 
    var gt = new GlideTime();
gt.setValue('01:00:00');  //Internal Time Zone, UTC
gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

    GlideTime - subtrair (GlideTime startTime, GlideTime endTime)

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

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    startTime GlideTime O valor inicial.
    endTime GlideTime O valor final.
    Tabela 38. Retornos
    Tipo Descrição
    GlideDuration A duração entre os dois valores. 
    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());