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
- Add five US federal working days after 2027-06-17.
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
| Parameter | Type | Unit | Required | Description |
|---|---|---|---|---|
start_date | date | yes | Gregorian start date in 2026-2027. | |
working_days | integer | yes | Signed offset; start date is excluded for non-zero offsets. Range: ≥ -1000, ≤ 1000 |
Outputs
| Output | Type | Unit | Description |
|---|---|---|---|
start_date | date | Input date. | |
result_date | date | Date reached. | |
working_days_added | integer | Signed requested offset. | |
calendar_days_elapsed | integer | Signed Gregorian difference. | |
federal_holidays_skipped | list | OPM federal holidays crossed. | |
territory | string | US. | |
territory_name | string | United States. | |
day_type | string | Regular weekday, regular weekend or OPM federal holiday. | |
holiday_names | string_list | OPM federal holiday names applying on the date. | |
holiday_observed | boolean | True when the date is the OPM in-lieu/observed date for a holiday whose actual date is a weekend. | |
holiday_actual_dates | string_list | Underlying statutory holiday dates for observed events. | |
weekend_days | string_list | CLDR Saturday/Sunday baseline. | |
rest_day_policy | string | OPM alternative work schedules need separate in-lieu resolution. | |
calendar_scope | string | Federal employees and federal offices only. | |
calendar_profile | string | us-opm-federal-holidays. | |
source_quality | string | Official OPM schedule and federal-law references. | |
dataset_version | string | Pinned OPM evidence package. | |
sources | list | Official 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
- API:
GET https://tttkmbb.com/api/v1/calculate/us-federal-add-working-days(query parameters) orPOSTwith a JSON body{"inputs": {...}} - Schema: https://tttkmbb.com/api/v1/calculators/us-federal-add-working-days · Markdown: https://tttkmbb.com/everyday/us-federal-add-working-days.md · JSON definition: https://tttkmbb.com/everyday/us-federal-add-working-days.json
- MCP: server
https://tttkmbb.com/mcp, tooladd_us_federal_working_days - OpenAPI operationId:
add_us_federal_working_days - Freshness:
static. Authentication: none. Rate limit: fair use (see rate limits).
Sources
- U.S. Office of Personnel Management Federal Holidays (government)
- OPM Federal Holidays - In Lieu Of Determination (government_guidance)
- 5 U.S.C. 6103 (legislation)
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
- US Federal Holiday Working Day — Inspect one date and its OPM source basis.