Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
Dica |
---|
Esse mesmo exemplo pode ser feito com o uso dos blocos de Incrementar dia na data, porém, informando um valor negativo "-16". |
Image Added
Figura 3 - Exemplo de uso do bloco Alterar data
Image Added
Figura 3.1 - Resultado exibido a partir das configurações da Figura 3
Informações | ||
---|---|---|
| ||