Home › Everyday Life › Add US Federal Working Days

Add US Federal Working Days

Adds or subtracts dates using the pinned OPM federal schedule and US weekend baseline.

When to use

You need a deterministic US federal employee/office date offset in 2026-2027.

Do not use when: You need state/local/private-employer, exchange or alternate-work-schedule semantics.

Example user requests

Formula

move one day at a time; decrement remaining only when US federal status.is_working_day=true

Skip the US weekend baseline and pinned OPM federal observed dates.

Inputs

ParameterTypeUnitRequiredDescription
start_datedateyesGregorian start date in 2026-2027.
working_daysintegeryesSigned offset; start date is excluded for non-zero offsets. Range: ≥ -1000, ≤ 1000

Outputs

OutputTypeUnitDescription
start_datedateInput date.
result_datedateDate reached.
working_days_addedintegerSigned requested offset.
calendar_days_elapsedintegerSigned Gregorian difference.
federal_holidays_skippedlistOPM federal holidays crossed.
territorystringUS.
territory_namestringUnited States.
day_typestringRegular weekday, regular weekend or OPM federal holiday.
holiday_namesstring_listOPM federal holiday names applying on the date.
holiday_observedbooleanTrue when the date is the OPM in-lieu/observed date for a holiday whose actual date is a weekend.
holiday_actual_datesstring_listUnderlying statutory holiday dates for observed events.
weekend_daysstring_listCLDR Saturday/Sunday baseline.
rest_day_policystringOPM alternative work schedules need separate in-lieu resolution.
calendar_scopestringFederal employees and federal offices only.
calendar_profilestringus-opm-federal-holidays.
source_qualitystringOfficial OPM schedule and federal-law references.
dataset_versionstringPinned OPM evidence package.
sourceslistOfficial OPM, federal guidance and legislation sources.

Example

Offset across Juneteenth: {"start_date":"2027-06-17","working_days":1} → {"result_date":"2027-06-21"}

GET https://tttkmbb.com/api/v1/calculate/us-federal-add-working-days?start_date=2027-06-17&working_days=1

Machine access

Sources

FAQ

Does this resolve alternate federal schedules?

No. The default result uses the Monday-Friday baseline; OPM's alternate work-schedule rules require the employee's schedule.

Related calculators