/
Alterar data (Cliente) / Update date (Client)

Alterar data (Cliente) / Update date (Client)

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