Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNPublicado

AddMonth

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

Suma o resta meses de una fecha manteniendo el tipo fecha.

FechaCronológicasAritmética de fechasFunciones esenciales
01 · DESCRIPCIÓN GENERAL

Descripción general

AddMonth() es útil cuando una regla de negocio trabaja con vencimientos, proyecciones, cuotas o validez medida en meses. En lugar de sumar una cantidad fija de días, desplaza la fecha por la cantidad de meses informada.

02 · SINTAXIS

Sintaxis

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

Parámetros

dData
DataObligatorio

Fecha base usada en el cálculo.

nMeses
NuméricoObligatorio

Cantidad de meses a agregar. Usa valor negativo para retroceder.

03 · EJEMPLO PRÁCTICO

Calcular vencimento em três meses

#Include "TOTVS.ch"

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

    MsgInfo("Vencimiento: " + DToC(dVencimiento))
Return
Resultado esperado

Muestra la fecha actual más tres meses.

BUENAS PRÁCTICAS
  • 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.
ERRORES COMUNES
  • 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.

Contenido relacionado

REFERENCIAS
  1. RXM Tecnologia. 20 funciones AdvPL esenciales que todo desarrollador Protheus usa. Mayo de 2026.
Estado
Publicado
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha