Navegação: Documentação > Bem-vindo à Central de Ajuda do Fusion > Formulários Dinâmicos e Externos - E-FORM > Configurando Campos
Configurando Campo do Tipo Fórmula (Data)
O campo do tipo Fórmula (Data) dispõe ao usuário fazer cálculos com datas.
Na criação de formulário, em Campos clique em Novo. Será exibida a seguinte tela:
Selecione Fórmula (Data) no campo Tipo.
Todos os campos são de preenchimento obrigatório. Estes estarão descritos a seguir e suas formas de preenchimento.
Item 1 - Fórmula: Insira a fórmula para calcular datas ou tempo. Não esqueça que a fórmula deve estar vinculada com o Tipo de Campo.
Caso em Tipo de Campo seja selecionado Inteiro, o valor da resposta será em numeral. Por exemplo: Inserindo a fórmula #dateDiff (${dataIda} ,${dataVolta}), o usuário visualiza a diferença entre duas datas, ou seja, o número inteiro em segundos da data de ida menos a data da volta.
Já se em Tipo de Campo for selecionado Texto, o valor da resposta será exibida em texto. Por exemplo: Utilizando o mesmo exemplo acima, onde o campo Fórmula é preenchido com #dateDiff (${dataIda} ,${dataVolta}), o usuário irá visualizar a diferença entre as duas datas em texto, como "3 meses e 12 dias e 14 horas e 30 segundos".
O dateDiff permite calcular diferenças entre duas datas.
Fórmulas: #dateDiff( ${campoData1} , ${ campoData2} )
Regra: ${campoData1} > ${campoData2}
Atenção! A expressão dateDiff só pode ser utilizada quando o Tipo de Campo for Inteiro ou Texto.
Se em Tipo de Campo for selecionado Data, o valor da resposta terá que ser em data. Por exemplo: Inserindo no campo Fórmula a expressão #dateAdd (${dataIda} ,${quantidadeDeDias}, day), o usuário irá visualizar a data da ida acrescentada do número de dias. Se em a data da ida for dia 10/05/2015 e a quantidade de dias for 5 dias, a resposta da expressão será 15/05/2015.
O dateAdd permite atribuir um valor a uma data. Esse valor pode ser dia, mês ou ano.
Fórmulas: #dateAdd( ${campoData1} , ${campoInteiro1}, type ) ...onde type = day/month/year
Regra: ${campoInteiro1} é do tipo número inteiro
Atenção! A expressão dateAdd pode ser utilizada apenas quando em Tipo de Campo for selecionada a opção Data e a expressão deve conter apenas campos do tipo Data e Inteiro.
Também é possível cobinar fórmulas, como nos exemplos abaixo:
#dateDiff ( #dateAdd( ${campoData1}, ${campoInteiro1}, month ) , ${campoData2} )
#dateDiff ( #dateAdd( ${campoData1}, ${campoInteiro1}, month ) , #dateAdd( ${campoData2}, ${campoInteiro2}, day ) )
Mas não se esqueça! Sempre se atente ao que foi selecionado em Tipo de Campo.
Item 2 - Somente dias úteis: Selecione Sim para definir se apenas os dias úteis serão considerados na fórmula. Ou seja, se a fórmula for, por exemplo, a data atual mais 20 dias, irão ser contados apenas os dias úteis. Sábados, domingos e feriados não são inclusos. Selecionando Não, serão considerados todos os dias corridos.
Item 3 - Tipo de Campo: Como citado acima, informe como o resultado da expressão será informado ao usuário final. Escolha entre as opções Data, Inteiro ou Texto.
Atenção! Não é possível inserir na fórmula duas datas e selecionar no campo Tipo de Campo a opção Data.
A imagem a seguir exibe um exemplo de campo Tipo Fórmula (Data).