Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPAData e Hora

Obter Informações da Data

Obter Informações da Data

Obtém um conjunto completo de informações sobre uma data, incluindo dia, mês, ano, nome do dia da semana, limites da semana e do mês, e os primeiros e últimos dias úteis do mês. Ideal para montar relatórios, automatizar rotinas mensais ou aplicar regras baseadas no calendário sem precisar calcular cada valor manualmente.


Opções​

Usar uma data relativa à execução do robô?​

Define se a data utilizada será a data atual no momento da execução. Selecione Sim para usar a data atual automaticamente, ou Não para informar uma data específica.

Formato de entrada de data​

Selecione o formato da data informada: Tradicional (31/12/2024), Por extenso (31 de dezembro de 2024) ou Internacional (2024-12-31). Este campo é exibido apenas quando Usar uma data relativa à execução do robô? estiver definido como Não.

Data a ser formatada​

Informe a data da qual as informações serão extraídas. Este campo é exibido apenas quando Usar uma data relativa à execução do robô? estiver definido como Não.

Selecione a configuração de data​

Selecione uma ação Configurações de data e hora para que feriados e dias não úteis sejam considerados no cálculo dos dias úteis do mês. Este campo é opcional.

Idioma de saída​

Escolha o idioma das informações de saída — Português Brasil ou Inglês. Por exemplo, com Português Brasil o nome do mês é retornado como abril.

Retornos​

Código Javascript​

js
actions["id-da-acao"].monthName                 // nome do mês por extenso (Texto)
actions["id-da-acao"].month                     // número do mês (Número)
actions["id-da-acao"].year                      // ano (Número)
actions["id-da-acao"].day                       // dia do mês (Número)
actions["id-da-acao"].dayName                   // nome do dia da semana (Texto)
actions["id-da-acao"].firstDateOfTheWeek        // primeiro dia da semana da data (Texto)
actions["id-da-acao"].lastDateOfTheWeek         // último dia da semana da data (Texto)
actions["id-da-acao"].firstDateOfTheMonth       // primeiro dia do mês (Texto)
actions["id-da-acao"].lastDateOfTheMonth        // último dia do mês (Texto)
actions["id-da-acao"].firstWorkingDayOfTheMonth // primeiro dia útil do mês (Número)
actions["id-da-acao"].lastWorkingDayOfTheMonth  // último dia útil do mês (Número)

Seleção de campos​

  • monthName — nome do mês por extenso (Texto)
  • month — número do mês (Número)
  • year — ano (Número)
  • day — dia do mês (Número)
  • dayName — nome do dia da semana (Texto)
  • firstDateOfTheWeek — primeiro dia da semana da data (Texto)
  • lastDateOfTheWeek — último dia da semana da data (Texto)
  • firstDateOfTheMonth — primeiro dia do mês (Texto)
  • lastDateOfTheMonth — último dia do mês (Texto)
  • firstWorkingDayOfTheMonth — número do primeiro dia útil do mês (Número)
  • lastWorkingDayOfTheMonth — número do último dia útil do mês (Número)

Regras e Condições​

  • Quando Usar uma data relativa à execução do robô? for Não, a data informada deve corresponder ao formato selecionado em Formato de entrada de data.
  • O campo Selecione a configuração de data é opcional — sem ele, firstWorkingDayOfTheMonth e lastWorkingDayOfTheMonth correspondem ao primeiro e ao último dia do mês, sem considerar feriados.
  • As datas de semana e mês (firstDateOfTheWeek, lastDateOfTheWeek, firstDateOfTheMonth, lastDateOfTheMonth) são retornadas no formato Tradicional (31/12/2024).