dubacengold 26.1

Biblioteca Python para calculos de datas uteis com calendario ANBIMA.

dubacengold

Biblioteca Python para calculos de dias uteis usando o calendario ANBIMA.

O que a biblioteca faz

O pacote expoe funcoes simples para trabalhar com datas uteis:

• help(): mostra todos os comandos disponiveis na biblioteca.
• hoje(offset=0): retorna o D0 util atual. Se hoje cair em fim de semana ou feriado, usa o ultimo dia util anterior.
• hojenum(offset=0): retorna o serial numerico da data de hoje(), onde 1900-01-01 = 1.
• qdu(ordem, ano_mes): retorna o n-esimo dia util de um mes.
• qdtu(inicio, fim): conta os dias uteis entre duas datas, incluindo as pontas.
• qtdu(inicio, fim): alias de qdtu.

O calendario suportado cobre o intervalo de 2000-01-01 ate 2099-12-31.

Instalacao

python -m pip install dubacengold

Versoes suportadas

Suporte garantido para Python 3.8+.

Uso rapido

import dubacengold as du

du.help()
print(du.hoje())               # datetime do D0 util
print(du.hojenum())            # serial numerico do D0 util
print(du.hoje(-1))             # dia util anterior ao D0
print(du.qdu(5, "2026-04"))    # 5o dia util de abril de 2026
print(du.qdtu("2026-04-01", "2026-04-30"))
print(du.qtdu("2026-04-01", "2026-04-30"))

Entradas aceitas

• string no formato AAAA-MM-DD
• string no formato AAAA-MM para qdu
• datetime.date
• datetime.datetime

Regras importantes

• help() imprime a ajuda na tela.
• hoje() retorna um datetime em vez de date.
• qdtu() conta datas inicial e final quando elas forem dias uteis.
• Se inicio > fim, qdtu() retorna o valor negativo equivalente.
• qdu() gera erro quando a ordem pedida for maior que a quantidade de dias uteis do mes.
• Datas fora do intervalo suportado geram ValueError.

Ajuda embutida

import dubacengold as du

du.help()

A mensagem termina com:

Salmo 90:12 - Ensina-nos a contar os nossos dias, para que alcancemos coracao sabio.