Home › Everyday Life › Count Nigeria Working Days

Count Nigeria Working Days

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

When to use

You need an auditable Nigeria working-day count.

Do not use when: This is the nationwide federal public-holiday layer, not a universal private-employer, state, local-government, school, banking, market, diplomatic-mission or sector calendar. Ministry of Interior announcements take precedence over conflicting secondary or diplomatic snapshots for federal dates. Eid dates are lunar and can be amended by later official notice. The Public Holidays Act permits special or substituted dates and explicitly does not create an automatic extra day for a holiday falling on Saturday or Sunday; no replacement day is invented here.

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.
territorystringNG (Nigeria).
territory_namestringNigeria
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_scopestringNigeria 2026 nationwide federal public-holiday calendar over a Saturday-Sunday weekend
holiday_policystringNigeria_Public_Holidays_Act_and_2026_Federal_Government_Announcements
substitute_day_policystringpublished_official_dates_only; no automatic weekend_lieu_day; later federal public notice overrides
calendar_profilestringnigeria-public-holidays
dataset_versionstringng-federal-public-2026.1
sourceslistAuthority and legislation sources.

Example

Eid-ul-Fitr federal closure: {"start_date":"2026-03-19","end_date":"2026-03-20","include_start_date":true,"include_end_date":true} → {"working_days":0,"non_working_days":2}

GET https://tttkmbb.com/api/v1/calculate/nigeria-public-working-days-between?start_date=2026-03-19&end_date=2026-03-20&include_start_date=true&include_end_date=true

Machine access

Sources

FAQ

Does this answer every Nigerian employer's calendar?

No. It is the nationwide federal public-holiday layer. State, local, school, bank, market, diplomatic, sector and private-employer calendars need their own authority and are not inferred.

Why does the package use March 19–20 for Eid-ul-Fitr?

Those are the dates in the Nigeria Ministry of Interior's federal announcement. A diplomatic snapshot lists different dates, so the federal announcement is retained as the authoritative scope and the conflict is disclosed.

Related calculators