Pacotes

datas

Datas em português: formatação, tempo relativo, dias úteis, feriados brasileiros e faixas.

bash

dataforge add datas


Versão	`1.0.0`
Licença	MIT
Dependências	nenhuma
Exporta	35 símbolos

Por que existe#

Somar um mês a 31 de janeiro tem que dar 28 (ou 29) de fevereiro. As contas passam pelo dia juliano, não por manipulação de texto — é o que faz esse caso sair certo.

Uso#

dataforge

adopt datas as D
out D.formatar(D.hoje(), "dd/MM/yyyy")     // 07/09/2026
out D.relativo(D.dias_atras(3))            // "há 3 dias"
out D.e_feriado(D.criar(2026, 12, 25))     // yes

API#

O que relay exporta — 35 símbolos:

dataforge

record Data
criar(ano, mes, dia)
hoje()
bissexto(ano)
dias_no_mes(ano, mes)
valida(d)
somar_dias(d, n)
somar_meses(d, n)
somar_anos(d, n)
dias_entre(a, b)
dias_atras(n)
dias_a_frente(n)
dia_da_semana(d)
e_fim_de_semana(d)
e_dia_util(d)
para_juliano(d)
de_juliano(jd)
pascoa(ano)
feriados(ano)
e_feriado(d)
nome_do_feriado(d)
dias_uteis_entre(a, b)
proximo_dia_util(d)
formatar(d, padrao := "dd/MM/yyyy")
por_extenso(d)
iso(d)
de_iso(texto)
de_br(texto)
relativo(d, referencia := void)
idade(nascimento, referencia := void)
faixa(inicio, fim)
MESES
MESES_CURTOS
DIAS
DIAS_CURTOS

Instalar#

bash

dataforge add datas
dataforge add datas@1.0.0
dataforge add datas@^1.0