Funções EDate e EOMonth

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Pages

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 num 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. Utilize EDate para calcular as datas de vencimento que calham no mesmo dia do mês da 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. Utilize EOMonth para calcular as datas de vencimento que calham 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 devolvem 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 – Necessário. Valor Data/Hora a utilizar.
  • NumberOfMonths — Required. Número de meses a adicionar ou subtrair a DateTime. Um valor positivo resulta numa data futura, um valor negativo resulta numa data passada e zero deixa toda a entrada DateTime inalterada.

EOMonth( DateTime, NumberOfMonths )

  • DateTime – Necessário. Valor Data/Hora a utilizar.
  • NumberOfMonths — Required. Número de meses a adicionar ou subtrair a DateTime. Um valor positivo resulta numa data futura, um valor negativo resulta numa data passada e zero altera a parte do dia da entrada DateTime para o final 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. Date(2023,9,15)
EDate( Date(2023,5,15) , -1002 ) Subtrai 1.002 meses a partir de 15 de maio de 2023, deixando a data inalterada. Date(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. Date(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. Date(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. Date(2023,9,30)
EOMonth( Date(2023,5,15); , -1002 ) Subtrai 1.002 meses a partir 15 de maio de 2023, movendo a data para o final do mês resultante. Date(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. Date(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. Date(2023,6,30)