Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOPublicado

AddMonth

AddMonth( <dData>, <nMeses> ) --> dData

Soma ou subtrai meses de uma data, preservando o tipo data.

DataCronológicasAritmética de datasFunções essenciais
01 · VISÃO GERAL

Visão geral

AddMonth() é útil quando a regra de negócio trabalha com vencimentos, projeções, parcelas ou validade em meses. Em vez de somar uma quantidade fixa de dias, a função desloca a data pelo número de meses informado, mantendo o resultado como data AdvPL.

02 · SINTAXE

Sintaxe

AddMonth( <dData>, <nMeses> ) --> dData

Parâmetros

dData
DataObrigatório

Data base usada no cálculo.

nMeses
NuméricoObrigatório

Quantidade de meses a acrescentar. Use valor negativo para voltar meses.

03 · EXEMPLO PRÁTICO

Calcular vencimento em três meses

#Include "TOTVS.ch"

User Function ExAddMonth()
    Local dVencimento := AddMonth(Date(), 3)

    MsgInfo("Vencimento: " + DToC(dVencimento))
Return
Resultado esperado

Mostra a data atual acrescida de três meses.

BOAS PRÁTICAS
  • Use AddMonth() quando a regra fala em meses, não em dias.
  • Para vencimentos comerciais, valide também feriados e dias úteis conforme a política da empresa.
  • Combine com DToS(), DToC() ou SToD() quando precisar gravar, exibir ou reconstruir datas.
ARMADILHAS COMUNS
  • Datas próximas ao fim do mês podem exigir validação da regra de negócio quando o mês de destino tiver menos dias.
  • Não substitua regras de calendário financeiro por uma soma simples de 30 dias.

Conteúdos relacionados

REFERÊNCIAS
  1. RXM Tecnologia. 20 funções AdvPL essenciais que todo dev Protheus usa. Maycon Motta da Silva, maio de 2026. Disponível em: https://rxmtecnologia.com.br/blog/20-funcoes-advpl-essenciais-que-todo-dev-protheus-usa.
Situação
Publicado
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha