Alterar data
Faz uma alteração na 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.
Parâmetros de Entrada
Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | data | Data a ser alterada |
| Parâmetro 2 | text | Tipo de valor que será alterado na data:
|
| Parâmetro 3 | int | Valor que será alterado |
Retorno
Retorna a representação de um objeto do tipo data.
Compatibilidade
Servidor
Cliente
Exemplo 1
A função abaixo (Figura 1) possui a variável "item" que recebe o valor do Bloco Alterar data, no parâmetro Data é passado a data atual, através o bloco Obter data e hora atual, em seguida, no parâmetro Atributo é definido o campo que será alterado na data (no caso iremos usar como exemplo o Ano) e inserimos o novo valor no parâmetro Valor. Esta nova data é exibida através do bloco Exibir Notificação (Figura 2).
Figura 1 - Bloco Alterar data
Figura 2 - Após clicar no botão, a função da Figura 1 é chamada e exibe a nova data na notificação
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 (11 de maio), a nova data foi atualizada em seu dia e mês, passando para 25 de abril.
Esta função pode ser utilizada, por exemplo, para filtrar em uma Fonte de dados os registros criados em semanas anteriores.
Esse mesmo exemplo pode ser feito com o uso dos blocos de Incrementar dia na data, porém, informando um valor negativo "-16".
Figura 3 - Exemplo de uso do bloco Alterar data
Figura 3.1 - Resultado exibido a partir das configurações da Figura 3