Faz uma alteração na data de acordo com o atributo informado.


Figura 1 - Bloco Alterar data

Compatibilidade

  • Bloco cliente: cronapi.dateTime.updateNewDate()

Retorno

Retorna um objeto do tipo data.

Parâmetros

Data

Data a ter o valor alterado.

  • Posição: 1
  • Inglês: Date
  • Tipo: Data / Date
  • Exemplo: 26/08/2024 

Atributo

Campo que será alterado na data.

  • Posição: 2
  • Inglês: Minutes to increse
  • Tipo: Texto / String
  • Exemplo: 10
  • 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

Novo valor para o atributo escolhido.

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

Exemplo 1

A função abaixo imprime, no console do navegador, o valor da data e hora atual com o valor do ano modificado.


Figura 2 - Função que altera o valor do ano de uma data


Figura 2.1 - Resultado da execução da função da figura 2

Exemplo 2

Na função abaixo 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 como parâmetro o bloco Alterar data. No parâmetro Data do bloco é passado a data atual, por meio do bloco Obter data e hora atual. 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 o bloco Obter dia da data, que obtém o dia da data atual, e subtrai 16 dias, o que equivale a cerca de 2 semanas.

Posteriormente, a data atual e o resultado da nova data serão impressas no console do depurador por meio dos blocos imprime (Figura 3.1). Ao subtrair 16 dias da data atual (30 de Agosto), a nova data foi atualizada para 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 - Exemplo de uso do bloco Alterar data


Figura 3.1 - Resultado exibido a partir das configurações da Figura 3

Nesta página