Compartilhar via

Funções EDate e EOMonth

  • Artigo

Aplica-se a: Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo

Adiciona ou subtrai meses a um valor de Data/Hora, com ajuste opcional para o dia do mês.

Descrição

As funções EDate e EOMonth movem uma Data/Hora para frente ou para trás em um número especificado de meses.

Após o ajuste do mês, EDate deixa a parte do dia inalterada, a menos que o novo valor ultrapasse o final do mês. Por exemplo, retroceder um mês em 31 de julho resulta em 30 de junho. Use EDate para calcular datas de vencimento ou datas de conclusão que caem no mesmo dia do mês que a data de emissão.

Após o ajuste do mês, EOMonth muda a parte do dia para o último dia do mês resultante. Use EOMonth para calcular datas de vencimento ou datas de conclusão que se enquadram no último dia do mês. EOMonth pode ser usado para mover uma Data/Hora para o final do mês adicionando zero meses.

Todas as funções retornam um valor de Data. Nenhum componente de tempo é incluído, mesmo que um esteja presente na Data/Hora de entrada.

Consulte Trabalhar com datas e horas para obter mais informações.

Sintaxe

EDate( DateTime, NumberOfMonths )

  • DateTime - obrigatório. Valor de data/hora no qual operar.
  • NumberOfMonths - Obrigatório. Número de meses para adicionar ou subtrair a DateTime. Um valor positivo gera uma data futura, um valor negativo gera uma data passada e zero deixa toda a entrada DateTime inalterada.

EOMonth( DateTime, NumberOfMonths )

  • DateTime - obrigatório. Valor de data/hora no qual operar.
  • NumberOfMonths - Obrigatório. Número de meses para adicionar ou subtrair a DateTime. Um valor positivo gera uma data futura, um valor negativo gera uma data passada e zero altera a parte do dia da entrada DateTime para o fim do mês.

Exemplos

EDate

Fórmula Descrição Resultado
EDate( Date(2023,5,15) , 4 ) Adiciona quatro meses a 15 de maio de 2023, deixando a data inalterada. Data(2023,9,15)
EDate( Date(2023,5,15) , -1002 ) Subtrai 1.002 meses de 15 de maio de 2023, deixando a data inalterada. Data(1939,11,15)
EDate( Date(2023,5,15) , 0 ) Adiciona zero meses a 15 de maio de 2023, deixando o mês e o ano inalterados, e também deixa a data inalterada. Data(2023,5,15)
EDate( Date(2023,5,31) , 1 ) Adiciona um mês a 15 de maio de 2023, ajustando a data, pois junho não tem tantos dias quanto maio. Data(2023,6,30)

EOMonth

Fórmula Descrição Resultado
EOMonth( Date(2023,5,15); , 4 ) Adiciona quatro meses a 15 de maio de 2023, movendo a data para o final do mês. Data(2023,9,30)
EOMonth( Date(2023,5,15); , -1002 ) Subtrai 1.002 meses de 15 de maio de 2023, movendo a data para o final do mês resultante. Data(1939,11,30)
EOMonth( Date(2023,5,15); , 0 ) Adiciona zero meses a 15 de maio de 2023, deixando o mês e o ano inalterados, movendo a data para o final do mês não modificado. Data(2023,5,31)
EOMonth( Date(2023,5,31); , 1 ) Adiciona um mês a 15 de maio de 2023, movendo a data para o final do mês resultante. Data(2023,6,30)