Faz uma alteração em um campo data de acordo com o valor informado. Caso o novo valor ultrapasse o limite do campo (ano, mês, dia...) que será alterado, a nova data se ajustará de acordo com o calendário correspondente.

Figura 1 - Bloco Alterar data

Compatibilidade

• Bloco servidor: cronapi.dateTime.Operations.updateNewDate()

Retorno

Retorna um objeto do tipo data com a nova data alterada.

Parâmetros

Data

Data a ser formatada.

• Posição: 1
• Inglês: Date
• Tipo: Data / Date
• Exemplo: retorno do bloco Obter data e hora atual

Atributo

Campo que será alterado na data.

• Posição: 2
• Inglês: Attribute
• Tipo: Texto / String
• Exemplo: "Ano"
• Opções: 
  • Ano: novo ano que será alterado na data.
  • Mês: novo mês que será alterado na data.
  • Dia: novo dia que será alterado na data.
  • Hora: nova hora que será alterada na data.
  • Minuto: novo minuto que será alterado na data.
  • Segundo: novo segundo que será alterado na data.
  • Milissegundo: novo milissegundo que será alterado na data.

Valor

Valor que será alterado.

• Posição: 3
• Inglês: Value
• Tipo: Inteiro / Integer
• Exemplo: 2024

Exemplo 1

Na função abaixo, por meio do bloco Alterar data, iremos alterar o campo hora da data informada para 18. O resultado de execução será impresso no console do depurador.

Figura 2 - Exemplo de uso do bloco Alterar data

Exemplo 2

Na função a seguir, vamos utilizar o bloco Alterar data para obter a data de 2 semanas atrás. Como mostra a Figura 3, a variável "data" recebe a data "30/08/2024". No parâmetro "Data" do bloco Alterar data é inserido a variável "data". Em seguida, no parâmetro "Atributo" é definido o campo que será alterado na data, para este exemplo vamos alterar o "dia". No parâmetro Valor, inserimos o bloco de operações aritméticas que realizará uma operação de subtração. Este bloco recebe como parâmetro a variável "data" e subtrai 16 dias, o que equivale a cerca de 2 semanas.

Posteriormente, o resultado da nova data será impresso no console do depurador. Ao subtrair 16 dias da data anterior (30 de agosto), a nova data foi atualizada para o dia 14 de agosto. Esta função pode ser utilizada, por exemplo, para filtrar em uma Fonte de dados os registros criados em semanas anteriores.

Figura 3 - Função que altera os dias de uma data