GlideDateTime - com escopo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 28 min. de leitura

    • A classe GlideDateTime com escopo fornece métodos para executar operações em objetos GlideDateTime.

    Use os métodos GlideDateTime para executar operações de data e hora, como instanciar um objeto GlideDateTime, executar cálculos de data e hora, formatar uma data e hora ou converter entre formatos de data e hora.

    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.

    GlideDateTime com escopo – GlideDateTime()

    Instancia um novo objeto GlideDateTime com a data e hora atuais.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum(a)

    Este exemplo instancia um objeto GlideDateTime.

    var gdt = new GlideDateTime();
gs.info(gdt);

    Saída:

    2022-08-08 16:51:44

    GlideDateTime com escopo - GlideDateTime (valor de cadeia de caracteres)

    Instancia um novo objeto GlideDateTime usando o valor de data e hora passado.

    O sistema tenta corresponder o valor passado com o formato do sistema interno especificado. Se o argumento não corresponder ao formato do sistema, o sistema tentará combiná-lo com um dos seguintes formatos, nesta ordem:
    • aaaa-MM-dd HH:mm:ss
    • MM/dd/aaaa HH:mm:ss
    • MM-dd-aaaa HH:mm:ss
    • MM-dd-aaaa HH:mm
    • MM-dd-aaaa
    • MM/dd/aaaa
    • dd-MM-aaaa HH:mm:ss
    • dd-MM-aaaa HH.mm.ss
    • dd-MM-aaaa HH.mm
    • dd-MM-aa HH.mm.ss
    • dd/MM/aaaa
    • dd-MM-aaaa
    • aaaa-MM-dd HH:mm
    • aaaa-MM-dd
    • dd.MM.aaaa HH:mm:ss
    • dd.MM.aaaa HH.mm.ss
    • dd.MM.aaaa hh:mm:ss a
    • dd.MM.yyyy hh.mm.ss a
    • dd.MM.aaaa
    Nota:
    O seguinte formato não é compatível:
    • aaaa-MM-dd'T'HH:mm:ss.SSSZ
    Tabela 2. Parâmetros
    Nome Tipo Descrição
    valor Cadeia de caracteres Data e hora UTC a serem definidas no objeto GlideDateTime.

    Este exemplo mostra como instanciar um objeto GlideDateTime usando uma cadeia de caracteres.

    var gdt = new GlideDateTime("2023-01-01 12:00:00");
gs.info(gdt);

    Saída:

    2023-01-01 12:00:00

    GlideDateTime com escopo - GlideDateTime(GlideDateTime g)

    Instancia um novo objeto GlideDateTime definido com a hora de um objeto GlideDateTime especificado.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    g GlideDateTime Objeto usado para definir a hora do novo objeto.

    Este exemplo mostra como instanciar um objeto GlideDateTime (gdt1) usando uma cadeia de caracteres no formato aaaa-MM-dd HH:mm:sse um segundo objeto GlideDateTime (gdt2) usando gdt1.

    var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
gs.info(gdt1);
gs.info(gdt2);

    Saída:

    2025-01-28 12:00:00
2025-01-28 12:00:00

    GlideDateTime com escopo - add(GlideTime gd)

    Adiciona um objeto GlideTime ao objeto GlideDateTime atual.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    gd GlideTime Objeto GlideTime cujo valor de tempo será adicionado ao objeto GlideDateTime especificado.
    Tabela 5. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));

    Saída:

    08:00:20

    GlideDateTime com escopo - add(Número milissegundos)

    Adiciona o número especificado de milissegundos ao objeto GlideDateTime atual.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    milissegundos Número O número de milissegundos a serem adicionados.
    Tabela 7. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());
gdt.add(10);
gs.info(gdt.getNumericValue());
    Saída: 
    1314777600000 1314777600010

    GlideDateTime com escopo - addDaysLocalTime(Number days)

    Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora locais.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    dias Número O número de dias a serem adicionados. Use um valor negativo para subtrair.
    Tabela 9. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.info(gdt.getLocalDate());

    Saída:

    2011-08-30

    GlideDateTime com escopo – addDaysUTC(Número de dias)

    Adiciona um número especificado de dias ao objeto GlideDateTime atual. Um parâmetro negativo subtrai dias. O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai dias usando os valores de data e hora UTC.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    dias Número O número de dias a serem adicionados. Use um número negativo para subtrair.
    Tabela 11. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.info(gdt.getDate());

    Saída:

     2011-08-30

    GlideDateTime com escopo - addMonthsLocalTime(Número de meses)

    Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora locais.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    meses Número O número de meses a serem adicionados. use um valor negativo para subtrair.
    Tabela 13. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.info(gdt.getDate());

    Saída:

    2011-10-31

    GlideDateTime com escopo – addMonthsUTC(Número de meses)

    Adiciona um número especificado de meses ao objeto GlideDateTime atual. Um parâmetro negativo subtrai meses. O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai meses usando os valores de data e hora UTC.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    meses Número O número de meses a serem adicionados. Use um valor negativo para subtrair.
    Tabela 15. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.info(gdt.getDate());

    Saída:

    2011-10-31

    GlideDateTime com escopo - addSeconds (Número de segundos)

    Adiciona o número especificado de segundos ao objeto GlideDateTime atual.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    segundos Número O número de segundos a serem adicionados.
    Tabela 17. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.info(gdt.getValue());

    Saída:

    2011-12-07 08:16:40

    GlideDateTime com escopo - addWeeksLocalTime(Número de semanas)

    Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e adiciona ou subtrai semanas usando os valores de data e hora locais.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    Semanas Número O número de semanas a serem adicionadas. Use um valor negativo para subtrair.
    Tabela 19. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.info(gdt.getDate());

    Saída:

    2011-08-24

    GlideDateTime com escopo - addWeeksUTC(Número de semanas)

    Adiciona um número especificado de semanas ao objeto GlideDateTime atual. Um parâmetro negativo subtrai semanas. O método determina a data e hora UTC equivalentes ao valor armazenado pelo objeto GlideDateTime e adiciona ou subtrai semanas usando os valores de data e hora UTC.

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    Semanas Número O número de semanas a serem adicionadas. Use um valor negativo para subtrair.
    Tabela 21. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.info(gdt.getDate());

    Saída:

    2011-08-24

    GlideDateTime com escopo - addYearsLocalTime(Número de anos)

    Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos. O método determina a data e hora locais equivalentes ao valor armazenado pelo objeto GlideDateTime e, em seguida, adiciona ou subtrai anos usando os valores de data e hora locais.

    Tabela 22. Parâmetros
    Nome Tipo Descrição
    anos Número O número de anos a serem adicionados. Use um valor negativo para subtrair.
    Tabela 23. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.info(gdt.getDate());

    Saída:

    2011-08-31

    GlideDateTime com escopo - addYearsUTC(Número de anos)

    Adiciona um número especificado de anos ao objeto GlideDateTime atual. Um parâmetro negativo subtrai anos. O valor de data e hora armazenado pelo objeto GlideDateTime é interpretado como se estivesse no fuso horário UTC.

    Tabela 24. Parâmetros
    Nome Tipo Descrição
    anos Número O número de anos a serem adicionados. Use um valor negativo para subtrair.
    Tabela 25. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.info(gdt.getDate());

    Saída:

    2011-08-31

    GlideDateTime com escopo - depois (GlideDateTime gdt)

    Determina se a data e a hora do objeto GlideDateTime ocorrem após a data e a hora do objeto especificado.

    Tabela 26. Parâmetros
    Nome Tipo Descrição
    gdt GlideDateTime Data e hora de verificação.
    Tabela 27. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a data e a hora do objeto GlideDateTime são posteriores à data e hora especificadas pelo parâmetro.
    Valores possíveis:
    • verdadeiro: a data e a hora do objeto GlideDateTime são posteriores à data e hora do objeto especificado.
    • falso: data e hora do objeto GlideDateTime são anteriores ou iguais à data e hora do objeto especificado.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.after(gdt2));

    Saída:

    False

    GlideDateTime com escopo - before(GlideDateTime gdt)

    Determina se a data e a hora do objeto GlideDateTime ocorrem antes da data e hora do objeto GlideDateTime especificado.

    Tabela 28. Parâmetros
    Nome Tipo Descrição
    gdt GlideDateTime Data e hora de verificação.
    Tabela 29. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a data e a hora do objeto GlideDateTime são anteriores à data e hora especificadas pelo parâmetro.
    Valores possíveis:
    • verdadeiro: data e hora do objeto GlideDateTime são anteriores à data e hora especificadas.
    • falso: data e hora do objeto GlideDateTime são posteriores ou iguais às data e hora especificadas.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.before(gdt2));

    Saída

    true

    GlideDateTime com escopo – compareTo(Object o)

    Compara dois objetos de data e hora para determinar se são equivalentes ou se um ocorre antes ou depois do outro.

    Tabela 30. Parâmetros
    Nome Tipo Descrição
    o Objeto Objeto de data e hora no formato GlideDateTime
    Tabela 31. Retornos
    Tipo Descrição
    Número
    • 0 = As datas são iguais
    • 1 = A data do objeto é posterior à data especificada no parâmetro
    • -1 = A data do objeto é anterior à data especificada no parâmetro
    		 
    var initDate = new GlideDateTime("2011-08-01 12:00:00");
var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
 
gs.info(initDate.compareTo(compDate1)); // Equals (0)
gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)

    Saída:

    0
1
-1

    GlideDateTime com escopo - é igual a (Data/hora do objeto)

    Compara uma data/hora com um valor existente de igualdade.

    Tabela 32. Parâmetros
    Nome Tipo Descrição
    data/hora Objeto GlideDateTime ou cadeia de caracteres A data/hora a ser comparada.
    Tabela 33. Retornos
    Tipo Descrição
    Booliano Retorna verdadeiro se forem iguais; caso contrário, falso. 
    var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.info(gdt.equals("2011-09-30 00:12:01"));

    Saída:

    false

    GlideDateTime com escopo – getDate()

    Retorna a data armazenada pelo objeto GlideDateTime. Expresso no formato padrão, aaaa-MM-dd, e no fuso horário do sistema, GMT por padrão.

    Tabela 34. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 35. Retorna
    Tipo Descrição
    Objeto Data no fuso horário do sistema. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDate());

    Saída:

    2011-08-31

    GlideDateTime com escopo – getDayOfMonthLocalTime()

    Obtém o dia do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.

    Tabela 36. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 37. Retorna
    Tipo Descrição
    Número O dia do mês no fuso horário do usuário, de 1 a 31. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthLocalTime());

    Saída:

    2

    GlideDateTime com escopo – getDayOfMonthUTC()

    Obtém o dia do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

    Tabela 38. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 39. Retorna
    Tipo Descrição
    Número O dia do mês no fuso horário UTC, de 1 a 31. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthUTC());

    Saída:

    02

    GlideDateTime com escopo – getDayOfWeekLocalTime()

    Obtém o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário.

    Tabela 40. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 41. Retorna
    Tipo Descrição
    Número O valor do dia da semana, no fuso horário do usuário, de 1 a 7. Segunda-feira é igual a 1, domingo é igual a 7. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());

    Saída:

    4

    GlideDateTime com escopo – getDayOfWeekUTC()

    Retorna o dia da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

    Tabela 42. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 43. Retorna
    Tipo Descrição
    Número Valor do dia da semana de 1 a 7. Segunda-feira é igual a 1, domingo é igual a 7. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00"); //Thursday
gs.info(gdt.getDayOfWeekUTC());

    Saída:

    4

    GlideDateTime com escopo – getDaysInMonthLocalTime()

    Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.

    Tabela 44. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 45. Retorna
    Tipo Descrição
    Número O número de dias no mês atual no fuso horário do usuário. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
gs.info(gdt.getDaysInMonthLocalTime());

    Saída:

    30

    GlideDateTime com escopo – getDaysInMonthUTC()

    Obtém o número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

    Tabela 46. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 47. Retorna
    Tipo Descrição
    Número O número de dias do mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getDaysInMonthUTC());

    Saída:

    30

    GlideDateTime com escopo – getDisplayValue()

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

    Tabela 48. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 49. Retorna
    Tipo Descrição
    Cadeia de caracteres Data e hora no formato e fuso horário do usuário. Lembre-se de que, ao projetar regras de negócio ou inclusões de script, esse método pode retornar valores em formatos diferentes para usuários diferentes. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)

    Saída:

    2011-08-31 01:00:00

    GlideDateTime com escopo – getDisplayValueInternal()

    Obtém o valor de exibição no formato interno (aaaa-MM-dd HH:mm:ss).

    Tabela 50. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 51. Retorna
    Tipo Descrição
    Cadeia de caracteres Os valores de data e hora do objeto GlideDateTime no fuso horário do usuário atual e o formato interno de data e hora de aaaa-MM-dd HH:mm:ss. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00"); 
gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)

    Saída:

    2011-08-31 01:00:00

    GlideDateTime com escopo - getDisplayValueLang (estilo de cadeia de caracteres, idioma de cadeia de caracteres)

    Retorna um valor de data e hora na localidade dos usuários atuais de acordo com um idioma e estilo de data especificados.

    Tabela 52. Parâmetros
    Nome Tipo Descrição
    estilo Cadeia de caracteres Especifica o formato de data e hora.
    Valores válidos:
    • full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022).
    • long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022).
    • médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022).
    • short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022).

    Se qualquer outro valor for aprovado, a API usará como padrão o valor médio. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas.
    idioma Cadeia de caracteres Retorna a data de acordo com um valor de idioma especificado. Aceita marcadores de idioma em conformidade com o padrão BCP-47. Por exemplo, fr para francês ou en-UK para inglês do Reino Unido. Para obter uma lista completa de valores aceitos, consulte BCP 47 Lista de códigos de idioma.
    Tabela 53. Retornos
    Tipo Descrição
    Cadeia de caracteres Uma representação de cadeia de caracteres da data no estilo especificado e no formato apropriado para a localidade do usuário atual.

    O exemplo a seguir retorna a data e a hora da localidade do usuário em todos os estilos de idioma e data.

    var gdt = new GlideDateTime(); // This will fetch the current date


gs.info('date: ' + gdt.getDisplayValue());

gs.info('date: ' + gdt.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gdt.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gdt.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gdt.getDisplayValueLang("short", "es-MX"));```

    Saída:

    date: 2023-01-18 06:49:02
mercredi 18 janvier 2023 06:49:02
18 January 2023 06:49:02
18.01.2023 06:49:02
18/01/23 06:49:02

    GlideDateTime com escopo – getDSTOffset()

    Obtém a quantidade de tempo em que o horário de verão está deslocado.

    Tabela 54. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 55. Retorna
    Tipo Descrição
    Número Quantidade de tempo, em milissegundos, em que o horário de verão está compensado. Retorna 0 se não houver deslocamento ou se a hora não estiver durante o horário de verão. 
    var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

    Saída:

    3600000

    GlideDateTime com escopo – getErrorMsg()

    Obtém a mensagem de erro atual.

    Tabela 56. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 57. Retorna
    Tipo Descrição
    Objeto A mensagem de erro. 
    var gdt = new GlideDateTime(); 
gdt.setDisplayValue("2011-aa-01 00:00:00"); 
gs.info(gdt.getErrorMsg());

    Saída:

    Could not parse DateTime: 2011-aa-01 00:00:00

    GlideDateTime com escopo – getInternalFormattedLocalTime()

    Retorna a hora do objeto no fuso horário local e no formato interno.

    Tabela 58. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 59. Retorna
    Tipo Descrição
    Cadeia de caracteres A hora do objeto no fuso horário local e no formato interno.

    Este exemplo exibe a hora no formato de hora do sistema do fuso horário do usuário.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getInternalFormattedLocalTime());

    Saída

    2022-10-07 06:00:00 PM
18:00:00

    GlideDateTime com escopo – getLocalDate()

    Obtém a data armazenada pelo objeto GlideDateTime, expressa no formato padrão, aaaa-MM-dd, e o fuso horário do usuário atual.

    Tabela 60. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 61. Retorna
    Tipo
    GlideDate A data no fuso horário do usuário. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getLocalDate());

    Saída:

    2011-08-31

    GlideDateTime com escopo – getLocalTime()

    Retorna um objeto GlideTime que representa a parte de tempo do objeto GlideDateTime no fuso horário do usuário.

    Tabela 62. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 63. Retorna
    Tipo Descrição
    GlideTime A hora no fuso horário do usuário. 
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getLocalTime();
gs.info("local time is " + gt.getByFormat('hh:mm:ss'));

    Saída:

    local time is 01:00:00

    GlideDateTime com escopo – getMonthLocalTime()

    Obtém o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.

    Tabela 64. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 65. Retorna
    Tipo Descrição
    Número O valor numérico do mês. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthLocalTime());

    Saída:

    11

    GlideDateTime com escopo – getMonthUTC()

    Obtém o mês armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

    Tabela 66. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 67. Retorna
    Tipo Descrição
    Número O valor numérico do mês. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthUTC());

    Saída:

    11

    GlideDateTime com escopo – getNumericValue()

    Obtém o número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT.

    Tabela 68. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 69. Retorna
    Tipo Descrição
    Número O número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());

    Saída:

    1314777600000

    GlideDateTime com escopo – getTime()

    Retorna um objeto GlideTime que representa a parte de tempo do objeto GlideDateTime.

    Tabela 70. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 71. Retorna
    Tipo Descrição
    GlideTime O carimbo de duração do Unix no formato do sistema com base na hora GMT. 
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getTime();
gs.info(gt.getByFormat('hh:mm:ss'));

    Saída:

    08:00:00

    GlideDateTime com escopo – getTZOffset()

    Obtém a diferença de fuso horário em milissegundos.

    Tabela 72. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 73. Retorna
    Tipo Descrição
    Número O número de milissegundos de deslocamento de fuso horário. 
    var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.info(gdt.getTZOffset());

    Saída:

    -25200000

    GlideDateTime com escopo – getUserFormattedLocalTime()

    Retorna a hora do objeto no fuso horário local e no formato do usuário.

    Tabela 74. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 75. Retorna
    Tipo Descrição
    Cadeia de caracteres A hora do objeto no fuso horário local e no formato do usuário.

    Este exemplo mostra a hora do objeto no fuso horário local.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getUserFormattedLocalTime());

    Saída:

    2022-10-07 06:00:00 PM
06:00:00 PM

    GlideDateTime com escopo – getValue()

    Retorna o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss, no fuso horário UTC.

    Tabela 76. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 77. Retorna
    Tipo Descrição
    Cadeia de caracteres Data e hora no formato interno e fuso horário do sistema.

    Formato: aaaa-MM-dd HH:mm:ss no fuso horário UTC.

    		 
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
gs.info(gdt.getValue());

    Saída:

    2014-08-31 08:00:00

    GlideDateTime com escopo – getWeekOfYearLocalTime()

    Obtém o número da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.

    Todas as semanas começam no domingo. A primeira semana do ano é a semana que contém pelo menos um dia do novo ano. A semana que começa no domingo de 27/12/2015 é considerada a primeira semana de 2016, já que essa semana contém 1 e 2 de janeiro.

    Tabela 78. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 79. Retorna
    Tipo Descrição
    Número O número da semana atual. O maior número de semanas em um ano é 52 ou 53. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
gs.info(gdt.getWeekOfYearLocalTime());

    Saída:

    49

    GlideDateTime com escopo – getWeekOfYearUTC()

    Obtém o número da semana armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

    Todas as semanas começam no domingo. A primeira semana do ano é a semana que contém pelo menos um dia do novo ano. A semana que começa no domingo de 27/12/2015 é considerada a primeira semana de 2016, já que essa semana contém 1 e 2 de janeiro.

    Tabela 80. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 81. Retorna
    Tipo Descrição
    Número O número da semana atual no horário UTC. O maior número de semanas em um ano é 52 ou 53. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
gs.info(gdt.getWeekOfYearUTC());

    Saída:

    49

    GlideDateTime com escopo – getYearLocalTime()

    Obtém o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário do usuário atual.

    Tabela 82. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 83. Retornos
    Tipo Descrição
    Número Valor de ano de quatro dígitos no fuso horário do usuário. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearLocalTime());

    Saída:

    2011

    GlideDateTime com escopo – getYearUTC()

    Obtém o ano armazenado pelo objeto GlideDateTime, expresso no fuso horário UTC.

    Tabela 84. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 85. Retorna
    Tipo Descrição
    Número Valor de ano de 4 dígitos no fuso horário UTC. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
gs.info(gdt.getYearUTC());

    Saída:

    2011

    GlideDateTime com escopo - hasDate()

    Determina se a data de um objeto está definida.

    Tabela 86. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 87. Retorna
    Tipo Descrição
    Booliano Verdadeiro se a data do objeto estiver definida; caso contrário, retorna falso. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.hasDate());

    Saída:

    true

    GlideDateTime com escopo - isDST()

    Determina se a hora de um objeto usa um deslocamento de horário de verão.

    Tabela 88. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 89. Retorna
    Tipo Descrição
    Booliano Verdadeiro se o horário for horário de verão; caso contrário, retorna falso. 
    var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true

    Saída:

    var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true

    GlideDateTime com escopo - isValid()

    Determina se um valor é uma data e hora válidas.

    Tabela 90. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 91. Retorna
    Tipo Descrição
    Booliano Verdadeiro se o valor for válido; caso contrário, retorna falso. 
    var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
gs.info(gdt.isValid()); //true
gs.info(gdt.getErrorMsg()); //reason

    Saída:

    false
Invalid date time: '2011-aa-31 aa:00:00', ignored

    GlideDateTime com escopo - onOrAfter(GlideDateTime gdt)

    Determina se a data e a hora do objeto GlideDateTime ocorrem em ou após a data e hora do objeto GlideDateTime especificado.

    Tabela 92. Parâmetros
    Nome Tipo Descrição
    gdt GlideDateTime Data e hora de verificação.
    Tabela 93. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a data e a hora do objeto GlideDateTime são em ou após a data e a hora especificadas pelo parâmetro.
    Valores possíveis:
    • verdadeiro: a data e hora do objeto GlideDateTime são em ou após a data e hora do objeto especificado.
    • falso: data e hora do objeto GlideDateTime são anteriores à data e hora do objeto especificado.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrAfter(gdt2));

    Saída

    false

    GlideDateTime com escopo - onOrBefore(GlideDateTime gdt)

    Determina se a data e a hora do objeto GlideDateTime ocorrem em ou antes da data e hora do objeto GlideDateTime especificado.

    Tabela 94. Parâmetros
    Nome Tipo Descrição
    gdt GlideDateTime Data e hora de verificação.
    Tabela 95. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a data e a hora do objeto GlideDateTime estão em ou antes da data e hora especificadas pelo parâmetro.
    Valores possíveis:
    • verdadeiro: data e hora do objeto GlideDateTime é igual ou anterior à data e hora do objeto especificado.
    • falso: a data e a hora do objeto GlideDateTime são posteriores à data e hora do objeto especificado.
    		 
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrBefore(gdt2));

    Saída

    true

    GlideDateTime com escopo – setDayOfMonthLocalTime(Number day)

    Define o dia do mês com um valor especificado no fuso horário do usuário atual.

    Tabela 96. Parâmetros
    Nome Tipo Descrição
    dia Número O dia do mês para o qual mudar, de 1 a 31. Se este valor for maior que o número máximo de dias no mês, o valor será definido como o último dia do mês.
    Tabela 97. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.info(gdt.getDayOfMonthLocalTime());

    Saída:

    9

    GlideDateTime com escopo – setDayOfMonthUTC(Número de dias)

    Define o dia do mês com um valor especificado no fuso horário UTC.

    Tabela 98. Parâmetros
    Nome Tipo Descrição
    dia Número O dia do mês para o qual mudar, de 1 a 31. Se este valor for maior que o número máximo de dias no mês, o valor será definido como o último dia do mês.
    Tabela 99. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.info(gdt.getDayOfMonthUTC());

    Saída:

    9

    GlideDateTime com escopo - setDisplayValue(String asDisplayed)

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

    Tabela 100. Parâmetros
    Nome Tipo Descrição
    comoExibido Cadeia de caracteres A data e 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 MM-dd-yyyy HH:mm:ss. Para atribuir a data e hora atuais a uma variável em um script de fluxo de trabalho, use a variável .setDisplayValue(gs.nowDateTime);.
    Tabela 101. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific) 
gs.info(gdt.getValue());

    Saída:

    2014-01-01 20:00:00

    GlideDateTime com escopo - setDisplayValue (valor de cadeia de caracteres, formato de cadeia de caracteres)

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

    Este método lançará uma exceção de tempo de execução se o formato de data e hora usado no parâmetro value não corresponder ao parâmetro format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for detectada.

    Tabela 102. Parâmetros
    Nome Tipo Descrição
    valor Cadeia de caracteres Data e hora no fuso horário do usuário atual.
    formato Cadeia de caracteres Formato de data e hora a ser usado para analisar o parâmetro value.
    Use os seguintes valores para descrever o parâmetro value :
    • dd: dia do mês
    • MM: mês do ano
    • aaaa: ano
    • HH: hora
    • mm: minutos
    • ss: segundos

    Por exemplo: "dd-MM-yyyy HH:mm:ss" ou "MM-dd-yyyy HH:mm".
    Tabela 103. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
gs.info(gdt.getValue());

    Saída

    "20-05-2011 12:00:00"

    GlideDateTime com escopo – setDisplayValueInternal(String value)

    Define um valor de data e hora usando o formato interno (aaaa-MM-dd HH:mm:ss) e o fuso horário do usuário atual.

    Tabela 104. Parâmetros
    Nome Tipo Descrição
    valor Cadeia de caracteres A data e a hora no formato interno.
    Tabela 105. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
gs.info(gdt.getValue());

    Saída:

    2014-01-01 20:00:00

    GlideDateTime com escopo - setDisplayValueLang(cadeia de caracteres dateTime, estilo de cadeia de caracteres)

    Define uma data e hora usando um estilo e formato especificados de acordo com a localidade do usuário atual.

    Tabela 106. Parâmetros
    Nome Tipo Descrição
    data/hora Cadeia de caracteres Valor de data e hora do objeto GlideDate no fuso horário do usuário atual. Valores válidos são qualquer saída de data e hora da função getDisplayValueLang().

    Por exemplo, usando a saída do exemplo getDisplayValueLang (Estilo de cadeia de caracteres, Linguagem de cadeia de caracteres) anteriormente neste tópico, 28 de novembro de 2022 07:03:41 ou 28.11.2022 07:03:41 são valores aceitos.
    estilo Cadeia de caracteres Especifica o formato de data.
    Valores válidos:
    • full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022).
    • long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022).
    • médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022).
    • short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022).

    Se qualquer outro valor for aprovado, a API usará como padrão o valor médio. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas.
    Tabela 107. Retornos
    Tipo Descrição
    Vazio

    O exemplo a seguir retorna a data e a hora nos estilos curto e completo.

    var glideDateFR = new GlideDateTime();
glideDateFR.setDisplayValueLang("2/3/2023 17:27:56", "short");

gs.info('date: ' + glideDateFR.getDisplayValue());
gs.info('date: ' + glideDateFR.getDisplayValueLang("full"));

    Saída:

    date: 2023-02-03 17:27:56
date: Friday, February 3, 2023 17:27:56

    GlideDateTime com escopo - setDisplayValueLang(cadeia de caracteres dateTime, estilo de cadeia de caracteres, idioma de cadeia de caracteres)

    Define uma data e hora usando um estilo, idioma e formato especificados de acordo com a localidade do usuário atual.

    Tabela 108. Parâmetros
    Nome Tipo Descrição
    data/hora Cadeia de caracteres Valor de data e hora do objeto GlideDate no fuso horário do usuário atual. Valores válidos são qualquer saída de data e hora da função getDisplayValueLang().

    Por exemplo, usando a saída do exemplo getDisplayValueLang (Estilo de cadeia de caracteres, Linguagem de cadeia de caracteres) anteriormente neste tópico, 28 de novembro de 2022 07:03:41 ou 28.11.2022 07:03:41 são valores aceitos.
    estilo Cadeia de caracteres Especifica o formato de data.
    Valores válidos:
    • full: retorna a data no formato de<weekday, month, day, and year> de acordo com a localidade do usuário (por exemplo, segunda-feira, 24 de outubro de 2022).
    • long: retorna a data no formato de<month, day, and year> de acordo com a localidade do usuário (por exemplo, 24 de outubro de 2022).
    • médio: semelhante a longo, mas retorna a data com um mês abreviado (por exemplo, 24 de outubro de 2022).
    • short: retorna a data no formato MM/DD/AA ou DD/MM/AA de acordo com a localidade do usuário (por exemplo, 24/10/2022 ou 24/10/2022).

    Se qualquer outro valor for aprovado, a API usará como padrão o valor médio. Os valores aceitos não fazem distinção entre maiúsculas e minúsculas.
    idioma Cadeia de caracteres Define o idioma usando um marcador de idioma em conformidade com o padrão BCP-47. Por exemplo, fr para francês ou en-UK para inglês do Reino Unido. Para obter uma lista completa de valores aceitos, consulte BCP 47 Lista de códigos de idioma.
    Tabela 109. Retornos
    Tipo Descrição
    Vazio

    O exemplo a seguir retorna a data e a hora nos estilos curto e completo para inglês e francês.

    var glideDateFR = new GlideDateTime(); 

glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "short", "fr-FR" );

gs.info('en-US date: ' + glideDateUS.getDisplayValue());
gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));

gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));

    Saída:

    en-US date: 2023-02-03 18:00:00
en-US date: Friday, February 3, 2023 18:00:00
fr-FR date: 2023-03-02 18:00:00
fr-FR date: Thursday, March 2, 2023 18:00:00

    GlideDateTime com escopo - setGlideDateTime(GlideDateTime g)

    Define a data e a hora do objeto atual usando um objeto GlideDateTime existente. Este método é equivalente a instanciar um novo objeto com um parâmetro GlideDateTime.

    Tabela 110. Parâmetros
    Nome Tipo Descrição
    g GlideDateTime O objeto a ser usado para definir o valor de data/hora.
    Tabela 111. Retornos
    Tipo Descrição
    Nenhum(a) 
    var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.info(dt1.getValue());

    Saída:

    2011-02-02 08:00:00

    GlideDateTime com escopo – setMonthLocalTime(Number month)

    Define o mês armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário do usuário atual.

    Tabela 112. Parâmetros
    Nome Tipo Descrição
    mês Número O mês para o qual mudar.
    Tabela 113. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.info(gdt.getMonthLocalTime());

    Saída:

    1

    GlideDateTime com escopo – setMonthUTC(Número de meses)

    Define o mês armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário UTC.

    Tabela 114. Parâmetros
    Nome Tipo Descrição
    mês Número O mês para o qual mudar.
    Tabela 115. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.info(gdt.getMonthUTC());

    Saída:

    1

    GlideDateTime com escopo - setValue(String o)

    Define a data e a hora do objeto GlideDateTime.

    Tabela 116. Parâmetros
    Nome Tipo Descrição
    o Cadeia de caracteres A data e a hora a serem usadas. Este parâmetro pode ser de vários tipos:
    • Uma cadeia de caracteres no fuso horário UTC e no formato interno de aaaa-MM-dd HH:mm:ss. Define o valor do objeto para a data e hora especificadas. Usar o método dessa forma é equivalente a instanciar um novo objeto GlideDateTime usando o construtor GlideDateTime(String value). Se o formato de data e hora usado não corresponder ao formato interno, o método tentará definir a data e a hora usando outros formatos disponíveis. Resolver a data e a hora dessa forma pode gerar dados imprecisos devido à ambiguidade nos valores de dia e mês. Ao usar um formato de data e hora não padrão, use setValueUTC(String dt, String format).
    • Um objeto GlideDateTime. Define o valor do objeto como a data e a hora armazenadas pelo GlideDateTime passado no parâmetro. Usar o método dessa forma é equivalente a instanciar um novo objeto GlideDateTime usando o construtor GlideDateTime (GlideDateTime g).
    • Um número JavaScript. Define o valor do objeto usando o valor de Número como milissegundos após 1º de janeiro de 1970 00:00:00 UTC.
    Tabela 117. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00");  // value set =  2011-02-02 08:00:00
gs.info(gdt.getValue());

    Saída:

    2011-02-02 08:00:00

    GlideDateTime com escopo - setValueUTC(cadeia de caracteres dt, formato de cadeia de caracteres)

    Define um valor de data e hora usando o fuso horário UTC e o formato de data e hora especificado. Este método lançará uma exceção de tempo de execução se o formato de data e hora usado no parâmetro dt não corresponder ao parâmetro format. Você pode recuperar a mensagem de erro chamando getErrorMsg() no objeto GlideDateTime depois que a exceção for detectada.

    Tabela 118. Parâmetros
    Nome Tipo Descrição
    dt Cadeia de caracteres A data e a hora a serem usadas.
    formato Cadeia de caracteres O formato de data e hora a ser usado.
    Tabela 119. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
gs.info(gdt.getValue());

    Saída:

    2011-02-15 08:00:00

    GlideDateTime com escopo - setYearLocalTime(Número de anos)

    Define o ano armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário do usuário atual.

    Tabela 120. Parâmetros
    Nome Tipo Descrição
    ano Número O ano para o qual mudar.
    Tabela 121. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.info(gdt.getYearLocalTime());

    Saída:

    2013

    GlideDateTime com escopo - setYearUTC(Número de ano)

    Define o ano armazenado pelo objeto GlideDateTime com o valor especificado usando o fuso horário UTC.

    Tabela 122. Parâmetros
    Nome Tipo Descrição
    ano Número O ano para o qual mudar.
    Tabela 123. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.info(gdt.getYearUTC());

    Saída:

    2013

    GlideDateTime com escopo - subtract(GlideTime time)

    Subtrai uma quantidade especificada de tempo do objeto GlideDateTime atual.

    Tabela 124. Parâmetros
    Nome Tipo Descrição
    hora GlideTime O valor de tempo a ser subtraído.
    Tabela 125. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));

    Saída:

    07:59:40

    GlideDateTime com escopo - subtract(Número milissegundos)

    Subtrai o número especificado de milissegundos do objeto GlideDateTime.

    Tabela 126. Parâmetros
    Nome Tipo Descrição
    milissegundos Número Número de milissegundos a serem subtraídos.
    Tabela 127. Retornos
    Tipo Descrição
    Nenhum(a) 
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.info(gdt.getValue());

    Saída:

    2011-12-07 07:59:59

    GlideDateTime com escopo - subtract (início de GlideDateTime, fim de GlideDateTime)

    Retorna a diferença de duração entre dois objetos GlideDateTime especificados.

    Tabela 128. Parâmetros
    Nome Tipo Descrição
    Iniciar GlideDateTime Objeto de data de início.
    Término GlideDateTime Objeto de data de término.
    Tabela 129. Retornos
    Tipo Descrição
    GlideDuration Diferença de duração entre as duas datas especificadas. 
    var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
 
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());

    Saída:

    2 Days 23 Hours

    GlideDateTime com escopo - toString()

    Obtém o valor de data e hora armazenado pelo objeto GlideDateTime no formato interno, aaaa-MM-dd HH:mm:ss, e o fuso horário do sistema, UTC por padrão. Este método é equivalente a getValue().

    Tabela 130. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 131. Retorna
    Tipo
    Cadeia de caracteres A data e a hora armazenadas pelo objeto GlideDateTime no fuso horário e no formato do sistema. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.toString());

    Saída:

    2011-08-31 08:00:00