/
Alterar data (Servidor) / Update date (Server)

Alterar data (Servidor) / Update date (Server)

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.

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

Nesta página