--- 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 --- # GlideSystem - Global # GlideSystem - Global {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 56 min. de leitura A API GlideSystem, que é conhecida pelo nome de variável `gs` em qualquer JavaScript do lado do servidor, fornece vários métodos convenientes para obter informações sobre o sistema, o usuário conectado no momento e informações de data/hora. Muitos dos métodos GlideSystem facilitam a inclusão de datas em intervalos de consulta e são usados com mais frequência em filtros e relatórios. ## GlideSystem - addErrorMessage (mensagem do objeto) {#ariaid-title2} Adiciona uma mensagem de erro para a sessão atual. Use getErrorMessages() para recuperar uma lista de mensagens de erro que estão sendo mostradas no momento. {#r_GS-addErrorMessage_O__table_ug1_qy1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | mensagem | Objeto | A mensagem a ser adicionada. | [Tabela 1. Parâmetros] {#r_GS-addErrorMessage_O__table_ug1_qy1_mt} {#r_GS-addErrorMessage_O__table_vg1_qy1_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 2. Retorna] {#r_GS-addErrorMessage_O__table_vg1_qy1_mt} gs.include("PrototypeServer"); var ValidatePasswordStronger = Class.create(); ValidatePasswordStronger.prototype = { process : function() { var user_password = request.getParameter("user_password"); var min_len = 8; var rules = "Password must be at least " + min_len + " characters long and contain a digit, an uppercase letter, and a lowercase letter."; if (user_password.length() < min_len) { gs.addErrorMessage("TOO SHORT: " + rules); return false; } var digit_pattern = new RegExp("[0-9]", "g"); if (!digit_pattern.test(user_password)) { gs.addErrorMessage("DIGIT MISSING: " + rules); return false; } var upper_pattern = new RegExp("[A-Z]", "g"); if (!upper_pattern.test(user_password)) { gs.addErrorMessage("UPPERCASE MISSING: " + rules); return false; } var lower_pattern = new RegExp("[a-z]", "g"); if (!lower_pattern.test(user_password)) { gs.addErrorMessage("LOWERCASE MISSING: " + rules); return false; } return true; // password is OK } } [edit] ### Equivalente com escopo {#r_GS-addErrorMessage_O__section_vhb_mhs_mcb} Para usar o método addErrorMessage() em uma aplicação com escopo, use o método com escopo correspondente: [addErrorMessage()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemAddErrorMessage_Object "Adiciona uma mensagem de erro para a sessão atual."). ## GlideSystem - addInfoMessage(Mensagem do objeto) {#ariaid-title3} Adiciona uma mensagem informativa para a sessão atual. Use getInfoMessages() para recuperar a lista de mensagens informativas que estão sendo mostradas. Este método não é compatível com regras de negócio assíncronas e não pode ser usado em scripts de transformação. {#r_GS-addInfoMessage_O__table_it3_2z1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | mensagem | Objeto | A mensagem a ser adicionada. | [Tabela 3. Parâmetros] {#r_GS-addInfoMessage_O__table_it3_2z1_mt} {#r_GS-addInfoMessage_O__table_jt3_2z1_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 4. Retorna] {#r_GS-addInfoMessage_O__table_jt3_2z1_mt} if ((!current.u_date1.nil()) && (!current.u_date2.nil())) { var start = current.u_date1.getGlideObject().getNumericValue(); var end = current.u_date2.getGlideObject().getNumericValue(); if (start > end) { gs.addInfoMessage('start must be before end'); current.u_date1.setError('start must be before end'); current.setAbortAction(true); } } ### Equivalente com escopo {#r_GS-addInfoMessage_O__section_ncj_4hs_mcb} Para usar o método addInfoMessage() em uma aplicação com escopo, use o método com escopo correspondente: [addInfoMessage()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemAddInfoMessage_Object "Adiciona uma mensagem informativa para a sessão atual. Este método não é compatível com regras de negócio assíncronas."). ## GlideSystem - addMessage (tipo de cadeia de caracteres, mensagem de objeto) {#ariaid-title4} Adiciona uma mensagem para a sessão atual. {#r_GS-addMessage_S_O__table_bgw_qz1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | tipo | Cadeia de caracteres | Tipo de mensagem, como erro ou informações. | | mensagem | Objeto | Mensagem a ser adicionada à sessão atual. | [Tabela 5. Parâmetros] {#r_GS-addMessage_S_O__table_bgw_qz1_mt} {#r_GS-addMessage_S_O__table_cgw_qz1_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 6. Retorna] {#r_GS-addMessage_S_O__table_cgw_qz1_mt} ## GlideSystem -- startsOfLastMonth() {#ariaid-title5} Obtém a data e a hora do início do último mês em GMT. {#r_GS-beginningOfLastMonth__table_jkt_b5v_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 7. Parâmetros] {#r_GS-beginningOfLastMonth__table_jkt_b5v_mt} {#r_GS-beginningOfLastMonth__table_kkt_b5v_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O início GMT do último mês, no formato aaaa-mm-dd hh:mm:ss. | [Tabela 8. Retorna] {#r_GS-beginningOfLastMonth__table_kkt_b5v_mt} Este exemplo define a data e a hora do objeto GlideDateTime como o início do último mês. var date = new GlideDate(); date.setValue(gs.beginningOfLastMonth()); var dateasint = date.toString().replace('-',''); gs.print(dateasint); ### Equivalente com escopo Para usar o método startsOfLastMonth () em uma aplicação com escopo, use o método com escopo correspondente: [startsOfLastMonth()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfLastMonth "Retorna a data e a hora do início do último mês em GMT."). ## GlideSystem -- startsOfLastWeek() {#ariaid-title6} Retorna a data e a hora do início da última semana em GMT. {#r_GS-beginningOfLastWeek__table_ngp_m5v_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 9. Parâmetros] {#r_GS-beginningOfLastWeek__table_ngp_m5v_mt} {#r_GS-beginningOfLastWeek__table_ogp_m5v_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no início da semana passada. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 10. Retorna] {#r_GS-beginningOfLastWeek__table_ogp_m5v_mt} Este exemplo define o valor do registro de data/hora atual do Glide como o início da última semana. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfLastWeek()); ### Equivalente com escopo Para usar o método startsOfLastWeek () em uma aplicação com escopo, use o método com escopo correspondente: [startsOfLastWeek()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfLastWeek "Retorna a data e a hora do início da última semana em GMT."). ## GlideSystem -- startsOfNextWeek() {#ariaid-title7} Retorna a data e a hora do início da próxima semana em GMT. {#r_GS-beginningOfNextWeek__table_h2f_v5v_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 11. Parâmetros] {#r_GS-beginningOfNextWeek__table_h2f_v5v_mt} {#r_GS-beginningOfNextWeek__table_i2f_v5v_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no início da próxima semana. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 12. Retorna] {#r_GS-beginningOfNextWeek__table_i2f_v5v_mt} Este exemplo define o valor do registro de data/hora atual do Glide para o início da próxima semana. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfNextWeek()); ### Equivalente com escopo Para usar o método startsOfNextWeek () em uma aplicação com escopo, use o método com escopo correspondente: [startsOfNextWeek()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemBeginNxtWk "Retorna a data e a hora do início da próxima semana em GMT."). ## GlideSystem -- startsOfNextMonth() {#ariaid-title8} Retorna a data e a hora do início do próximo mês em GMT. {#r_GS-beginningOfNextMonth__table_pp1_dvv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 13. Parâmetros] {#r_GS-beginningOfNextMonth__table_pp1_dvv_mt} {#r_GS-beginningOfNextMonth__table_qp1_dvv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no início do próximo mês. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 14. Retorna] {#r_GS-beginningOfNextMonth__table_qp1_dvv_mt} Este exemplo define o valor do registro de data/hora atual do Glide para o início do próximo mês. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfNextMonth()); ### Equivalente com escopo Para usar o método startsOfNextMonth () em uma aplicação com escopo, use o método com escopo correspondente: [startsOfNextMonth()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfNextMonth "Retorna a data e a hora do início do próximo mês em GMT."). ## GlideSystem -- startsOfNextYear() {#ariaid-title9} Retorna a data e a hora do início do próximo ano em GMT. {#r_GS-beginningOfNextYear__table_phk_lvv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 15. Parâmetros] {#r_GS-beginningOfNextYear__table_phk_lvv_mt} {#r_GS-beginningOfNextYear__table_qhk_lvv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O GMT a partir do próximo ano, no formato aaaa-mm-dd hh:mm:ss. | [Tabela 16. Retorna] {#r_GS-beginningOfNextYear__table_qhk_lvv_mt} Este exemplo define o valor do registro de data/hora atual do Glide para o início do próximo ano. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfNextYear()); ### Equivalente com escopo Para usar o método startsOfNextYear () em uma aplicação com escopo, use o método com escopo correspondente: [startsOfNextYear()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfNextYear "Retorna a data e a hora do início do próximo ano em GMT."). ## GlideSystem -- startsOf ThisMonth() {#ariaid-title10} Retorna a data e a hora do início do mês atual em GMT. {#r_GS-beginningOfThisMonth__table_mkk_tvv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 17. Parâmetros] {#r_GS-beginningOfThisMonth__table_mkk_tvv_mt} {#r_GS-beginningOfThisMonth__table_nkk_tvv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT do mês atual. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 18. Retorna] {#r_GS-beginningOfThisMonth__table_nkk_tvv_mt} Este exemplo define o valor do registro de data/hora atual do Glide para o início deste mês. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfThisMonth()); ### Equivalente com escopo Para usar o método startsOf ThisMonth () em uma aplicação com escopo, use o método com escopo correspondente: startsOf ThisMonth [()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfThisMonth "Retorna a data e a hora do início deste mês em GMT."). ## GlideSystem -- startsOf ThisQuarter() {#ariaid-title11} Retorna a data e a hora do início do trimestre atual em GMT. {#r_GS-beginningOfThisQuarter__table_ts5_1wv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 19. Parâmetros] {#r_GS-beginningOfThisQuarter__table_ts5_1wv_mt} {#r_GS-beginningOfThisQuarter__table_us5_1wv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT do trimestre atual. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 20. Retorna] {#r_GS-beginningOfThisQuarter__table_us5_1wv_mt} Este exemplo define o valor do registro de data/hora atual do Glide como o início do trimestre atual. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfThisQuarter()); ### Equivalente com escopo Para usar o método "inícioOfEsteQuarter" () em uma aplicação com escopo, use o método com escopo correspondente: " [inícioOfEsteQuarter()"](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfThisQuarter "Retorna a data e a hora do início deste trimestre em GMT."). ## GlideSystem -- startsOf ThisWeek() {#ariaid-title12} Retorna a data e a hora do início desta semana em GMT. {#r_GS-beginningOfThisWeek__table_amj_3wv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 21. Parâmetros] {#r_GS-beginningOfThisWeek__table_amj_3wv_mt} {#r_GS-beginningOfThisWeek__table_bmj_3wv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT da semana atual. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 22. Retorna] {#r_GS-beginningOfThisWeek__table_bmj_3wv_mt} Este exemplo define o valor do registro de data/hora atual do Glide para o início da semana atual. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfThisWeek()); ### Equivalente com escopo Para usar o método startsOf ThisWeek () em uma aplicação com escopo, use o método com escopo correspondente: startsOf ThisWeek [()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfThisWeek "Retorna a data e a hora do início desta semana em GMT."). ## GlideSystem -- startsOf ThisYear() {#ariaid-title13} Retorna a data e a hora do início deste ano em GMT. {#r_GS-beginningOfThisYear__table_osd_5wv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 23. Parâmetros] {#r_GS-beginningOfThisYear__table_osd_5wv_mt} {#r_GS-beginningOfThisYear__table_psd_5wv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT do ano atual. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 24. Retorna] {#r_GS-beginningOfThisYear__table_psd_5wv_mt} Este exemplo define o valor do registro de data/hora atual do Glide como o início do ano atual. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfThisYear()); ### Equivalente com escopo Para usar o método startsOf ThisYear () em uma aplicação com escopo, use o método com escopo correspondente: startsOf ThisYear [()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-beginningOfThisYear "Retorna a data e a hora do início deste ano em GMT."). ## GlideSystem -- startsOfToday() {#ariaid-title14} Recupera a data e a hora do início de hoje em GMT. {#r_GS-beginningOfToday__table_vgl_bxv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 25. Parâmetros] {#r_GS-beginningOfToday__table_vgl_bxv_mt} {#r_GS-beginningOfToday__table_wgl_bxv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT do dia atual. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 26. Retorna] {#r_GS-beginningOfToday__table_wgl_bxv_mt} Este exemplo define o valor do registro de data/hora atual do Glide para o início do dia atual. var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.beginningOfToday()); ## GlideSystem -- startsOfTomorrow() {#ariaid-title15} Recupera o início (UTC) de amanhã ajustado para o fuso horário da sessão atual. {#r_GS-beginningOfTomorrow__table_vgl_bxv_dm__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 27. Parâmetros] {#r_GS-beginningOfTomorrow__table_vgl_bxv_dm} {#r_GS-beginningOfTomorrow__table_wgl_bxv_dm__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT a partir de amanhã. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 28. Retorna] {#r_GS-beginningOfTomorrow__table_wgl_bxv_dm} var today = new GlideDateTime(gs.beginningOfTomorrow()).getNumericValue(); ## GlideSystem -- startsOf Yesterday() {#ariaid-title16} Recupera a data e a hora do início de ontem em GMT. {#r_GS-beginningOfYesterday__table_owm_3xv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 29. Parâmetros] {#r_GS-beginningOfYesterday__table_owm_3xv_mt} {#r_GS-beginningOfYesterday__table_pwm_3xv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O GMT a partir de ontem, no formato aaaa-mm-dd hh:mm:ss. | [Tabela 30. Retorna] {#r_GS-beginningOfYesterday__table_pwm_3xv_mt} var start = new GlideDateTime(); start.setValue(gs.beginningOfYesterday()); ## GlideSystem - calDateDiff(cadeia de caracteres startDate, cadeia de caracteres endDate, Booliano numéricoValue) {#ariaid-title17} Calcule a diferença entre duas datas usando o calendário padrão. Os calendários agora são legados. Se Cronogramas estiverem sendo usados, consulte a seção "Calcular durante um determinado cronograma" do tópico [Scripts de programação úteis](https://servicenow-prod.fluidtopics.net/6~NNUIZGKZWbrIztfAPC~Q#c_UsefulSchedulingScripts "Um script de regra de negócio especifica as ações que a regra de negócio executa. Os scripts geralmente incluem variáveis globais predefinidas para fazer referência a itens em seu sistema, como o registro atual. As variáveis globais estão disponíveis para todas as regras de negócio."). {#r_GS-calDateDiff_S_S_B__table_ulx_gyv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | startDate | Cadeia de caracteres | Data de início a ser comparada no formato de data do usuário atual. | | endDate | Cadeia de caracteres | Data de término a ser comparada no formato de data do usuário atual. | | valor numérico | Booliano | Sinalizador que indica o formato do valor de tempo retornado. Valores válidos: * verdadeiro: o valor de retorno é formatado em número de segundos * falso: o valor de retorno está no formato ddd hh:mm:ss. | [Tabela 31. Parâmetros] {#r_GS-calDateDiff_S_S_B__table_ulx_gyv_mt} {#r_GS-calDateDiff_S_S_B__table_vlx_gyv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Se o parâmetro numericValue for verdadeiro, retornará a diferença entre as duas datas como um número inteiro de segundos. Se falso, retorna a diferença entre as duas datas no formato ddd hh:mm:ss. | [Tabela 32. Retorna] {#r_GS-calDateDiff_S_S_B__table_vlx_gyv_mt} var endDateTime = gs.nowDateTime(); gs.print('--- Total records: ' + countRecordsTotal); gs.print('--- End time: ' + endDateTime); gs.print('Time diff: ' + gs.calDateDiff(startDateTime, endDateTime)); ## GlideSystem - dateDiff(cadeia de caracteres startDate, cadeia de caracteres endDate, Booliano numéricoValue) {#ariaid-title18} Calcula a diferença entre duas datas. Este método espera a data anterior como o primeiro parâmetro e a data posterior como o segundo parâmetro; caso contrário, o método retornará a diferença como um valor negativo. Use getDisplayValue() para converter as cadeias de caracteres para o formato esperado. Este método espera parâmetros no formato de data e hora do usuário/sistema, que pode não ser igual ao formato interno. O uso de parâmetros em formatos diferentes do formato de data e hora do usuário/sistema pode retornar resultados inválidos. Se você estiver trabalhando com objetos GlideDateTime, use o método GlideDateTime subtract() em vez de dateDiff(). {#r_GS-dateDiff_S_S_B__table_t5n_2zv_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | startDate | Cadeia de caracteres | A data de início a ser comparada no formato de data do usuário atual. | | endDate | Cadeia de caracteres | A data de término a ser comparada no formato de data do usuário atual. | | valor numérico | Booliano | Se verdadeiro, o valor de retorno será formatado em número de segundos; se for falso, o valor de retorno será formatado como ddd hh:mm:ss. | [Tabela 33. Parâmetros] {#r_GS-dateDiff_S_S_B__table_t5n_2zv_mt} {#r_GS-dateDiff_S_S_B__table_u5n_2zv_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Se o parâmetro numéricaValue for verdadeiro, retornará a diferença entre as duas datas como um número inteiro de segundos; se falso, retorna a diferença entre as duas datas no formato ddd hh:mm:ss. | [Tabela 34. Retorna] {#r_GS-dateDiff_S_S_B__table_u5n_2zv_mt} // Given two date/times as DateTime objects // Set the values this way to ensure a consistent input time var date1 = new GlideDateTime(); var date2 = new GlideDateTime(); date1.setDisplayValueInternal('2014-01-01 12:00:00'); date2.setDisplayValueInternal('2014-01-01 13:00:00'); // Determine the difference as number of seconds (returns a string) // Use getDisplayValue() to convert the string to the format expected by dateDiff() var diffSeconds = gs.dateDiff(date1.getDisplayValue(), date2.getDisplayValue(), true); // JavaScript will coerce diffSeconds from a string to a number // since diffSeconds is being compared to a number var msg = (diffSeconds <= 0) ? ' is on or after ' : ' is before '; gs.print(date1.getDisplayValue() + msg + date2.getDisplayValue()) ## GlideSystem - dateGenerate(cadeia de caracteres data, cadeia de caracteres intervalo) {#ariaid-title19} Gera uma data e hora para a data especificada em GMT. {#r_GS-dateGenerate_S_S__table_ghf_3jw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Cadeia de caracteres | Data a ser gerada em GMT. Formato: aaaa-mm-dd | | intervalo | Cadeia de caracteres | Hora de início, de término ou. Formato: 24 horas hh:mm:ss | [Tabela 35. Parâmetros] {#r_GS-dateGenerate_S_S__table_ghf_3jw_mt} {#r_GS-dateGenerate_S_S__table_hhf_3jw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora de geração. Se o intervalo for start, o valor retornado será aaaa-mm-dd 00:00:00. Se o intervalo for fim, o valor de retorno será aaaa-mm-dd 23:59:59. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 36. Retorna] {#r_GS-dateGenerate_S_S__table_hhf_3jw_mt} Este exemplo mostra o uso de dateGenerate() para definir a data de início ao consultar registros na tabela Incidente. var tableData = new GlideRecord('incident'); tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2"); tableData.query(); gs.info("Count: " + tableData.getRowCount()); Saída: Count: 7 ### Equivalente com escopo {#r_GS-dateGenerate_S_S__section_zcf_gg5_y4b} Para usar o método dateGenerate() em uma aplicação com escopo, use o método com escopo correspondente: [dateGenerate()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_SGSYS-dateGenerate_S_S "Gera uma data e hora para a data especificada em GMT."). ## GlideSystem - daysAgo(Número de dias) {#ariaid-title20} Retorna uma data e hora para um determinado número de dias atrás. {#r_GS-daysAgo_N__table_vlc_zjw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dias | Número | Número de dias | [Tabela 37. Parâmetros] {#r_GS-daysAgo_N__table_vlc_zjw_mt} {#r_GS-daysAgo_N__table_wlc_zjw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT do número especificado de dias atrás. Formato: aaaa-mm-dd hh:mm:ss. | [Tabela 38. Retorna] {#r_GS-daysAgo_N__table_wlc_zjw_mt} function contractNoticeDue() { var now_GR = new GlideRecord("contract"); now_GR.addQuery("u_contract_status", "Active"); now_GR.query(); while (now_GR.next()) { if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) { now_GR.u_contract_status = "In review"; } else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) { now-GR.u_contract_status = "In review"; } else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) { now_GR.u_contract_status = "In review"; } } now_GR.update(); } ### Equivalente com escopo {#r_GS-daysAgo_N__section_c1p_m3s_mcb} Para usar o método daysAgo() em uma aplicação com escopo, use o método com escopo correspondente: [daysAgo()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-daysAgo_N "Retorna a data e a hora de um número especificado de dias atrás."). ## GlideSystem - daysAgoEnd(Número de dias) {#ariaid-title21} Retorna uma data e hora para o fim do dia há um número especificado de dias. {#r_GS-daysAgoEnd_N__table_umn_mkw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dias | Número | Número inteiro de dias | [Tabela 39. Parâmetros] {#r_GS-daysAgoEnd_N__table_umn_mkw_mt} {#r_GS-daysAgoEnd_N__table_vmn_mkw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O fim do dia GMT no formato aaaa-mm-dd hh:mm:ss. | [Tabela 40. Retorna] {#r_GS-daysAgoEnd_N__table_vmn_mkw_mt} Este exemplo mostra o uso de daysAgoEnd() para definir a data de término ao consultar registros na tabela Incidente. var tableData = new GlideRecord('incident'); tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2"); tableData.query(); gs.addInfoMessage("Count: " +tableData.getRowCount()); ### Equivalente com escopo Para usar o método daysAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: [daysAgoEnd()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-daysAgoEnd_N "Retorna a data e a hora do fim do dia há um número especificado de dias."). ## GlideSystem - daysAgoLocal(Número de dias) {#ariaid-title22} Retorna a data e a hora do início do dia para o número especificado de dias atrás. A data e a hora retornadas refletem o fuso horário da sessão atual (hora local). {#GS-daysAgoLocal_N__table_cvk_ktw_v1b__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dias | Número | Número de dias atrás | [Tabela 41. Parâmetros] {#GS-daysAgoLocal_N__table_cvk_ktw_v1b} {#GS-daysAgoLocal_N__table_dvk_ktw_v1b__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora locais para o início do dia no formato de data e hora definido pelo usuário. Se o formato de data e hora não for modificado em relação ao valor inicial, o formato será aaaa-mm-dd hh:mm:ss. | [Tabela 42. Retorna] {#GS-daysAgoLocal_N__table_dvk_ktw_v1b} if (due_in == "1 Day") { dd = gs.daysAgoLocal(-1); } if (due_in == "1 Week") { dd = gs.daysAgoLocal(-7); } ## GlideSystem - daysAgoStart(Número de dias) {#ariaid-title23} Retorna uma data e hora para o início do dia há um número especificado de dias. {#r_GS-daysAgoStart_N__table_xlm_ykw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dias | Cadeia de caracteres | Número inteiro de dias | [Tabela 43. Parâmetros] {#r_GS-daysAgoStart_N__table_xlm_ykw_mt} {#r_GS-daysAgoStart_N__table_ylm_ykw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início do dia GMT no formato aaaa-mm-dd hh:mm:ss | [Tabela 44. Retorna] {#r_GS-daysAgoStart_N__table_ylm_ykw_mt} var now_GR = new GlideRecord('sysapproval_approver'); now_GR.addQuery('state', 'requested'); now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5)); now_GR.query(); ### Equivalente com escopo {#r_GS-daysAgoStart_N__section_xf3_k3s_mcb} Para usar o método daysAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: [daysAgoStart()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-daysAgoStart_N "Retorna a data e a hora do início do dia há um número especificado de dias."). ## GlideSystem -- endOfLastMonth() {#ariaid-title24} Retorna a data e a hora do fim do último mês em GMT. {#r_GS-endOfLastMonth__table_ef1_jlw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 45. Parâmetros] {#r_GS-endOfLastMonth__table_ef1_jlw_mt} {#r_GS-endOfLastMonth__table_ff1_jlw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT do fim do último mês. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 46. Retorna] {#r_GS-endOfLastMonth__table_ff1_jlw_mt} Este exemplo mostra como consultar um registro de relatório do último dia do último mês. var month = gs.endOfLastMonth(); var monthd = new GlideDateTime(month); monthd.addDays(-1); var queueLast = new GlideRecord('u_amazon_connect_phone_metrics'); queueMtd.addQuery('u_queue_name',queueNames[i]); queueMtd.addEncodedQuery('u_time_range=MTD'); queueMtd.addEncodedQuery('u_report_date'+ monthd); queueMtd.orderByDesc('u_report_date'); queueMtd.query(); if(queueMtd.next()){ gs.info(queueMtd.u_report_date); } ### Equivalente com escopo Para usar o método endOfLastMonth() em uma aplicação com escopo, use o método com escopo correspondente: [endOfLastMonth()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfLastMonth "Retorna a data e a hora do fim do último mês em GMT."). ## GlideSystem -- endOfLastWeek() {#ariaid-title25} Retorna a data e a hora do fim da última semana em GMT. {#r_GS-endOfLastWeek__table_mth_qlw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 47. Parâmetros] {#r_GS-endOfLastWeek__table_mth_qlw_mt} {#r_GS-endOfLastWeek__table_nth_qlw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Fim GMT da semana passada. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 48. Retorna] {#r_GS-endOfLastWeek__table_nth_qlw_mt} Este exemplo mostra como consultar registros abertos na última semana do mês anterior. var inc = new GlideRecord('incident'); inc.addQuery('active=true^priority=1^opened_atONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()^opened_atONLast week@javascript:gs.beginningOfLastWeek()@javascript:gs.endOfLastWeek()'); inc.query(); while(inc.next()) { gs.addInfoMessage(inc.getRowCount()); } ### Equivalente com escopo Para usar o método endOfLastWeek() em uma aplicação com escopo, use o método com escopo correspondente: [endOfLastWeek()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfLastWeek "Retorna a data e a hora do fim da última semana em GMT."). ## GlideSystem -- endOfLastYear() {#ariaid-title26} Retorna a data e a hora do fim do último ano em GMT. {#r_GS-endOfLastYear__table_rzh_pww_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 49. Parâmetros] {#r_GS-endOfLastYear__table_rzh_pww_mt} {#r_GS-endOfLastYear__table_szh_pww_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no formato aaaa-mm-dd hh:mm:ss. | [Tabela 50. Retorna] {#r_GS-endOfLastYear__table_szh_pww_mt} Este exemplo mostra como consultar registros criados para todos os registros criados no último ano. var inc = new GlideRecord('incident'); inc.addEncodedQuery('sys_created_onONLast year@javascript:gs.beginningOfLastYear()@javascript:gs.endOfLastYear()'); inc.query(); while(inc.next()){ inc.assignment_group = "d625dccec0a8016700a222a0f7900d06"; inc.update(); } ### Equivalente com escopo Para usar o método endOfLastYear() em uma aplicação com escopo, use o método com escopo correspondente: [endOfLastYear()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfLastYear "Retorna a data e a hora do fim do último ano em GMT."). ## GlideSystem -- endOfNextMonth() {#ariaid-title27} Retorna a data e a hora do fim do próximo mês em GMT. {#r_GS-endOfNextMonth__table_cpz_xww_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 51. Parâmetros] {#r_GS-endOfNextMonth__table_cpz_xww_mt} {#r_GS-endOfNextMonth__table_dpz_xww_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Dados e hora GMT. Formato aaaa-mm-dd hh:mm:ss | [Tabela 52. Retorna] {#r_GS-endOfNextMonth__table_dpz_xww_mt} Este exemplo mostra como consultar registros de conhecimento da base de conhecimento criados desde o início de hoje até o final do próximo mês. var query = "kb_knowledge_base=e81c9a0ddbc15810c38f0763b99619c1^ORkb_knowledge_base=21302e89db055810c38f0763b99619cc^valid_toBETWEENjavascript:gs.beginningOfToday()@javascript:gs.endOfNextMonth()^ORworkflow_state=pending_retirement^latest=true"; var rec = new GlideRecord('kb_knowledge'); rec.addEncodedQuery(query); rec.addQuery('author', current.author); rec.query(); while (rec.next()) { var Kbtitle = rec.getValue('short_description'); articles.push(rec.number.toString()+ '' + Kbtitle); template.print('Click here to view record' + rec.number + ''); } var articlesList = ""; ### Equivalente com escopo Para usar o método endOfNextMonth() em uma aplicação com escopo, use o método com escopo correspondente: [endOfNextMonth()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfNextMonth "Retorna a data e a hora do fim do próximo mês em GMT."). ## GlideSystem -- endOfNextWeek() {#ariaid-title28} Retorna a data e a hora do fim da próxima semana em GMT. {#r_GS-endOfNextWeek__table_c2q_kxw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 53. Parâmetros] {#r_GS-endOfNextWeek__table_c2q_kxw_mt} {#r_GS-endOfNextWeek__table_d2q_kxw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora GMT para o fim da próxima semana. Formato aaaa-mm-dd hh:mm:ss | [Tabela 54. Retorna] {#r_GS-endOfNextWeek__table_d2q_kxw_mt} Este exemplo mostra como usar endOfNextWeek() em uma consulta para obter todos os visitantes da semana passada. var title = 'Visitors arriving this Week'; var visitorQuery = 'active=true^category=visitor_request^u_my_start_dateONThis week@javascript:gs.beginningOfThisWeek()@javascript:gs.endOfNextWeek()'; ### Equivalente com escopo Para usar o método endOfNextWeek() em uma aplicação com escopo, use o método com escopo correspondente: [endOfNextWeek()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemEofNW "Retorna a data e a hora do fim da próxima semana em GMT."). ## GlideSystem -- endOfNextYear() {#ariaid-title29} Retorna a data e a hora do fim do próximo ano em GMT. {#r_GS-endOfNextYear__table_u3w_rxw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 55. Parâmetros] {#r_GS-endOfNextYear__table_u3w_rxw_mt} {#r_GS-endOfNextYear__table_v3w_rxw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora GMT para o final do próximo ano. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 56. Retorna] {#r_GS-endOfNextYear__table_v3w_rxw_mt} Este exemplo mostra como usar endOfNextYear() para definir o objeto GlideDateTime para o final do próximo ano. setEndDate : function(dt) { var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.endOfNextYear()); } ### Equivalente com escopo Para usar o método endOfNextYear() em uma aplicação com escopo, use o método com escopo correspondente: [endOfNextYear()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfNextYear "Retorna a data e a hora do fim do próximo ano em GMT."). ## GlideSystem -- endOf ThisMonth() {#ariaid-title30} Retorna a data e a hora do fim deste mês em GMT. {#r_GS-endOfThisMonth__table_bky_lyw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 57. Parâmetros] {#r_GS-endOfThisMonth__table_bky_lyw_mt} {#r_GS-endOfThisMonth__table_cky_lyw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora GMT para o final deste mês. Formato aaaa-mm-dd hh:mm:ss | [Tabela 58. Retorna] {#r_GS-endOfThisMonth__table_cky_lyw_mt} Este exemplo mostra como usar endOf ThisMonth() para definir o objeto GlideDateTime para o fim do mês atual. setEndDate : function(dt) { var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.endOfThisMonth()); } ### Equivalente com escopo Para usar o método endOf ThisMonth () em uma aplicação com escopo, use o método com escopo correspondente: [endOf ThisMonth ()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfThisMonth "Retorna a data e a hora do fim deste mês em GMT."). ## GlideSystem -- endOf ThisQuarter() {#ariaid-title31} Retorna a data e a hora do fim deste trimestre em GMT. {#r_GS-endOfThisQuarter__table_ijn_5yw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 59. Parâmetros] {#r_GS-endOfThisQuarter__table_ijn_5yw_mt} {#r_GS-endOfThisQuarter__table_jjn_5yw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora GMT para o final deste trimestre. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 60. Retorna] {#r_GS-endOfThisQuarter__table_jjn_5yw_mt} Este exemplo mostra como usar endOf ThisQuarter() para definir o objeto GlideDateTime para o fim do mês atual. setEndDate : function(dt) { var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.endOfThisQuarter()); } ### Equivalente com escopo Para usar o método endOf ThisQuarter() em uma aplicação com escopo, use o método com escopo correspondente: [endOf ThisQuarter()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfThisQuarter "Retorna a data e a hora do fim deste trimestre em GMT."). ## GlideSystem -- endOf ThisWeek() {#ariaid-title32} Retorna a data e a hora do fim desta semana em GMT. {#r_GS-endOfThisWeek__table_jqb_czw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 61. Parâmetros] {#r_GS-endOfThisWeek__table_jqb_czw_mt} {#r_GS-endOfThisWeek__table_kqb_czw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora GMT para o final desta semana. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 62. Retorna] {#r_GS-endOfThisWeek__table_kqb_czw_mt} Este exemplo mostra como usar endOf ThisWeek() para definir o objeto GlideDateTime para o fim do mês atual. setEndDate : function(dt) { var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.endOfThisWeek()); } ### Equivalente com escopo Para usar o método endOf ThisWeek () em uma aplicação com escopo, use o método com escopo correspondente: [endOf ThisWeek ()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfThisWeek "Retorna a data e a hora do fim desta semana em GMT."). ## GlideSystem -- endOf ThisYear() {#ariaid-title33} Retorna a data e a hora do fim deste ano em GMT. {#r_GS-endOfThisYear__table_ayg_4zw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 63. Parâmetros] {#r_GS-endOfThisYear__table_ayg_4zw_mt} {#r_GS-endOfThisYear__table_byg_4zw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora GMT para o final deste ano. Formato aaaa-mm-dd hh:mm:ss | [Tabela 64. Retorna] {#r_GS-endOfThisYear__table_byg_4zw_mt} Este exemplo mostra como usar endOf ThisYear() para definir o objeto GlideDateTime para o fim do mês atual. setEndDate : function(dt) { var gdt2 = new GlideDateTime(dt); gdt2.setValue(gs.endOfThisYear()); } ### Equivalente com escopo Para usar o método endOf ThisYear () em uma aplicação com escopo, use o método com escopo correspondente: [endOf ThisYear ()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-endOfThisYear "Retorna a data e a hora do fim deste ano em GMT."). ## GlideSystem -- endOfToday() {#ariaid-title34} Recupera a data e a hora do fim de hoje em GMT. {#r_GS-endOfToday__table_hy4_vzw_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 65. Parâmetros] {#r_GS-endOfToday__table_hy4_vzw_mt} {#r_GS-endOfToday__table_iy4_vzw_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no formato aaaa-mm-dd hh:mm:ss. | [Tabela 66. Retorna] {#r_GS-endOfToday__table_iy4_vzw_mt} var beginToday = gs.beginningOfToday(); var endToday = gs.endOfToday(); var beginTomorrow = gs.beginningOfTomorrow(); var endTomorrow = gs.endOfTomorrow(); var beginYesterday = gs.beginningOfYesterday(); var endYesterday = gs.endOfYesterday(); gs.info('beginningOfToday: ' + beginToday); gs.info('endOfToday: ' + endToday); gs.info('-----------'); gs.info('beginningOfTomorrow: ' + beginTomorrow); gs.info('endOfTomorrow: ' + endTomorrow); gs.info('beginningOfYesterday: ' + beginYesterday); gs.info('endOfYesterday: ' + endYesterday); gs.info('-----------'); var gdt1 = new GlideDateTime(beginToday); var gdt2 = new GlideDateTime(beginTomorrow); var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 gs.info('BeginTomorrow: ' + dur.getDisplayValue()); var gdt1 = new GlideDateTime(endToday); var gdt2 = new GlideDateTime(endTomorrow); var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 gs.info('EndTomorrow: ' + dur.getDisplayValue()); var gdt1 = new GlideDateTime(beginToday); var gdt2 = new GlideDateTime(beginYesterday); var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 gs.info('BeginningYesterday: ' + dur.getDisplayValue()); var gdt1 = new GlideDateTime(endToday); var gdt2 = new GlideDateTime(endYesterday); var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 gs.info('EndYesterday: ' + dur.getDisplayValue()); ## GlideSystem -- endOfTomorrow() {#ariaid-title35} Recupera a data e a hora do fim de amanhã em GMT. {#r_GS-endOfTomorrow__table_hy4_vzw_xy__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 67. Parâmetros] {#r_GS-endOfTomorrow__table_hy4_vzw_xy} {#r_GS-endOfTomorrow__table_iy4_vzw_zx__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no formato aaaa-mm-dd hh:mm:ss. | [Tabela 68. Retorna] {#r_GS-endOfTomorrow__table_iy4_vzw_zx} var tomorrowEnd = new GlideDateTime(); tomorrowEnd.setValue(gs.endOfTomorrow()); ## GlideSystem -- endOf Yesterday () {#ariaid-title36} Obtém a data e a hora do fim de ontem em GMT. {#r_GS-endOfYesterday__table_lyt_c1x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 69. Parâmetros] {#r_GS-endOfYesterday__table_lyt_c1x_mt} {#r_GS-endOfYesterday__table_myt_c1x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT no formato (aaaa-mm-dd uh:mm:ss). | [Tabela 70. Retorna] {#r_GS-endOfYesterday__table_myt_c1x_mt} var yesterdayEnd = new GlideDateTime(); yesterdayEnd.setValue(gs.endOfYesterday()); ## GlideSystem - eventQueue(cadeia de caracteres nome, objeto glideRecord, cadeia de caracteres parm1, cadeia de caracteres parm2, fila de cadeias de caracteres) {#ariaid-title37} Enfileira um evento para o gerenciador de eventos. {#r_GS-eventQueue_S_O_S_S_S__table_pkj_nf5_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | nome | Cadeia de caracteres | Nome do evento que está sendo enfileirado. | | glideRecord | Objeto | Objeto GlideRecord, como "atual". | | parm1 | Cadeia de caracteres | (Opcional) Salvo com a instância, se especificado. | | parm2 | Cadeia de caracteres | (Opcional) Salvo com a instância, se especificado. | | fila | Cadeia de caracteres | Nome da fila. | [Tabela 71. Parâmetros] {#r_GS-eventQueue_S_O_S_S_S__table_pkj_nf5_lt} {#r_GS-eventQueue_S_O_S_S_S__table_qkj_nf5_lt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 72. Retorna] {#r_GS-eventQueue_S_O_S_S_S__table_qkj_nf5_lt} if (current.operation() != 'insert' && current.comments.changes()) { gs.eventQueue("incident.commented", current, gs.getUserID(), gs.getUserName()); } ### Equivalente com escopo {#r_GS-eventQueue_S_O_S_S_S__section_hlh_hjs_mcb} Para usar o método eventQueue() em uma aplicação com escopo, use o método com escopo correspondente: [eventQueue()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemEventQueue_String_Object_String_String_String "Enfileira um evento para o gerenciador de eventos."). ## GlideSystem - eventQueueScheduled(cadeia de caracteres name, objeto glideRecord, cadeia de caracteres parm1, cadeia de caracteres parm2, objeto expiração) {#ariaid-title38} Enfileira um evento para o gerenciador de eventos em uma data e hora especificadas. {#GS-eventQueueScheduled_S_O_S_S_O__table_yb2_qsy_h2b__entry__3} | Nome | Tipo | Descrição | |-|-|-| | nome | Cadeia de caracteres | Nome do evento que está sendo enfileirado. | | glideRecord | Objeto | Objeto GlideRecord, como "atual". | | parm1 | Cadeia de caracteres | (Opcional) Salvo com a instância, se especificado. | | parm2 | Cadeia de caracteres | (Opcional) Salvo com a instância, se especificado. | | expiração | Objeto | Data e hora para processar este evento. | [Tabela 73. Parâmetros] {#GS-eventQueueScheduled_S_O_S_S_O__table_yb2_qsy_h2b} {#GS-eventQueueScheduled_S_O_S_S_O__table_zb2_qsy_h2b__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 74. Retorna] {#GS-eventQueueScheduled_S_O_S_S_O__table_zb2_qsy_h2b} if (current.operation() != 'insert' && current.comments.changes()) { gs.eventQueueScheduled("incident.commented", current, gs.getUserID(), gs.getUserName(), new GlideDateTime('2018-06-02 20:00:00')); } ### Equivalente com escopo {#GS-eventQueueScheduled_S_O_S_S_O__section_hlh_hjs_mcb} Para usar o método eventQueueScheduled() em uma aplicação com escopo, use o método com escopo correspondente: [eventQueueScheduled()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_SGSYS-eventQSched_S_O_S_S_O "Enfileira um evento no gerenciador de eventos."). ## GlideSystem -- FlushMessages() {#ariaid-title39} Limpa mensagens de sessão salvas usando addErrorMessage() ou addInfoMessage(). As mensagens da sessão são mostradas na parte superior do formulário. Em scripts do lado do cliente, use g_form.clearMessages() para remover mensagens da sessão. {#r_GS-flushMessages__table_nzn_c1b_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 75. Parâmetros] {#r_GS-flushMessages__table_nzn_c1b_mt} {#r_GS-flushMessages__table_ozn_c1b_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 76. Retorna] {#r_GS-flushMessages__table_ozn_c1b_mt} Este exemplo mostra como analisar e passar de volta mensagens de erro e, em seguida, limpar as mensagens usando FlushMessages(). MySessionUtil.getSessionError = function() { var msg = null; var msgs = gs.getErrorMessages().toArray(); if (msgs.length > 0) { msg = msgs[0] + ''; gs.flushMessages(); } return msg; }; ## GlideSystem -- getAvatar() {#ariaid-title40} Retorna o caminho do arquivo para o avatar do usuário. {#r_GlideSystemGetAvatar__table_hwf_qt5_ts__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 77. Parâmetros] {#r_GlideSystemGetAvatar__table_hwf_qt5_ts} {#r_GlideSystemGetAvatar__table_iwf_qt5_ts__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O caminho do arquivo para o avatar do usuário. | [Tabela 78. Retorna] {#r_GlideSystemGetAvatar__table_iwf_qt5_ts} var avatarFile = gs.getUser().getAvatar(); gs.addInfoMessage('User avatar ID: ' + avatarFile); Saída: User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small ## GlideSystem -- getCurrentScopeName() {#ariaid-title41} Retorna o nome do escopo da aplicação atual. {#r_GS-getCurrentScopeName__table_hkd_pg5_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 79. Parâmetros] {#r_GS-getCurrentScopeName__table_hkd_pg5_lt} {#r_GS-getCurrentScopeName__table_ikd_pg5_lt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Nome do escopo atual. | [Tabela 80. Retorna] {#r_GS-getCurrentScopeName__table_ikd_pg5_lt} Este exemplo mostra como usar getCurrentScopeName() para obter o escopo do processador. var incident_GR = new GlideRecord('Incident'); if (incident_GR.get("2e3f6baddb9ad600added8fdbf9618cb")) { gs.debug("processor scope = "+ gs.getCurrentScopeName()); var w = new global.Workflow(); var context = w.startFlow('1f4a4baddb9ad600affed8fdbf9619bc', incident_GR, "update"); //id = id workflow } ### Equivalente com escopo Para usar o método getCurrentScopeName() em uma aplicação com escopo, use o método com escopo correspondente: [getCurrentScopeName()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetCurrentScopeName "Obtém o nome do escopo atual."). ## GlideSystem -- getDateFormat() {#ariaid-title42} Retorna o formato de data associado ao usuário atual. {#GS-getDateFormat_S__table_lwb_dw4_m5b__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 81. Parâmetros] {#GS-getDateFormat_S__table_lwb_dw4_m5b} {#GS-getDateFormat_S__table_mwb_dw4_m5b__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O formato de data associado ao usuário atual. | [Tabela 82. Retorna] {#GS-getDateFormat_S__table_mwb_dw4_m5b} O exemplo a seguir retorna o formato de data associado ao usuário. var userDateFormat = gs. getDateFormat(); gs.info(userDateFormat); Saída: yyyy-MM-dd ## GlideSystem -- getDateTimeFormat() {#ariaid-title43} Retorna o formato de data e hora associado ao usuário atual. {#GS-getDateTimeFormat_S__table_lcm_2np_m5b__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 83. Parâmetros] {#GS-getDateTimeFormat_S__table_lcm_2np_m5b} {#GS-getDateTimeFormat_S__table_mcm_2np_m5b__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O formato de data e hora associado ao usuário atual. | [Tabela 84. Retorna] {#GS-getDateTimeFormat_S__table_mcm_2np_m5b} O exemplo a seguir retorna o formato da data e hora associados ao usuário. var userDateTimeFormat = gs.getDateTimeFormat(); gs.info(userDateTimeFormat); Saída: yyyy-MM-dd HH:mm:ss ## GlideSystem -- getDisplayColumn(cadeia de caracteres "tableName") {#ariaid-title44} Recupera a coluna de exibição da tabela. {#r_GS-getDisplayColumn_S__table_wp5_bh5_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | tableName | Cadeia de caracteres | Nome da tabela da qual será obtido o nome da coluna de exibição. | [Tabela 85. Parâmetros] {#r_GS-getDisplayColumn_S__table_wp5_bh5_lt} {#r_GS-getDisplayColumn_S__table_xp5_bh5_lt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Exibir nome da coluna | [Tabela 86. Retorna] {#r_GS-getDisplayColumn_S__table_xp5_bh5_lt} // Return the sys_id value for a given table and its display value function GetIDValue(table, displayValue) { var rec = new GlideRecord(table); var dn = gs.getDisplayColumn(table); if (rec.get(dn, displayValue)) return rec.sys_id; else return null; } ## GlideSystem -- getDisplayValueFor(cadeia de caracteres "tableName", cadeia de caracteres recordID, cadeia de caracteres "fieldName") {#ariaid-title45} Retorna o valor de exibição de um campo especificado em um registro especificado. {#r_GS-getDisplayValueFor_S_S_S__table_ic1_th5_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | tableName | Cadeia de caracteres | Nome da tabela. | | recordID | Cadeia de caracteres | Sys_id do registro. | | fieldName | Cadeia de caracteres | Nome do campo cujo valor de exibição será retornado. | [Tabela 87. Parâmetros] {#r_GS-getDisplayValueFor_S_S_S__table_ic1_th5_lt} {#r_GS-getDisplayValueFor_S_S_S__table_jc1_th5_lt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Valor de exibição para o campo. | [Tabela 88. Retorna] {#r_GS-getDisplayValueFor_S_S_S__table_jc1_th5_lt} Este exemplo mostra como usar getDisplayValueFor() para retornar o valor de exibição do campo numérico. var value = gs.getDisplayValueFor(current.getTableName(),current.getValue('sys_id'),'number'); ## GlideSystem -- getErrorMessages() {#ariaid-title46} Retorna a lista de mensagens de erro da sessão que foram adicionadas por addErrorMessage(). {#r_GS-getErrorMessages__table_kdg_q1b_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 89. Parâmetros] {#r_GS-getErrorMessages__table_kdg_q1b_mt} {#r_GS-getErrorMessages__table_ldg_q1b_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Lista de mensagens de erro | [Tabela 90. Retorna] {#r_GS-getErrorMessages__table_ldg_q1b_mt} Este exemplo mostra como analisar e passar de volta mensagens de erro usando getErrorMessages(). MySessionUtil.getSessionError = function() { var msg = null; var msgs = gs.getErrorMessages().toArray(); if (msgs.length > 0) { msg = msgs[0] + ''; gs.flushMessages(); } return msg; }; ### Equivalente com escopo Para usar o método getErrorMessages() em uma aplicação com escopo, use o método com escopo correspondente: [getErrorMessages()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-getErrorMessages "Retorna as mensagens de erro que foram adicionadas por addErrorMessage() à sessão."). ## GlideSystem - getEscapedProperty(cadeia de caracteres chave, objeto substituto de objeto) {#ariaid-title47} Recupera a propriedade e faz o escape para análise de XML. {#r_GS-getEscapedProperty_S_O__table_gj5_l35_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | chave | Cadeia de caracteres | Chave da propriedade cujo valor deve ser retornado. | | Substituir Objeto | Objeto | Opcional. Objeto a ser retornado se a propriedade não for encontrada. | [Tabela 91. Parâmetros] {#r_GS-getEscapedProperty_S_O__table_gj5_l35_lt} {#r_GS-getEscapedProperty_S_O__table_hj5_l35_lt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | A propriedade ou o substitutoObject se a propriedade não for encontrada. | [Tabela 92. Retorna] {#r_GS-getEscapedProperty_S_O__table_hj5_l35_lt} var propValue = gs.getEscapedProperty("com.example.my_test_property"); gs.addInfoMessage("This is my property value " + propValue); ## GlideSystem -- getImpersonatingUserDisplayName() {#ariaid-title48} Retorna o nome de exibição do usuário que está representando. {#r_GS-getImpersonatingUserDispName__table_jlq_fbb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 93. Parâmetros] {#r_GS-getImpersonatingUserDispName__table_jlq_fbb_mt} {#r_GS-getImpersonatingUserDispName__table_klq_fbb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Nome de exibição do usuário que está representando. | [Tabela 94. Retorna] {#r_GS-getImpersonatingUserDispName__table_klq_fbb_mt} Este exemplo mostra como obter o nome de exibição do usuário do representante. var user = gs.getUserDisplayName(); gs.print ("The current user display name is: " + user); var name = gs.getImpersonatingUserDisplayName(); gs.print("Impersonating user display name: " + name); Saída: The current user display name is: abel.tuter Impersonating user display name: admin ## GlideSystem -- getImpersonatingUserName() {#ariaid-title49} Retorna o nome do usuário de representação ou nulo se não estiver representando. {#r_GS-getImpersonatingUserName__table_u4p_nfb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 95. Parâmetros] {#r_GS-getImpersonatingUserName__table_u4p_nfb_mt} {#r_GS-getImpersonatingUserName__table_v4p_nfb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Nome do usuário que está representando | [Tabela 96. Retorna] {#r_GS-getImpersonatingUserName__table_v4p_nfb_mt} Este exemplo mostra como obter o nome de usuário do representante. var name = gs.getImpersonatingUserName(); var actual_user = null; if (name == null || name == '') actual_user = user; else actual_user = Packages.com.glide.sys.User.getUser(name); var recent_impersonations = actual_user.getPreference('recent.impersonations'); var admin_role=actual_user.hasRole("admin"); ## GlideSystem -- getInfoMessages() {#ariaid-title50} Recupera a lista de mensagens informativas da sessão que foram adicionadas por addInfoMessage(). {#r_GS-getInfoMessages__table_tw1_wfb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 97. Parâmetros] {#r_GS-getInfoMessages__table_tw1_wfb_mt} {#r_GS-getInfoMessages__table_uw1_wfb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Lista de mensagens informativas. | [Tabela 98. Retorna] {#r_GS-getInfoMessages__table_uw1_wfb_mt} Este exemplo mostra como obter as mensagens informativas. var messages = gs.getInfoMessages(); if (messages.toString().indexOf('Conflicts Detected') == -1) gs.addInfoMessage(msg); ## GlideSystem -- getInitials() {#ariaid-title51} Retorna as iniciais do usuário. {#r_GlideSystemGetInitials__table_dvl_j55_ts__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 99. Parâmetros] {#r_GlideSystemGetInitials__table_dvl_j55_ts} {#r_GlideSystemGetInitials__table_evl_j55_ts__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | As iniciais do usuário. | [Tabela 100. Retorna] {#r_GlideSystemGetInitials__table_evl_j55_ts} var userInitials = gs.getUser().getInitials(); gs.addInfoMessage('User initials: ' + userInitials); Saída: User initials: SA ## GlideSystem - getMessage(cadeia de caracteres messageID, argumentos de objeto) {#ariaid-title52} Recupera mensagens traduzidas da tabela Mensagem \[sys_ui_message\] para exibir em uma IU. Se o identificador de mensagem especificado (chave) existir na tabela Mensagem \[sys_ui_message\] para o idioma atual, o método retornará a mensagem traduzida. Se o identificador de mensagem especificado não existir para o idioma atual, o método retornará a versão em inglês da mensagem. Se o identificador da mensagem não existir na tabela, ele retornará o ID da mensagem. Para obter informações adicionais sobre a tabela Mensagem, consulte [Tabela Mensagem](https://www.servicenow.com/docs/access?context=r_MessageTable&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Nota: Se a mensagem de IU tiver um tiquetaque ('), pode haver problemas com a mensagem no script; para escapar dos tiques ('), use getMessageS(String, Object). {#r_GS-getMessage_S_O__table_czl_5j5_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | ID da mensagem | Cadeia de caracteres | Identificador de mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem \[sys_ui_message\]. Observe que o campo Chave pode ser exatamente igual à cadeia de caracteres da mensagem real. | | args | Objeto | Opcional. Lista de cadeias de caracteres ou outros valores definidos por java.text.MessageFormat que substituem as variáveis na mensagem especificada. Por exemplo: `gs.getMessage("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo , '{0}' foi substituído pelo conteúdo de current.action.name. Nota: Os valores passados não são traduzidos. Eles são inseridos textualmente na mensagem. | [Tabela 101. Parâmetros] {#r_GS-getMessage_S_O__table_czl_5j5_lt} {#r_GS-getMessage_S_O__table_dzl_5j5_lt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Mensagem de IU solicitada. | [Tabela 102. Retorna] {#r_GS-getMessage_S_O__table_dzl_5j5_lt} Este exemplo mostra a mensagem retornada para o usuário atual quando o espanhol é o idioma atual. var my_message = gs.getMessage("rows will not be updated"); alert(my_message); Saída: las filas no se actualizarán Este exemplo mostra como substituir uma única variável em uma mensagem. // current.action.name is "update record" var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in this subflow.", current.action.name); alert(my_message); Saída: Abort adding action update record, same subflow can't be added twice in this subflow. Este exemplo mostra como substituir várias variáveis em uma mensagem. // current.sub_flow.name is 'schedule users' // current.action.name is "update record" var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]); alert(my_message); Saída: Abort adding action update record, same subflow can't be added twice in schedule users subflow. ### Equivalente com escopo {#r_GS-getMessage_S_O__section_tvw_3qs_mcb} Para usar o método getMessage() em uma aplicação com escopo, use o método com escopo correspondente: [getMessage()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetMessage_String_Object "Recupera mensagens traduzidas da tabela Mensagem [sys_ui_message] para exibir em uma IU."). ## GlideSystem - getMessageS(cadeia de caracteres messageID, argumentos de objeto) {#ariaid-title53} Recupera mensagens traduzidas para exibir na IU e faz o escape de todos os tiques ('). Se o identificador de mensagem especificado (chave) existir na tabela Mensagem \[sys_ui_message\] para o idioma atual, o método retornará a mensagem traduzida. Se o identificador de mensagem especificado não existir para o idioma atual, o método retornará a versão em inglês da mensagem. Se o identificador da mensagem não existir na tabela, ele retornará o ID da mensagem. Para obter informações adicionais sobre a tabela Mensagem, consulte [Tabela Mensagem](https://www.servicenow.com/docs/access?context=r_MessageTable&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Útil se você estiver inserindo em uma expressão JavaScript do Jelly. {#r_GS-getMessageS_S_O__table_gyt_xk5_lt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | ID da mensagem | Cadeia de caracteres | Identificador de mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem \[sys_ui_message\]. Observe que o campo Chave pode ser exatamente igual à cadeia de caracteres da mensagem real. | | args | Objeto | Opcional. Lista de cadeias de caracteres ou outros valores definidos por java.text.MessageFormat que substituem as variáveis na mensagem especificada. Por exemplo: `gs.getMessage("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo , '{0}' foi substituído pelo conteúdo de current.action.name. Nota: Os valores passados não são traduzidos. Eles são inseridos textualmente na mensagem. | [Tabela 103. Parâmetros] {#r_GS-getMessageS_S_O__table_gyt_xk5_lt} {#r_GS-getMessageS_S_O__table_hyt_xk5_lt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Mensagem especificada com tiques de escape. | [Tabela 104. Retorna] {#r_GS-getMessageS_S_O__table_hyt_xk5_lt} /* "I love France" translates to "J'aime la France" in French. Rendering this without escaping the tick in "J'aime" would break Jelly, because the tick would prematurely end the variable assignment, and everything that follows (aime la France') would be a jelly syntax error. */ var my_message = '${gs.getMessageS("I love France")}'; alert(my_message); Saída: J'aime la France ## GlideSystem - getMessageLang (cadeia de caracteres de mensagem, cadeia de caracteres de idioma, argumentos de matriz) {#ariaid-title54} Traduz a mensagem especificada para o idioma especificado. Você também pode incorporar variáveis na mensagem passada. O método resolve essas variáveis com os valores passados na matriz args. {#GS-getMessageLang_S_S_O__table_m4v_3tl_zyb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | message | Cadeia de caracteres | Mensagem a ser traduzida. | | idioma | Cadeia de caracteres | Idioma no qual a mensagem será traduzida. Formato: padrão BCP 47 | | args | Matriz | Opcional. Lista de cadeias de caracteres ou outros valores definidos por java.text.MessageFormat que substituem as variáveis na mensagem especificada. Por exemplo: `gs.getMessageLang("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo , '{0}' foi substituído pelo conteúdo de current.action.name. Nota: Os valores passados não são traduzidos. Eles são inseridos textualmente na mensagem. | [Tabela 105. Parâmetros] {#GS-getMessageLang_S_S_O__table_m4v_3tl_zyb} {#GS-getMessageLang_S_S_O__table_n4v_3tl_zyb__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Mensagem traduzida. | [Tabela 106. Retorna] {#GS-getMessageLang_S_S_O__table_n4v_3tl_zyb} O exemplo a seguir transforma a mensagem especificada em espanhol. var my_message = gs.getMessageLang("New email", "es"); gs.info(my_message); Saída: Nuevo correo electrónico O exemplo a seguir mostra como substituir variáveis em uma mensagem. var my_message = gs.getMessageLang("There are {0} new emails for {1}", "es", [current.numEmails, current.userName]); gs.info(my_message); Saída: Hay 7 correos nuevos para John Smith ## GlideSystem - getNodeName (objeto de objeto, índice de número) {#ariaid-title55} Retorna o nome do nó do índice especificado. {#r_GS-getNodeName_O_N__table_mqs_3hb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | obj | Objeto | Objeto a ser examinado. | | índice | Número | Índice do qual obter o nome do nó. | [Tabela 107. Parâmetros] {#r_GS-getNodeName_O_N__table_mqs_3hb_mt} {#r_GS-getNodeName_O_N__table_nqs_3hb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Nome do nó | [Tabela 108. Retorna] {#r_GS-getNodeName_O_N__table_nqs_3hb_mt} function doInsert(nodeList) { gs.print('Doing insert'); var task = new GlideRecord('task'); task.initialize(); for (var x=0; x < nodeList.size(); x++) { var name = gs.getNodeName(nodeList, x); var value = gs.getNodeValue(nodeList, x); task.setValue(name, value); } task.insert(); } ## GlideSystem - getNodeValue (objeto de objeto, índice de número) {#ariaid-title56} Retorna o valor do nó para o índice especificado. {#r_GS-getNodeValue_O_N__table_cxv_5gb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | obj | Objeto | Objeto a ser examinado. | | índice | Número | Índice do qual obter o valor do nó | [Tabela 109. Parâmetros] {#r_GS-getNodeValue_O_N__table_cxv_5gb_mt} {#r_GS-getNodeValue_O_N__table_dxv_5gb_mt__entry__2} | Tipo | Descrição | |-|-| | Objeto | Valor do nó | [Tabela 110. Retorna] {#r_GS-getNodeValue_O_N__table_dxv_5gb_mt} function doInsert(nodeList) { gs.print('Doing insert'); var task = new GlideRecord('task'); task.initialize(); for (var x=0; x < nodeList.size(); x++) { var name = gs.getNodeName(nodeList, x); var value = gs.getNodeValue(nodeList, x); task.setValue(name, value); } task.insert(); } ## GlideSystem - getPreference (chave de cadeia de caracteres, padrão de objeto) {#ariaid-title57} Retorna a preferência do usuário especificada. {#r_GS-getPreference_S_O__table_vz2_vhb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | chave | Cadeia de caracteres | Chave para a preferência. | | padrão | Objeto | Valor padrão a ser usado se a preferência especificada não for encontrada. | [Tabela 111. Parâmetros] {#r_GS-getPreference_S_O__table_vz2_vhb_mt} {#r_GS-getPreference_S_O__table_wz2_vhb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Valor de preferência. Se não houver preferência, retorna o valor padrão especificado. | [Tabela 112. Retorna] {#r_GS-getPreference_S_O__table_wz2_vhb_mt} function getSelectedProject() { var array= new Array(); var prj_id = gs.getPreference("prj_id"); //This will fetch value from user preference var gr = new GlideRecord('pm_project_task'); gr.addQuery('parent', prj_id); gr.addActiveQuery(); while(gr.next()) { array.push(gr.sys_id.toString()); } return array; } ## GlideSystem - getProperty (cadeia de caracteres chave, objeto alt) {#ariaid-title58} Retorna o valor de uma propriedade do Glide. Se a propriedade não for encontrada, retornará o valor alt especificado. {#r_GS-getProperty_S_O__table_s2k_ns1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | chave | Cadeia de caracteres | Chave da propriedade cujo valor deve ser retornado. | | alt | Objeto | Opcional. Objeto alternativo a ser retornado se a propriedade não for encontrada. | [Tabela 113. Parâmetros] {#r_GS-getProperty_S_O__table_s2k_ns1_mt} {#r_GS-getProperty_S_O__table_t2k_ns1_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Valor da propriedade Glide ou do objeto alternativo definido acima. | [Tabela 114. Retorna] {#r_GS-getProperty_S_O__table_t2k_ns1_mt} //Check for attachments and add link if there are any var attachment_link = ''; var rec = new GlideRecord('sc_req_item'); rec.addQuery('sys_id', current.request_item); rec.query(); if(rec.next()){ if(rec.hasAttachments()){ attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink(); } } ## GlideSystem - getScriptError(cadeia de caracteres script) {#ariaid-title59} Retorna o erro de script encontrado no script especificado, se houver. Nota: O script não é executado por esta função, ele é verificado somente quanto a erros de sintaxe. {#r_GS-getScriptError_S__table_p35_dt1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | script | Cadeia de caracteres | Script para verificar erros. | [Tabela 115. Parâmetros] {#r_GS-getScriptError_S__table_p35_dt1_mt} {#r_GS-getScriptError_S__table_q35_dt1_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Mensagens de erro Nulo se não houver erro. | [Tabela 116. Retorna] {#r_GS-getScriptError_S__table_q35_dt1_mt} if (gs.isValidScript(current.script) == false) { current.setAbortAction(true); var error = gs.getScriptError(current.script); current.script.setError(error); } ## GlideSystem -- getSession() {#ariaid-title60} Retorna um objeto GlideSession. {#r_GS-getSession__table_k2k_j3b_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 117. Parâmetros] {#r_GS-getSession__table_k2k_j3b_mt} {#r_GS-getSession__table_l2k_j3b_mt__entry__2} | Tipo | Descrição | |-|-| | Objeto GlideSession | Objeto GlideSession para a sessão atual | [Tabela 118. Retorna] {#r_GS-getSession__table_l2k_j3b_mt} if(!gs.hasRole("admin") && gs.getSession().isInteractive() && gs.getUserName() != "guest"){ var qc = current.addQuery('u_visibility', "both"); qc.addOrCondition('u_visibility', ''); if (gs.getImpersonatingUserName() != null) { gs.getSession().clearClientData('navQuery'); } var navQuery = gs.getSession().getClientData('navQuery'); if (navQuery == null) { var isManager = gs.getUser().getRecord().getValue('u_is_manager'); if (!isManager) { qc.addOrCondition('u_visibility', 'nonmanager'); gs.getSession().putClientData('navQuery', 'nonmanager'); } else { qc.addOrCondition('u_visibility', 'manager'); gs.getSession().putClientData('navQuery', 'manager'); } } else { qc.addOrCondition('u_visibility', navQuery); } } ### Equivalente com escopo Para usar o método getSession() em uma aplicação com escopo, use o método com escopo correspondente: [getSession()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetSession "Obtém uma referência à sessão atual do Glide."). ## GlideSystem -- getSessionID() {#ariaid-title61} Retorna o ID da sessão GlideSession. {#r_GS-getSessionID__table_z31_t3b_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 119. Parâmetros] {#r_GS-getSessionID__table_z31_t3b_mt} {#r_GS-getSessionID__table_aj1_t3b_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | ID da sessão | [Tabela 120. Retorna] {#r_GS-getSessionID__table_aj1_t3b_mt} var gr_NOW = new GlideRecord('v_user_session'); var sessionId = gs.getSessionID(); gs.log("Session ID is: " + sessionId); Saída Session ID is: FEE589B3DB7EE4103DD9C39D139619D7 ### Equivalente com escopo Para usar o método getSessionID() em uma aplicação com escopo, use o método com escopo correspondente: [getSessionID](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetSessionID "Recupera o ID da sessão GlideSession."). ## GlideSystem - getStyle(cadeia de caracteres "tableName", cadeia de caracteres "fieldName", cadeia de caracteres "fieldValue") {#ariaid-title62} Retorna o estilo definido para a tabela, o campo e o valor do campo. {#r_GS-getStyle_S_S_S__table_pgz_rt1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | tableName | Cadeia de caracteres | Nome da tabela | | fieldName | Cadeia de caracteres | Nome do campo | | fieldValue | Cadeia de caracteres | Valor do campo | [Tabela 121. Parâmetros] {#r_GS-getStyle_S_S_S__table_pgz_rt1_mt} {#r_GS-getStyle_S_S_S__table_qgz_rt1_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Estilo do campo especificado. | [Tabela 122. Retorna] {#r_GS-getStyle_S_S_S__table_qgz_rt1_mt} var returnString = gs.getStyle('', '', ''); gs.print(returnString); ## GlideSystem -- getTimeFormat() {#ariaid-title63} Retorna o formato de hora associado ao usuário atual. {#GS-getTimeFormat_S__table_j1c_bht_q5b__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 123. Parâmetros] {#GS-getTimeFormat_S__table_j1c_bht_q5b} {#GS-getTimeFormat_S__table_k1c_bht_q5b__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O formato de hora associado ao usuário atual. | [Tabela 124. Retorna] {#GS-getTimeFormat_S__table_k1c_bht_q5b} var userTimeFormat = gs. getTimeFormat(); gs.info(userTimeFormat); Saída: HH:mm:ss ## GlideSystem -- getUser() {#ariaid-title64} Retorna uma referência ao objeto de usuário para o usuário atual. {#r_GS-getUser__table_ed5_hjb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 125. Parâmetros] {#r_GS-getUser__table_ed5_hjb_mt} {#r_GS-getUser__table_fd5_hjb_mt__entry__2} | Tipo | Descrição | |-|-| | GlideUser | Referência a um objeto de usuário para o usuário atual. | [Tabela 126. Retorna] {#r_GS-getUser__table_fd5_hjb_mt} O exemplo a seguir mostra como obter o objeto de usuário atual. var user = gs.getUser(); gs.print ("The current user is: " + user); Saída: The current user is: com.glide.sys.User@db5dd9 O exemplo a seguir mostra como verificar se o usuário atual tem a função workflow_admin. var role = gs.getUser().hasRole('workflow_admin'); gs.print ("Does the current user have the workflow_admin role: " + role); Saída: Does the current user have the workflow_admin role: true ### Equivalente com escopo Para usar o método getUser() em uma aplicação com escopo, use o método com escopo correspondente: [getUser()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetUser "Retorna uma referência ao objeto GlideUser com escopo para o usuário atual."). ## GlideSystem -- getUserDisplayName() {#ariaid-title65} Obtém o nome de exibição do usuário atual. {#r_GS-getUserDisplayName__table_mvv_vjb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 127. Parâmetros] {#r_GS-getUserDisplayName__table_mvv_vjb_mt} {#r_GS-getUserDisplayName__table_nvv_vjb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O campo de nome do usuário atual. Por exemplo, este método retorna Abel Tuter em vez de abel.tuter. | [Tabela 128. Retorna] {#r_GS-getUserDisplayName__table_nvv_vjb_mt} Este exemplo obtém o nome de exibição do usuário atual. gs.info(gs.getUserDisplayName()); Saída: System Administrator ### Equivalente com escopo Para usar o método getUserDisplayName() em uma aplicação com escopo, use o método com escopo correspondente: [getUserDisplayName()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetUserDisplayName "Obtém o nome de exibição do usuário atual."). ## GlideSystem -- getUserID() {#ariaid-title66} Retorna o sys_id do usuário atual. {#r_GS-getUserID__table_o5c_kkb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 129. Parâmetros] {#r_GS-getUserID__table_o5c_kkb_mt} {#r_GS-getUserID__table_p5c_kkb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Sys_id do usuário atual. | [Tabela 130. Retorna] {#r_GS-getUserID__table_p5c_kkb_mt} Este exemplo obtém o sys_id do usuário atual. var currentUserId = gs.getUserID(); gs.print("Current user ID: " + currentUserId); Saída: Current user ID: 6816f79cc0a8016401c5a33be04be441 ### Equivalente com escopo {#r_GS-getUserID__section_uw1_nrs_mcb} Para usar o método getUserID() em uma aplicação com escopo, use o método com escopo correspondente: [getUserID()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetUserID "Obtém o sys_id do usuário atual."). ## GlideSystem -- getUserName() {#ariaid-title67} Retorna o nome de usuário do usuário atual. {#r_GS-getUserName__table_apf_plb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 131. Parâmetros] {#r_GS-getUserName__table_apf_plb_mt} {#r_GS-getUserName__table_bpf_plb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | O nome de usuário do usuário atual. Por exemplo, este método retorna abel.tuter em vez de Abel Tuter. | [Tabela 132. Retorna] {#r_GS-getUserName__table_bpf_plb_mt} Este exemplo obtém o nome de usuário do usuário atual e um usuário representado. var user = gs.getUserName(); gs.info("The current user name is: " + user); var impUser = new GlideImpersonate(); impUser.impersonate("62826bf03710200044e0bfc8bcbe5df1"); var user2 = gs.getUserName(); gs.info("The impersonated user name is: " + user2); Saída: The current user name is: admin The impersonated user name is: abel.tuter ### Equivalente com escopo {#r_GS-getUserName__section_cm2_prs_mcb} Para usar o método getUserName() em uma aplicação com escopo, use o método com escopo correspondente: [getUserName()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemGetUserName "Retorna o nome de usuário do usuário atual."). ## GlideSystem -- getUserNameByUserID(cadeia de caracteres user_id) {#ariaid-title68} Retorna o nome de exibição do usuário com base em um nome de login de usuário fornecido. {#r_GS-getUserNameByUserID_S__table_op4_1mb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | user_id | Cadeia de caracteres | Nome de login do usuário do qual o nome de exibição associado será recuperado. | [Tabela 133. Parâmetros] {#r_GS-getUserNameByUserID_S__table_op4_1mb_mt} {#r_GS-getUserNameByUserID_S__table_pp4_1mb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Nome de exibição do usuário solicitado. Nota: Se este método não puder encontrar um usuário com o ID solicitado, ele retornará o valor de entrada fornecido. | [Tabela 134. Retorna] {#r_GS-getUserNameByUserID_S__table_pp4_1mb_mt} O exemplo a seguir mostra como obter o nome de exibição do usuário especificado. var displayName = gs.getUserNameByUserID('abel.tuter'); gs.info('User display name is: ' + displayName); Saída: User display name is: Abel Tuter ## GlideSystem -- getXMLNodeList(cadeia de caracteres xml) {#ariaid-title69} Constrói uma matriz de todos os nós e valores em um documento XML. {#r_GS-getXMLNodeList_S__table_tsq_jnb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | xml | Cadeia de caracteres | Documento XML a ser analisado. | [Tabela 135. Parâmetros] {#r_GS-getXMLNodeList_S__table_tsq_jnb_mt} {#r_GS-getXMLNodeList_S__table_usq_jnb_mt__entry__2} | Tipo | Descrição | |-|-| | Lista de matrizes | Lista de nomes e valores do nó XML mais externo. | [Tabela 136. Retorna] {#r_GS-getXMLNodeList_S__table_usq_jnb_mt} O exemplo a seguir mostra como obter uma lista de nós XML e seus valores associados em uma lista de matrizes. var nodeList = gs.getXMLNodeList("ToveJaniReminderDon't forget me this weekend!"); gs.print ("The node contains: " + nodeList); Saída: The node contains: [to : Tove, from : Jani, heading : Reminder, body : Don't forget me this weekend!] ## GlideSystem -- getXMLText(cadeia de caracteres xml, cadeia de caracteres xpathQuery) {#ariaid-title70} Retorna o texto XML do primeiro elemento na cadeia de caracteres XML que corresponde à consulta XPath. {#r_GS-getXMLText_S_S__table_zmk_lmb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | xml | Cadeia de caracteres | Cadeia de caracteres XML a ser pesquisada. | | xpathQuery | Cadeia de caracteres | Consulta XPath a ser correspondida. | [Tabela 137. Parâmetros] {#r_GS-getXMLText_S_S__table_zmk_lmb_mt} {#r_GS-getXMLText_S_S__table_ank_lmb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Nó XML que corresponde aos parâmetros de pesquisa. | [Tabela 138. Retorna] {#r_GS-getXMLText_S_S__table_ank_lmb_mt} O exemplo a seguir mostra como obter o valor de um elemento XML especificado em um nó passado. var nodeList = gs.getXMLText("ToveJaniReminderDon't forget me this weekend!", "//from"); gs.print ("The from element contains: " + nodeList); Saída: The from element contains: Jani ## GlideSystem -- hasRole(cadeia de caracteres roleName) {#ariaid-title71} Determina se o usuário atual tem pelo menos uma das funções aprovadas. {#r_GS-hasRole_S__table_byk_5nb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | roleName | Cadeia de caracteres | Lista separada por vírgulas de funções. | [Tabela 139. Parâmetros] {#r_GS-hasRole_S__table_byk_5nb_mt} {#r_GS-hasRole_S__table_cyk_5nb_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se o usuário atual tem pelo menos uma das funções especificadas. Valores possíveis: * verdadeiro: o usuário tem pelo menos uma das funções aprovadas. Também retornará verdadeiro se o usuário tiver a função de administrador. * falso: o usuário não tem nenhuma das funções passadas. {#r_GS-hasRole_S__ul_twc_kpj_z4b} | [Tabela 140. Retorna] {#r_GS-hasRole_S__table_cyk_5nb_mt} O exemplo a seguir mostra como verificar se o usuário atual tem a função admin ou groups_admin. if (!gs.hasRole("admin, groups_admin") && gs.getSession().isInteractive()) { var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups... qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group } ### Equivalente com escopo {#r_GS-hasRole_S__section_ex4_rrs_mcb} Para usar o método hasRole() em uma aplicação com escopo, use o método com escopo correspondente: [hasRole()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemHasRole_Object "Determina se o usuário atual tem a função especificada."). ## GlideSystem - hasRoleInGroup (objeto roleName, grupo de objetos) {#ariaid-title72} Determina se o usuário atual tem a função especificada em um grupo especificado. {#r_GS-hasRoleInGroup_O_O__table_dys_m4b_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | roleName | Objeto | Nome da função. | | grupo | Objeto | Sys_id do grupo para verificar a função especificada. | [Tabela 141. Parâmetros] {#r_GS-hasRoleInGroup_O_O__table_dys_m4b_mt} {#r_GS-hasRoleInGroup_O_O__table_eys_m4b_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se o usuário atual tem a função especificada no grupo especificado. Valores possíveis: * verdadeiro: o usuário conectado está atribuído à função especificada no grupo especificado. * falso: o usuário conectado não está atribuído à função especificada no grupo especificado. {#r_GS-hasRoleInGroup_O_O__ul_twc_kpj_z4b} | [Tabela 142. Retorna] {#r_GS-hasRoleInGroup_O_O__table_eys_m4b_mt} O exemplo a seguir mostra como verificar se o grupo sys_user_group tem a função role_name. var group = new GlideRecord('sys_user_group'); group.addQuery('name', 'GROUP_NAME'); group.setLimit(1); group.query(); if (group.next()) { if (gs.hasRoleInGroup('role_name', group)) { gs.print('User has role in group'); } else { gs.print('User does NOT have role in group'); } } ## GlideSystem - hoursAgo(Número de horas) {#ariaid-title73} Retorna uma data e hora para o número especificado de horas atrás. O valor retornado é ajustado para o fuso horário da instância. {#r_GS-hoursAgo_N__table_vrq_j1x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | horas | Número | Número de horas atrás. | [Tabela 143. Parâmetros] {#r_GS-hoursAgo_N__table_vrq_j1x_mt} {#r_GS-hoursAgo_N__table_wrq_j1x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora UTC para o número especificado de horas atrás. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 144. Retorna] {#r_GS-hoursAgo_N__table_wrq_j1x_mt} var currentDateTime = gs.hoursAgo(0); gs.info("Current date/time: " + currentDateTime); var agoDateTime = gs.hoursAgo(1); gs.info("Ago date/time: " + agoDateTime); Saída Current date/time: 2021-03-17 20:53:25 Ago date/time: 2021-03-17 19:53:25 ### Equivalente com escopo {#r_GS-hoursAgo_N__section_usc_xrs_mcb} Para usar o método hoursAgo() em uma aplicação com escopo, use o método com escopo correspondente: [hoursAgo()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-hoursAgo_N "Retorna a data e a hora de um número especificado de horas atrás."). ## GlideSystem - hoursAgoEnd(Número de horas) {#ariaid-title74} Retorna uma data e hora para o fim da hora para o número especificado de horas atrás. O valor retornado é ajustado para o fuso horário da instância. {#r_GS-hoursAgoEnd_N__table_ddc_v1x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | horas | Número (inteiro) | Número de horas atrás. | [Tabela 145. Parâmetros] {#r_GS-hoursAgoEnd_N__table_ddc_v1x_mt} {#r_GS-hoursAgoEnd_N__table_edc_v1x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora UTC para o fim do número especificado de horas atrás. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 146. Retorna] {#r_GS-hoursAgoEnd_N__table_edc_v1x_mt} var currentDateTime = gs.hoursAgoEnd(0); gs.print("Current date/time: " + currentDateTime); var agoDateTime = gs.hoursAgoEnd(1); gs.print("Ago date/time: " + agoDateTime); Saída Current date/time: 2021-03-17 20:59:59 Ago date/time: 2021-03-17 19:59:59 ### Equivalente com escopo Para usar o método hoursAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: [hoursAgoEnd()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-hoursAgoEnd_N "Retorna a data e a hora do fim da hora há um número especificado de horas."). ## GlideSystem - hoursAgoStart(Número de horas) {#ariaid-title75} Retorna uma data e hora para o início da hora para o número especificado de horas atrás. O valor retornado é ajustado para o fuso horário da instância. {#r_GS-hoursAgoStart_N__table_wwb_xbx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | horas | Número | Número de horas atrás. | [Tabela 147. Parâmetros] {#r_GS-hoursAgoStart_N__table_wwb_xbx_mt} {#r_GS-hoursAgoStart_N__table_xwb_xbx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora UTC para o fim do número especificado de horas atrás. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 148. Retorna] {#r_GS-hoursAgoStart_N__table_xwb_xbx_mt} var currentDateTime = gs.hoursAgoStart(0); gs.print("Current date/time: " + currentDateTime); var agoDateTime = gs.hoursAgoStart(1); gs.print("Ago date/time: " + agoDateTime); Saída Current date/time: 2021-03-17 20:00:00 Ago date/time: 2021-03-17 19:00:00 ### Equivalente com escopo Para usar o método hoursAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: [hoursAgoStart()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-hoursAgoStart_N "Retorna a data e a hora do início da hora há um número especificado de horas."). ## GlideSystem - isFirstDayOfMonth(Data do objeto) {#ariaid-title76} Verifica se a data no objeto de data especificado é o primeiro dia do mês. {#r_GS-isFirstDayOfMonth_O__table_pyc_x3x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Objeto | Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate. | [Tabela 149. Parâmetros] {#r_GS-isFirstDayOfMonth_O__table_pyc_x3x_mt} {#r_GS-isFirstDayOfMonth_O__table_qyc_x3x_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a data no objeto de data especificado é o primeiro dia do mês. Valores possíveis: * verdadeiro: primeiro dia do mês. * falso: não é o primeiro dia do mês. {#r_GS-isFirstDayOfMonth_O__ul_twc_kpj_z4b} | [Tabela 150. Retorna] {#r_GS-isFirstDayOfMonth_O__table_qyc_x3x_mt} Este exemplo mostra como determinar se a data no objeto de data especificado é o primeiro dia do mês. var gdt = new GlideDateTime(); gdt.setValue('2021-04-01 12:00:00'); var currentDay = gs.isFirstDayOfMonth(gdt); gs.print("First day of month: " + currentDay); gdt.setValue('2021-04-21 12:00:00'); var currentDay = gs.isFirstDayOfMonth(gdt); gs.print("First day of month: " + currentDay); Saída First day of month: true First day of month: false ## GlideSystem - isFirstDayOfWeek(Data do objeto) {#ariaid-title77} Verifica se a data no objeto de data especificado é o primeiro dia da semana. Este método usa o padrão ISO de segunda-feira como o primeiro dia da semana. {#r_GS-isFirstDayOfWeek_O__table_dw2_hjx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Objeto | Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate. | [Tabela 151. Parâmetros] {#r_GS-isFirstDayOfWeek_O__table_dw2_hjx_mt} {#r_GS-isFirstDayOfWeek_O__table_ew2_hjx_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a data no objeto de data atual é o primeiro dia da semana (segunda-feira). Valores possíveis: * verdadeiro: primeiro dia da semana. * falso: não é o primeiro dia da semana. | [Tabela 152. Retorna] {#r_GS-isFirstDayOfWeek_O__table_ew2_hjx_mt} Este exemplo mostra como determinar se a data no objeto de data especificado é o primeiro dia da semana. var gdt = new GlideDateTime(); gdt.setValue('2021-03-02 12:00:00'); var currentDay = gs.isFirstDayOfWeek(gdt); gs.info("First day of week: " + currentDay); gdt.setValue('2021-03-22 12:00:00'); var currentDay = gs.isFirstDayOfWeek(gdt); gs.info("First day of week: " + currentDay); Saída First day of week: false First day of week: true ## GlideSystem - isFirstDayOfYear(Data do objeto) {#ariaid-title78} Verifica se a data no objeto de data especificado é o primeiro dia do ano. {#r_GS-isFirstDayOfYear_O__table_urv_sjx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Objeto | Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate. | [Tabela 153. Parâmetros] {#r_GS-isFirstDayOfYear_O__table_urv_sjx_mt} {#r_GS-isFirstDayOfYear_O__table_vrv_sjx_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a data no objeto de data especificado é o primeiro dia do ano. Valores possíveis: * verdadeiro: primeiro dia do ano. * falso: não é o primeiro dia do ano. {#r_GS-isFirstDayOfYear_O__ul_twc_kpj_z4b} | [Tabela 154. Retorna] {#r_GS-isFirstDayOfYear_O__table_vrv_sjx_mt} Este exemplo mostra como determinar se a data no objeto de data especificado é o primeiro dia do ano. var gdt = new GlideDateTime(); gdt.setValue('2020-12-31 12:00:00'); var currentDay = gs.isFirstDayOfYear(gdt); gs.info("First day of year: " + currentDay); gdt.setValue('2021-01-01 12:00:00'); var currentDay = gs.isFirstDayOfYear(gdt); gs.info("First day of year: " + currentDay); Saída First day of year: false First day of year: true ## GlideSystem -- isInteractive() {#ariaid-title79} Verifica se a sessão atual é interativa. Um exemplo de uma sessão interativa é quando um usuário faz login usando a tela de login. Um exemplo de uma sessão não interativa é usar uma solicitação SOAP para recuperar dados. {#r_GS-isInteractive__table_bc5_kpb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 155. Parâmetros] {#r_GS-isInteractive__table_bc5_kpb_mt} {#r_GS-isInteractive__table_cc5_kpb_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a sessão é interativa. Valores possíveis: * verdadeiro: a sessão é interativa. * falso: a sessão não é interativa. {#r_GS-isInteractive__ul_twc_kpj_z4b} | [Tabela 156. Retorna] {#r_GS-isInteractive__table_cc5_kpb_mt} if (!gs.hasRole('admin') && gs.isInteractive()) { var qc1 = current.addQuery('u_group', ''); var gra = new GlideRecord('sys_user_grmember'); gra.addQuery('user', gs.getUserID()); gra.query(); while (gra.next()) { qc1.addOrCondition('u_group', gra.group); } } ### Equivalente com escopo {#r_GS-isInteractive__section_kv3_zrs_mcb} Para usar o método isInteractive() em uma aplicação com escopo, use o método com escopo correspondente: [isInteractive()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemIsInteractive "Verifica se a sessão atual é interativa. Um exemplo de uma sessão interativa é quando um usuário faz login normalmente. Um exemplo de uma sessão não interativa é usar uma solicitação SOAP para recuperar dados."). ## GlideSystem - isLastDayofMonth(Data do objeto) {#ariaid-title80} Verifica se a data no objeto de data especificado é o último dia do mês. {#r_GS-isLastDayofMonth_O__table_g2y_ckx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Objeto | Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate. | [Tabela 157. Parâmetros] {#r_GS-isLastDayofMonth_O__table_g2y_ckx_mt} {#r_GS-isLastDayofMonth_O__table_h2y_ckx_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a data no objeto de data especificado é o último dia do mês. Valores possíveis: * verdadeiro: último dia do mês. * falso: não é o último dia do mês. {#r_GS-isLastDayofMonth_O__ul_twc_kpj_z4b} | [Tabela 158. Retorna] {#r_GS-isLastDayofMonth_O__table_h2y_ckx_mt} Este exemplo mostra como determinar se a data no objeto de data especificado é o último dia do mês. var gdt = new GlideDate(); gdt.setValue('2020-12-31 12:00:00'); var currentDay = gs.isLastDayOfMonth(gdt); gs.print("First day of year: " + currentDay); gdt.setValue('2021-01-01 12:00:00'); var currentDay = gs.isLastDayOfMonth(gdt); gs.print("First day of year: " + currentDay); Saída Last day of month: true Last day of month: false ## GlideSystem - isLastDayOfWeek(data do objeto) {#ariaid-title81} Verifica se a data no objeto de data especificado é o último dia da semana. Este método usa o padrão ISO de domingo sendo o último dia da semana. {#r_GS-isLastDayOfWeek_O__table_d55_nkx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Objeto | Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate. | [Tabela 159. Parâmetros] {#r_GS-isLastDayOfWeek_O__table_d55_nkx_mt} {#r_GS-isLastDayOfWeek_O__table_e55_nkx_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a data no objeto de data atual é o último dia da semana (domingo). Valores possíveis: * verdadeiro: último dia da semana. * falso: não é o último dia da semana. {#r_GS-isLastDayOfWeek_O__ul_asy_2gv_1pb} | [Tabela 160. Retorna] {#r_GS-isLastDayOfWeek_O__table_e55_nkx_mt} Este exemplo mostra como determinar se a data no objeto de data especificado é o último dia da semana. var gdt = new GlideDate(); gdt.setValue('2021-03-01 12:00:00'); var currentDay = gs.isLastDayOfWeek(gdt); gs.info("Last day of week: " + currentDay); gdt.setValue('2021-03-21 12:00:00'); var currentDay = gs.isLastDayOfWeek(gdt); gs.info("Last day of week: " + currentDay); Saída First day of week: false First day of week: true ## GlideSystem - isLastDayOfYear(Data do objeto) {#ariaid-title82} Verifica se a data no objeto de data especificado é o último dia do ano. {#r_GS-isLastDayOfYear_O__table_c2t_xkx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | data | Objeto | Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate. | [Tabela 161. Parâmetros] {#r_GS-isLastDayOfYear_O__table_c2t_xkx_mt} {#r_GS-isLastDayOfYear_O__table_d2t_xkx_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a data no objeto de data atual é o último dia do ano. Valores possíveis: * verdadeiro: último dia do ano. * falso: não é o último dia do ano. {#r_GS-isLastDayOfYear_O__ul_asy_2gv_1pb} | [Tabela 162. Retorna] {#r_GS-isLastDayOfYear_O__table_d2t_xkx_mt} Este exemplo mostra como determinar se a data no objeto de data especificado é o último dia do ano. var gdt = new GlideDateTime(); gdt.setValue('2020-12-31 12:00:00'); var currentDay = gs.isLastDayOfYear(gdt); gs.info("Last day of year: " + currentDay); gdt.setValue('2021-01-01 12:00:00'); var currentDay = gs.isLastDayOfYear(gdt); gs.info("Last day of year: " + currentDay); Saída Last day of year: true Last day of year: false ## GlideSystem - isLoggedIn() {#ariaid-title83} Determina se o usuário atual está conectado no momento. {#r_GS-isLoggedIn__table_jdh_5pb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 163. Parâmetros] {#r_GS-isLoggedIn__table_jdh_5pb_mt} {#r_GS-isLoggedIn__table_kdh_5pb_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se o usuário atual está conectado. Valores possíveis: * verdadeiro: o usuário está conectado. * falso: o usuário não está conectado. {#r_GS-isLoggedIn__ul_twc_kpj_z4b} | [Tabela 164. Retorna] {#r_GS-isLoggedIn__table_kdh_5pb_mt} Este exemplo mostra como determinar se o usuário atual está conectado. if(gs.isLoggedIn()) gs.info("Current user is logged in"); else gs.info("Current user is NOT logged in"); Saída Current user is logged in ### Equivalente com escopo Para usar o método isLoggedIn() em uma aplicação com escopo, use o método com escopo correspondente: [isLoggedIn()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemIsLoggedIn "Determina se o usuário atual está conectado no momento."). ## GlideSystem - isMobile() {#ariaid-title84} Determina se a solicitação veio de um dispositivo móvel. Você pode usar este método em condições de ação de IU e regras de negócio. {#r_GS-isMobile__table_gnw_lbz_bv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 165. Parâmetros] {#r_GS-isMobile__table_gnw_lbz_bv} {#r_GS-isMobile__table_hnw_lbz_bv__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a solicitação veio de um dispositivo móvel. Valores possíveis: * verdadeiro: dispositivo móvel. * falso: dispositivo não móvel. {#r_GS-isMobile__ul_twc_kpj_z4b} | [Tabela 166. Retorna] {#r_GS-isMobile__table_hnw_lbz_bv} Este exemplo mostra como determinar se o dispositivo atual é um dispositivo móvel. if(gs.isMobile()) gs.info("Submitted from mobile UI"); else gs.info("NOT submitted from mobile UI"); Saída Submitted from mobile UI ### Equivalente com escopo {#r_GS-isMobile__section_nwn_css_mcb} Para usar o método isMobile() em uma aplicação com escopo, use o método com escopo correspondente: [isMobile()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGS-isMobile "Você pode determinar se uma solicitação vem de um dispositivo móvel."). ## GlideSystem -- lastWeek() {#ariaid-title85} Retorna a data e a hora de uma semana atrás em GMT. {#r_GS-lastWeek__table_tsk_mcx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 167. Parâmetros] {#r_GS-lastWeek__table_tsk_mcx_mt} {#r_GS-lastWeek__table_usk_mcx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora de uma semana atrás. Formato: aaaa-MM-dd hh:mm:ss | [Tabela 168. Retorna] {#r_GS-lastWeek__table_usk_mcx_mt} Este exemplo mostra como obter a data que é uma semana a partir da data no objeto de data atual. var gdt = new GlideDateTime(); gdt.setValue('2021-03-22 01:00:00'); gs.info("Current date: " + gs.nowDateTime()); gs.info("One week earlier: " + gs.lastWeek()); Saída Current date: 2021-03-22 15:27:07 One week earlier: 2021-03-15 15:27:07 ## GlideSystem - log (mensagem de cadeia de caracteres, origem de cadeia de caracteres) {#ariaid-title86} Registra uma mensagem no log do sistema e a salva na tabela syslog. {#r_GS-log_S_S__table_opd_251_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | message | Cadeia de caracteres | Mensagem para registrar. | | origem | Cadeia de caracteres | Opcional. Origem da mensagem. | [Tabela 169. Parâmetros] {#r_GS-log_S_S__table_opd_251_mt} {#r_GS-log_S_S__table_ppd_251_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 170. Retorna] {#r_GS-log_S_S__table_ppd_251_mt} O exemplo a seguir mostra como publicar uma entrada de log usando constantes e variáveis. var count = new GlideAggregate('incident'); count.addQuery('active', 'true'); count.addAggregate('COUNT', 'category'); count.query(); while (count.next()) { var category = count.category; var categoryCount = count.getAggregate('COUNT', 'category'); gs.log("The are currently " + categoryCount + " incidents with a category of " + category, "Incident Counter"); } ## GlideSystem - logError(cadeia de caracteres mensagem, cadeia de caracteres de origem) {#ariaid-title87} Registra um erro no log do sistema e o salva na tabela syslog. {#r_GS-logError_S_S__table_ipq_q51_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | message | Cadeia de caracteres | Mensagem de erro a ser registrada. | | origem | Cadeia de caracteres | Opcional. Origem da mensagem. | [Tabela 171. Parâmetros] {#r_GS-logError_S_S__table_ipq_q51_mt} {#r_GS-logError_S_S__table_jpq_q51_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 172. Retorna] {#r_GS-logError_S_S__table_jpq_q51_mt} O exemplo a seguir registrará em log um erro se a tabela Incidente não puder ser encontrada. var gr_NOW = new GlideRecord("incident"); if (!gr_NOW.isValid()) { gs.logError('Incident table could not be found'); return; } ## GlideSystem - logWarning(cadeia de caracteres mensagem, cadeia de caracteres de origem) {#ariaid-title88} Registra um aviso no log do sistema e o salva na tabela syslog. {#r_GS-logWarning_S_S__table_rvs_z51_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | message | Cadeia de caracteres | Mensagem para registrar. | | origem | Cadeia de caracteres | Opcional. Origem da mensagem. | [Tabela 173. Parâmetros] {#r_GS-logWarning_S_S__table_rvs_z51_mt} {#r_GS-logWarning_S_S__table_svs_z51_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 174. Retorna] {#r_GS-logWarning_S_S__table_svs_z51_mt} O exemplo a seguir registrará em log um aviso se a tabela Incidente não puder ser encontrada. var gr_NOW = new GlideRecord("incident"); if (!gr_NOW.isValid()) { gs.logWarning('Incident table could not be found'); return; } ## GlideSystem - minutosAgo (Número de minutos) {#ariaid-title89} Retorna uma data e hora para o número especificado de minutos atrás. {#r_GS-minutesAgo_N__table_gnh_vcx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | minutos | Número | Número de minutos no passado a serem retornados. | [Tabela 175. Parâmetros] {#r_GS-minutesAgo_N__table_gnh_vcx_mt} {#r_GS-minutesAgo_N__table_hnh_vcx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora UTC para o número especificado de minutos atrás. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 176. Retorna] {#r_GS-minutesAgo_N__table_hnh_vcx_mt} Este exemplo mostra como usar o métodominutesAgo() em uma chamada addQuery(). // Check to see if the user has failed to login too many times // when the limit is reached, lock the user out of the system // //Check failed logins in the last 15 minutes var now_GR = new GlideRecord('sysevent'); now_GR.addQuery('name', 'login.failed'); now_GR.addQuery('parm1', event.parm1.toString()); now_GR.addQuery('sys_created_on','>=', gs.minutesAgo(15)); now_GR.query(); var rowCount = now_GR.getRowCount(); if(rowCount >= 5){ var now_GR = new GlideRecord("sys_user"); now_GR.addQuery("user_name", event.parm1.toString()); now_GR.query(); if (now_GR.next()) { now_GR.locked_out = true; now_GR.update(); gs.log("User " + event.parm1 + " locked out due to too many invalid login attempts"); } } ## GlideSystem -- minutosAgoEnd(Número de minutos) {#ariaid-title90} Retorna uma data e hora para o fim do minuto há um determinado número de minutos. {#r_GS-minutesAgoEnd_N__table_fp2_hdx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | minutos | Número | Número inteiro de minutos atrás, como 5 ou 11. | [Tabela 177. Parâmetros] {#r_GS-minutesAgoEnd_N__table_fp2_hdx_mt} {#r_GS-minutesAgoEnd_N__table_gp2_hdx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT o número especificado de minutos atrás, no final do minuto (59 segundos). Formato: aaaa-mm-dd hh:mm:ss | [Tabela 178. Retorna] {#r_GS-minutesAgoEnd_N__table_gp2_hdx_mt} O exemplo a seguir exibe a data e hora atuais e a data e hora 30 minutos atrás no final do minuto em GMT. var nowDateTime = new GlideDateTime(); gs.print("Now: " + nowDateTime); var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30); gs.print("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime); Saída Now: 2021-10-20 15:22:13 Thirty minutes ago end time: 2021-10-20 14:52:59 ### Equivalente com escopo Para usar o método minutosAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: [minutosAgoEnd()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-minutesAgoEnd_N "Retorna a data e a hora do fim do minuto há um número especificado de minutos."). ## GlideSystem -- minutosAgoStart(Número de minutos) {#ariaid-title91} Retorna uma data e hora para o início do minuto há um determinado número de minutos. {#r_GS-minutesAgoStart_N__table_xzm_tdx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | minutos | Número | Número inteiro de minutos atrás, como 15 ou 112. | [Tabela 179. Parâmetros] {#r_GS-minutesAgoStart_N__table_xzm_tdx_mt} {#r_GS-minutesAgoStart_N__table_yzm_tdx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT o número especificado de minutos atrás, no início do minuto. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 180. Retorna] {#r_GS-minutesAgoStart_N__table_yzm_tdx_mt} O exemplo a seguir exibe a data e hora atuais e a data e hora 30 minutos atrás no início do minuto em GMT. var nowDateTime = new GlideDateTime(); gs.info("Now: " + nowDateTime); var thirtyMinutesAgoDateTime = gs.minutesAgoStart(30); gs.info("Thirty minutes ago: " + thirtyMinutesAgoDateTime); Saída Now: 2021-10-20 14:56:18 Thirty minutes ago: 2021-10-20 14:26:00 ### Equivalente com escopo Para usar o método minutosAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: [minutosAgoStart()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-minutesAgoStart_N "Retorna a data e a hora do início do minuto há um número especificado de minutos."). ## GlideSystem - monthAgo(Número de meses) {#ariaid-title92} Retorna uma data e hora de um determinado número de meses atrás. {#r_GS-monthsAgo_N__table_phw_f2x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | meses | Número | Número inteiro de meses atrás. | [Tabela 181. Parâmetros] {#r_GS-monthsAgo_N__table_phw_f2x_mt} {#r_GS-monthsAgo_N__table_qhw_f2x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT do número especificado de meses atrás exatamente ao mesmo tempo. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 182. Retorna] {#r_GS-monthsAgo_N__table_qhw_f2x_mt} O exemplo a seguir exibe a data e hora atuais e a data e hora de um mês atrás ao mesmo tempo em GMT. var nowDateTime = new GlideDateTime(); gs.info("Now: " + nowDateTime); var oneMonthAgoDateTime = gs.monthsAgo(1); gs.info("One month ago: " + oneMonthAgoDateTime); Saída Now: 2021-10-20 15:29:15 One month ago: 2021-09-20 15:29:15 ### Equivalente com escopo Para usar o método monthAgo() em uma aplicação com escopo, use o método com escopo correspondente: [monthAgo()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-monthsAgo_N "Retorna a data e a hora de um número especificado de meses atrás."). ## GlideSystem - monthAgoEnd(Número de meses) {#ariaid-title93} Retorna uma data e hora do último dia do mês de um determinado número de meses. {#r_GS-monthsAgoEnd_N__table_nqx_r2x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | meses | Número | Número inteiro de meses, como 4 ou 16. | [Tabela 183. Parâmetros] {#r_GS-monthsAgoEnd_N__table_nqx_r2x_mt} {#r_GS-monthsAgoEnd_N__table_oqx_r2x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Fim GMT do mês do número especificado de meses atrás. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 184. Retorna] {#r_GS-monthsAgoEnd_N__table_oqx_r2x_mt} O exemplo a seguir exibe a data e hora atuais e a data e hora de dois meses atrás no final do mês útil. var nowDateTime = new GlideDateTime(); gs.info("Now: " + nowDateTime); var endOfTheMonthDateTime = gs.monthsAgoEnd(2); gs.info("End of the month: " + endOfTheMonthDateTime); Saída Now: 2021-10-20 19:23:35 End of the month: 2021-09-01 06:59:59 ## GlideSystem - monthAgoStart(Número de meses) {#ariaid-title94} Retorna uma data e hora para o início do mês de um determinado número de meses atrás. {#r_GS-monthsAgoStart_N__table_xmk_bfx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | meses | Número | Número inteiro de meses atrás, como 5 ou 14. | [Tabela 185. Parâmetros] {#r_GS-monthsAgoStart_N__table_xmk_bfx_mt} {#r_GS-monthsAgoStart_N__table_ymk_bfx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT do mês há o número especificado de meses. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 186. Retorna] {#r_GS-monthsAgoStart_N__table_ymk_bfx_mt} O exemplo a seguir exibe a data e hora atuais e a data e hora de três meses atrás em GMT. var nowDateTime = new GlideDateTime(); gs.info("Now: " + nowDateTime); var threeMonthsAgoDateTime = gs.monthsAgoStart(3); gs.info("Three months ago start date and time: " + threeMonthsAgoDateTime); Saída Now: 2021-10-20 15:05:27 Three months ago start date and time: 2021-07-01 07:00:00 ### Equivalente com escopo Para usar o método monthAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: [monthAgoStart()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-monthsAgoStart_N "Retorna a data e a hora do início do mês há um número especificado de meses."). ## GlideSystem - nil (objeto de objeto) {#ariaid-title95} Consulta um objeto e retorna verdadeiro se o objeto for nulo ou contiver uma cadeia de caracteres vazia. {#r_GS-nil_O__table_pwv_jv1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | obj | Objeto | O objeto a ser verificado. | [Tabela 187. Parâmetros] {#r_GS-nil_O__table_pwv_jv1_mt} {#r_GS-nil_O__table_qwv_jv1_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Verdadeiro se for cadeia de caracteres nula ou vazia; caso contrário, falso. | [Tabela 188. Retorna] {#r_GS-nil_O__table_qwv_jv1_mt} if ((!current.u_date1.nil()) && (!current.u_date2.nil())) { var start = current.u_date1.getGlideObject().getNumericValue(); var end = current.u_date2.getGlideObject().getNumericValue(); if (start > end) { gs.addInfoMessage('start must be before end'); current.u_date1.setError('start must be before end'); current.setAbortAction(true); } } ### Equivalente com escopo {#r_GS-nil_O__section_jzv_jss_mcb} Para usar o método nil() em uma aplicação com escopo, use o método com escopo correspondente: [nil()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemNil_Object "Consulta um objeto e retorna verdadeiro se o objeto for nulo, indefinido ou contiver uma cadeia de caracteres vazia."). ## GlideSystem -- now() {#ariaid-title96} Retorna a data atual em UTC. {#r_GS-now__table_w2g_nfx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 189. Parâmetros] {#r_GS-now__table_w2g_nfx_mt} {#r_GS-now__table_x2g_nfx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | A data atual no formato definido pelo usuário, em UTC. | [Tabela 190. Retorna] {#r_GS-now__table_x2g_nfx_mt} // When the user password changes then set the u_password_last_reset field // to now so we know when to force another update var now_GR = new GlideRecord("sys_user"); if (now_GR.get(event.parm1.toString())) { // Do something based on the Password Changing gs.log("The user password changed so do something else..."); now_GR.u_password_last_reset = gs.now(); now_GR.update(); } ## GlideSystem - nowNoTZ() {#ariaid-title97} Retorna a data e hora atuais no formato UTC. {#r_GS-nowNoTZ__table_j25_yfx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 191. Parâmetros] {#r_GS-nowNoTZ__table_j25_yfx_mt} {#r_GS-nowNoTZ__table_k25_yfx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | A data e hora UTC atuais | [Tabela 192. Retorna] {#r_GS-nowNoTZ__table_k25_yfx_mt} // When the user password changes then set the u_password_last_reset field // to now so we know when to force another update var now_GR = new GlideRecord("sys_user"); if (now_GR.get(event.parm1.toString())) { // Do something based on the Password Changing gs.log("The user password changed so do something else..."); now_GR.u_password_last_reset = gs.nowNoTZ(); now_GR.update(); } ## GlideSystem -- nowDateTime() {#ariaid-title98} Retorna a data e a hora atuais no formato definido pelo usuário. {#r_GS-nowDateTime__table_wwm_jgx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 193. Parâmetros] {#r_GS-nowDateTime__table_wwm_jgx_mt} {#r_GS-nowDateTime__table_xwm_jgx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Data e hora atuais no formato definido pelo usuário. Para obter mais informações sobre como definir o formato de data e hora do sistema, consulte [Campos de data e data/hora](https://www.servicenow.com/docs/access?context=r_UseDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). | [Tabela 194. Retorna] {#r_GS-nowDateTime__table_xwm_jgx_mt} var currentDateTime = gs.nowDateTime(); gs.print("Current date/time: " + currentDateTime); Saída Current date/time: 2021-03-17 14:04:02 Ao definir uma variável em um script de fluxo de trabalho para a data e hora atuais, use o método setDisplayValue(). O script a seguir define a variável de fluxo de trabalho end_date com a data e hora atuais. current.variables.end_date.setDisplayValue(gs.nowDateTime()); ## GlideSystem -- nowGlideDateTime() {#ariaid-title99} Obtém um objeto GlideDateTime com a data e hora atuais. Depois de obter um objeto GlideDateTime com a data e a hora atuais, você pode usar os métodos GlideDateTime para executar operações de data e hora, como cálculos de data e hora, formatação de data e hora ou conversão entre formatos de data e hora. {#r_GS-nowGlideDateTime__table_v4b_nyv_v1b__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 195. Parâmetros] {#r_GS-nowGlideDateTime__table_v4b_nyv_v1b} {#r_GS-nowGlideDateTime__table_w4b_nyv_v1b__entry__2} | Tipo | Descrição | |-|-| | Objeto | Objeto GlideDateTime com a data e hora atuais no formato GMT. | [Tabela 196. Retorna] {#r_GS-nowGlideDateTime__table_w4b_nyv_v1b} Define o campo u_target_date com a data e hora atuais no formato GMT. current.u_target_date = gs.nowGlideDateTime(); ## GlideSystem - imprimir (cadeia de caracteres mensagem) {#ariaid-title100} Grava uma mensagem no log do sistema. Este método não grava a mensagem na tabela syslog, a menos que a depuração tenha sido ativada. {#r_GS-print_S__table_mkj_yv1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | message | Cadeia de caracteres | A mensagem a ser registrada | [Tabela 197. Parâmetros] {#r_GS-print_S__table_mkj_yv1_mt} {#r_GS-print_S__table_nkj_yv1_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 198. Retorna] {#r_GS-print_S__table_nkj_yv1_mt} var rec = new GlideRecord('incident'); rec.addQuery('active',false); rec.query(); while (rec.next()) { gs.print('Inactive incident ' + rec.number + ' deleted'); rec.deleteRecord(); } ## GlideSystem - trimestresAgo (Número trimestres) {#ariaid-title101} Retorna uma data e hora de um determinado número de trimestres atrás. {#r_GS-quartersAgo_N__table_i12_zgx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | trimestres | Número | Número inteiro dos trimestres anteriores. | [Tabela 199. Parâmetros] {#r_GS-quartersAgo_N__table_i12_zgx_mt} {#r_GS-quartersAgo_N__table_j12_zgx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT do trimestre que era o número especificado de trimestres atrás. Formato: aaaa-mm-dd hh:mm:ss | [Tabela 200. Retorna] {#r_GS-quartersAgo_N__table_j12_zgx_mt} O exemplo a seguir exibe a data e hora atuais e a data e hora de quatro trimestres atrás ao mesmo tempo. var nowDateTime = new GlideDateTime(); gs.print("Now: " + nowDateTime); var fourQuartersAgoDateTime = gs.quartersAgo(4); gs.print("Four quarters ago: " + fourQuartersAgoDateTime); Saída Now: 2021-10-20 16:27:32 Four quarters ago: 2020-10-20 16:27:32 ## GlideSystem - trimestresAgoEnd(Número trimestres) {#ariaid-title102} Retorna uma data e hora para o último dia do trimestre, para um número especificado de trimestres atrás. {#r_GS-quartersAgoEnd_N__table_kbb_lhx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | trimestres | Número | Um número inteiro de trimestres | [Tabela 201. Parâmetros] {#r_GS-quartersAgoEnd_N__table_kbb_lhx_mt} {#r_GS-quartersAgoEnd_N__table_lbb_lhx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Fim GMT do trimestre que era o número especificado de trimestres atrás, no formato aaaa-mm-dd hh:mm:ss | [Tabela 202. Retorna] {#r_GS-quartersAgoEnd_N__table_lbb_lhx_mt} ### Equivalente com escopo Para usar o método trimestresAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: [trimestresAgoEnd()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-quartersAgoEnd_N "Retorna a data e a hora do último dia do trimestre para um número especificado de trimestres atrás."). ## GlideSystem - trimestresAgoInício(Número trimestres) {#ariaid-title103} Retorna uma data e hora para o primeiro dia do trimestre, para um número especificado de trimestres atrás. {#r_GS-quartersAgoStart_N__table_cmq_5hx_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | trimestres | Número | Um número inteiro de trimestres | [Tabela 203. Parâmetros] {#r_GS-quartersAgoStart_N__table_cmq_5hx_mt} {#r_GS-quartersAgoStart_N__table_dmq_5hx_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Fim GMT do mês que era o número especificado de trimestres atrás, no formato aaaa-mm-dd hh:mm:ss | [Tabela 204. Retorna] {#r_GS-quartersAgoStart_N__table_dmq_5hx_mt} ### Equivalente com escopo Para usar o método trimestresAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: [trimestresAgoStart()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-quartersAgoStart_N "Retorna a data e a hora do primeiro dia do trimestre para um número especificado de trimestres atrás."). ## GlideSystem - setProperty(Chave de cadeia de caracteres, Valor de cadeia de caracteres, Descrição de cadeia de caracteres) {#ariaid-title104} Define a chave especificada para o valor especificado. Nota: Deve-se ter cuidado ao definir as propriedades do sistema (sys_properties) usando este método, pois ele causa uma limpeza de cache em todo o sistema. Cada limpeza pode causar degradação no sistema enquanto os caches são reconstruídos. Se um valor precisar ser atualizado com frequência, ele não deverá ser armazenado como uma propriedade do sistema. Em geral, você só deve colocar valores na tabela sys_properties que não mudam com frequência. {#r_GS-setProperty_S_S_S__table_cbs_vqx_fw__entry__3} | Nome | Tipo | Descrição | |-|-|-| | chave | Cadeia de caracteres | A chave da propriedade a ser definida. | | valor | Cadeia de caracteres | O valor da propriedade a ser definido. | | descrição | Cadeia de caracteres | Uma descrição da propriedade. | [Tabela 205. Parâmetros] {#r_GS-setProperty_S_S_S__table_cbs_vqx_fw} {#r_GS-setProperty_S_S_S__table_dbs_vqx_fw__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 206. Retorna] {#r_GS-setProperty_S_S_S__table_dbs_vqx_fw} gs.setProperty("glide.foo","bar","foo"); gs.info(gs.getProperty("glide.foo")); Saída: barra ### Equivalente com escopo {#r_GS-setProperty_S_S_S__section_rsz_rss_mcb} Para usar o método setProperty() em uma aplicação com escopo, use o método com escopo correspondente: [setProperty()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_SGSYS-setProperty_S_S_S "Define a chave especificada com o valor especificado se a propriedade estiver dentro do escopo do script."). ## GlideSystem -- setRedirect(Object URI) {#ariaid-title105} Define o URI de redirecionamento para esta transação, que determina a próxima página que o usuário verá. {#r_GS-setRedirect_O__table_x4z_cqb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | URI | Objeto | URI a ser definido como redirecionamento | [Tabela 207. Parâmetros] {#r_GS-setRedirect_O__table_x4z_cqb_mt} {#r_GS-setRedirect_O__table_y4z_cqb_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 208. Retorna] {#r_GS-setRedirect_O__table_y4z_cqb_mt} Este exemplo redireciona o usuário para um item do catálogo específico e passa o e-mail atual como um parâmetro. gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" + current.sys_id + "&sysparm_email=" + current.email) ### Equivalente com escopo {#r_GS-setRedirect_O__section_bjq_tss_mcb} Para usar o método setRedirect() em uma aplicação com escopo, use o método com escopo correspondente: [setRedirect()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemSetRedirect_Object "Define o URI de redirecionamento para esta transação, que determina a próxima página que o usuário verá."). ## GlideSystem -- setReturn(Object URI) {#ariaid-title106} Define o URI de retorno para esta transação. Isso determina para qual página o usuário será direcionado quando retornar do próximo formulário. {#r_GS-setReturn_O__table_if4_rqb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | URI | Objeto | URI a ser definido como o local de retorno. | [Tabela 209. Parâmetros] {#r_GS-setReturn_O__table_if4_rqb_mt} {#r_GS-setReturn_O__table_jf4_rqb_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 210. Retorna] {#r_GS-setReturn_O__table_jf4_rqb_mt} Este exemplo garante que o usuário retorne à página atual quando terminar com a próxima. gs.setReturn (current.getLink(true)); ## GlideSystem -- tableExists(cadeia de caracteres "tableName") {#ariaid-title107} Determina se existe uma tabela de banco de dados na instância ServiceNow. {#r_GS-tableExists_S__table_e3j_gw1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | tableName | Cadeia de caracteres | Nome da tabela a ser verificada. | [Tabela 211. Parâmetros] {#r_GS-tableExists_S__table_e3j_gw1_mt} {#r_GS-tableExists_S__table_f3j_gw1_mt__entry__2} | Tipo | Descrição | |-|-| | Booliano | Sinalizador que indica se a tabela especificada existe na instância ServiceNow. Valores possíveis: * verdadeiro: a tabela existe * falso: a tabela não existe {#r_GS-tableExists_S__ul_fp4_xp4_krb} | [Tabela 212. Retorna] {#r_GS-tableExists_S__table_f3j_gw1_mt} Este exemplo mostra como verificar se as tabelas incidente e foo existem na instância ServiceNow. gs.info("Does the incident table exist? " + gs.tableExists("incident")); gs.info("Does the foo table exist? " + gs.tableExists("foo")); Saída Does the incident table exist? true Does the foo table exist? false ### Equivalente com escopo Para usar o método tableExists() em uma aplicação com escopo, use o método com escopo correspondente: [tableExists()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemTableExists_String "Determina se existe uma tabela de banco de dados."). ## GlideSystem - userID() {#ariaid-title108} Retorna o sys_id do usuário associado a esta sessão. Em vez disso, use getUserID(). {#r_GS-userID__table_wh2_drb_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 213. Parâmetros] {#r_GS-userID__table_wh2_drb_mt} {#r_GS-userID__table_xh2_drb_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Sys_id do usuário atual. | [Tabela 214. Retorna] {#r_GS-userID__table_xh2_drb_mt} O exemplo a seguir mostra como cancelar a atribuição de todos os registros de incidentes ativos atribuídos ao usuário atual. var incidentGR = new GlideRecord('incident'); incidentGR.addActiveQuery(); // Filter results to incidents assigned to the current user var currentUserSysId = gs.userID(); incidentGR.addQuery('assigned_to', currentUserSysId); incidentGR.query(); while (incidentGR.next()) { incidentGR.setValue('assigned_to', 'NULL'); incidentGR.update(); gs.info( 'Unassigned Incident: {0}: {1}', incidentGR.number.toString(), incidentGR.short_description.toString() ); } Saída: Unassigned Incident: INC0000057: Performance problems with wifi Unassigned Incident: INC0009001: Unable to post content on a Wiki page Unassigned Incident: INC0008111: ATF : Test1 ## GlideSystem - workflowFlush (objeto glideRecord) {#ariaid-title109} Exclui todos os registros de trabalho agendado abertos na tabela Programação (sys_trigger) para o GlideRecord especificado. {#r_GS-workflowFlush_O__table_p5r_rw1_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | glideRecord | Objeto | O GlideRecord | [Tabela 215. Parâmetros] {#r_GS-workflowFlush_O__table_p5r_rw1_mt} {#r_GS-workflowFlush_O__table_q5r_rw1_mt__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 216. Retorna] {#r_GS-workflowFlush_O__table_q5r_rw1_mt} ## GlideSystem - daysAgo(Número de anos) {#ariaid-title110} Obtém uma data e hora para um determinado número de anos atrás. {#r_GS-yearsAgo_N__table_o2l_23x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | anos | Número | Um número inteiro de anos | [Tabela 217. Parâmetros] {#r_GS-yearsAgo_N__table_o2l_23x_mt} {#r_GS-yearsAgo_N__table_p2l_23x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | Início GMT do ano que é o número especificado de anos atrás, no formato aaaa-mm-dd hh:mm:ss. | [Tabela 218. Retorna] {#r_GS-yearsAgo_N__table_p2l_23x_mt} ### Equivalente com escopo Para usar o métodoyearsAgo(Numberyears) em uma aplicação com escopo, use o método com escopo correspondente: [yearsAgo(Numberyears)](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#r_ScopedGlideSystemYearsAgo_N "Retorna uma data e hora de um determinado número de anos atrás."). ## GlideSystem - ontem () {#ariaid-title111} Retorna a hora de ontem (24 horas atrás). {#r_GS-yesterday__table_y4t_p3x_mt__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 219. Parâmetros] {#r_GS-yesterday__table_y4t_p3x_mt} {#r_GS-yesterday__table_z4t_p3x_mt__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | GMT para 24 horas atrás, no formato aaaa-mm-dd hh:mm:ss | [Tabela 220. Retorna] {#r_GS-yesterday__table_z4t_p3x_mt} ### Equivalente com escopo Para usar o método ontem() em uma aplicação com escopo, use o método com escopo correspondente: [ontem()](https://servicenow-prod.fluidtopics.net/_iJVYsenZzSNUjS0id_aVg#SGSYS-yesterday "Retorna a hora de ontem (24 horas atrás).").