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

AdjustDate

AdjustDate( <dData>, <nDias> ) --> dData

Calcula uma data considerando avanço ou recuo por dias úteis.

DataCronológicasDias úteisFunções essenciais
01 · VISÃO GERAL

Visão geral

AdjustDate() é usada quando a rotina precisa avançar ou retroceder uma data respeitando dias úteis. No uso cotidiano, aparece em vencimentos, prazos operacionais e cálculos que não devem cair em fins de semana ou feriados configurados.

02 · SINTAXE

Sintaxe

AdjustDate( <dData>, <nDias> ) --> dData

Parâmetros

dData
DataObrigatório

Data de partida do cálculo.

nDias
NuméricoObrigatório

Quantidade de dias úteis a deslocar. Use negativo para retroceder.

03 · EXEMPLO PRÁTICO

Calcular prazo em cinco dias úteis

#Include "TOTVS.ch"

User Function ExAdjustDate()
    Local dPrazo := AdjustDate(Date(), 5)

    MsgInfo("Prazo calculado: " + DToC(dPrazo))
Return
Resultado esperado

Calcula uma data cinco dias úteis após a data atual.

BOAS PRÁTICAS
  • Use para prazos que precisam considerar calendário útil.
  • Segundo a referência RXM, feriados dependem de configuração/tabela do ambiente; sem isso, a rotina tende a tratar principalmente fins de semana.
ARMADILHAS COMUNS
  • Não assuma calendário fiscal ou bancário sem validar a configuração do ambiente.
  • Quando o resultado impactar vencimento financeiro, documente a regra aplicada.

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