Home › Everyday Life › Count Brazil Working Days

Count Brazil Working Days

Counts authority-scope working and non-working dates in a range.

When to use

You need an auditable Brazil working-day count.

Do not use when: This is not a universal Brazilian private-employer calendar; state, municipal, sector, employer and private payroll schedules are not inferred.

Example user requests

Formula

for each included date: working_days += status.is_working_day

Normalize endpoints and count exact authority events over the declared weekday baseline.

Inputs

ParameterTypeUnitRequiredDescription
start_datedateyesFirst date in 2026-2026.
end_datedateyesLast date in 2026-2026.
include_start_datebooleandefault trueWhether start_date participates.
include_end_datebooleandefault trueWhether end_date participates.

Outputs

OutputTypeUnitDescription
working_daysintegerAuthority-scope working dates.
non_working_daysintegerWeekend and exact authority events.
public_holidays_countedlistExact events in the range.
territorystringBR (Brazil).
territory_namestringBrazil
day_typestringDeterministic classification: official_weekend, regular_workday, or the first published authority event kind.
holiday_namesstring_listEvents applying on the date.
holiday_kindsstring_listAuthority event classifications.
holiday_detailslistStructured event details, including partial-day notes where published.
calendar_scopestringBrazil federal executive public administration (SIPEC)
holiday_policystringPortaria MGI federal public-administration national holidays and ponto facultativo events; optional events are preserved as federal-scope optional days
substitute_day_policystringNo private-sector, state or municipal substitute-day rule is inferred
calendar_profilestringbrazil-federal-holidays
dataset_versionstringbr-mgi-federal-holidays-2026.1
sourceslistAuthority and legislation sources.

Example

Coverage starts with a published event: {"start_date":"2026-01-01","end_date":"2026-01-01","include_start_date":true,"include_end_date":true} → {"working_days":0,"non_working_days":1}

GET https://tttkmbb.com/api/v1/calculate/brazil-federal-working-days-between?start_date=2026-01-01&end_date=2026-01-01&include_start_date=true&include_end_date=true

Machine access

Sources

FAQ

Is ponto facultativo a national private-sector holiday?

No. It is preserved here as a federal public-administration optional day and must not be treated as universal closure.

Related calculators