{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"us-federal-add-working-days"},"result":{"entity_type":"calculator","id":"us-federal-add-working-days","calculator_id":"us-federal-add-working-days","canonical_url":"https://tttkmbb.com/everyday/us-federal-add-working-days","name":"Add US Federal Working Days","title":"Add US Federal Working Days – OPM","category":"everyday","category_name":"Everyday Life","tool_name":"add_us_federal_working_days","featured_mcp_tool":true,"description":"Adds or subtracts dates using the pinned OPM federal schedule and US weekend baseline.","use_when":"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.","agent_examples":["Add five US federal working days after 2027-06-17."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"Gregorian start date in 2026-2027.","example":"2027-06-17"},{"name":"working_days","label":"Working days","type":"integer","required":true,"min":-1000,"max":1000,"description":"Signed offset; start date is excluded for non-zero offsets.","example":5}],"outputs":[{"name":"start_date","label":"Start date","type":"date","decimals":4,"description":"Input date."},{"name":"result_date","label":"Result date","type":"date","decimals":4,"description":"Date reached."},{"name":"working_days_added","label":"Working days added","type":"integer","decimals":4,"description":"Signed requested offset."},{"name":"calendar_days_elapsed","label":"Calendar days elapsed","type":"integer","decimals":4,"description":"Signed Gregorian difference."},{"name":"federal_holidays_skipped","label":"Federal holidays skipped","type":"list","decimals":4,"description":"OPM federal holidays crossed."},{"name":"territory","label":"Territory","type":"string","decimals":4,"description":"US."},{"name":"territory_name","label":"Territory name","type":"string","decimals":4,"description":"United States."},{"name":"day_type","label":"Day type","type":"string","decimals":4,"description":"Regular weekday, regular weekend or OPM federal holiday."},{"name":"holiday_names","label":"Holiday names","type":"string_list","decimals":4,"description":"OPM federal holiday names applying on the date."},{"name":"holiday_observed","label":"Observed date","type":"boolean","decimals":4,"description":"True when the date is the OPM in-lieu/observed date for a holiday whose actual date is a weekend."},{"name":"holiday_actual_dates","label":"Actual holiday dates","type":"string_list","decimals":4,"description":"Underlying statutory holiday dates for observed events."},{"name":"weekend_days","label":"Weekend baseline","type":"string_list","decimals":4,"description":"CLDR Saturday/Sunday baseline."},{"name":"rest_day_policy","label":"Rest-day policy","type":"string","decimals":4,"description":"OPM alternative work schedules need separate in-lieu resolution."},{"name":"calendar_scope","label":"Calendar scope","type":"string","decimals":4,"description":"Federal employees and federal offices only."},{"name":"calendar_profile","label":"Calendar profile","type":"string","decimals":4,"description":"us-opm-federal-holidays."},{"name":"source_quality","label":"Source quality","type":"string","decimals":4,"description":"Official OPM schedule and federal-law references."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Pinned OPM evidence package."},{"name":"sources","label":"Sources","type":"list","decimals":4,"description":"Official OPM, federal guidance and legislation sources."}],"input_schema":{"type":"object","properties":{"start_date":{"description":"Gregorian start date in 2026-2027.","type":"string","format":"date","examples":["2027-06-17"]},"working_days":{"description":"Signed offset; start date is excluded for non-zero offsets.","type":"integer","minimum":-1000,"maximum":1000,"examples":[5]}},"additionalProperties":false,"required":["start_date","working_days"],"examples":[{"start_date":"2027-06-17","working_days":1}]},"output_schema":{"type":"object","properties":{"start_date":{"description":"Input date.","type":"string","format":"date"},"result_date":{"description":"Date reached.","type":"string","format":"date"},"working_days_added":{"description":"Signed requested offset.","type":"integer"},"calendar_days_elapsed":{"description":"Signed Gregorian difference.","type":"integer"},"federal_holidays_skipped":{"description":"OPM federal holidays crossed.","type":"array"},"territory":{"description":"US.","type":"string"},"territory_name":{"description":"United States.","type":"string"},"day_type":{"description":"Regular weekday, regular weekend or OPM federal holiday.","type":"string"},"holiday_names":{"description":"OPM federal holiday names applying on the date.","type":"array","items":{"type":"string"}},"holiday_observed":{"description":"True when the date is the OPM in-lieu/observed date for a holiday whose actual date is a weekend.","type":"boolean"},"holiday_actual_dates":{"description":"Underlying statutory holiday dates for observed events.","type":"array","items":{"type":"string"}},"weekend_days":{"description":"CLDR Saturday/Sunday baseline.","type":"array","items":{"type":"string"}},"rest_day_policy":{"description":"OPM alternative work schedules need separate in-lieu resolution.","type":"string"},"calendar_scope":{"description":"Federal employees and federal offices only.","type":"string"},"calendar_profile":{"description":"us-opm-federal-holidays.","type":"string"},"source_quality":{"description":"Official OPM schedule and federal-law references.","type":"string"},"dataset_version":{"description":"Pinned OPM evidence package.","type":"string"},"sources":{"description":"Official OPM, federal guidance and legislation sources.","type":"array"}}},"formula":"move one day at a time; decrement remaining only when US federal status.is_working_day=true","method":"Skip the US weekend baseline and pinned OPM federal observed dates.","sources":[{"name":"U.S. Office of Personnel Management Federal Holidays","url":"https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/","type":"government","published_at":"2026-09-29"},{"name":"OPM Federal Holidays - In Lieu Of Determination","url":"https://www.opm.gov/policy-data-oversight/pay-leave/work-schedules/fact-sheets/federal-holidays-in-lieu-of-determination/","type":"government_guidance"},{"name":"5 U.S.C. 6103","url":"https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title5-section6103&num=0&edition=prelim","type":"legislation"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Pinned OPM 2026-2027 package."},"examples":[{"name":"Offset across Juneteenth","inputs":{"start_date":"2027-06-17","working_days":1},"expected":{"result_date":"2027-06-21"},"url":"https://tttkmbb.com/api/v1/calculate/us-federal-add-working-days?start_date=2027-06-17&working_days=1"}],"faq":[{"q":"Does this resolve alternate federal schedules?","a":"No. The default result uses the Monday-Friday baseline; OPM's alternate work-schedule rules require the employee's schedule."}],"tags":["United States","OPM","add working days"],"related":[{"calculator_id":"us-federal-working-day","reason":"Inspect one date and its OPM source basis."}],"links":{"html":"https://tttkmbb.com/everyday/us-federal-add-working-days","markdown":"https://tttkmbb.com/everyday/us-federal-add-working-days.md","json":"https://tttkmbb.com/everyday/us-federal-add-working-days.json","api":"https://tttkmbb.com/api/v1/calculate/us-federal-add-working-days","schema":"https://tttkmbb.com/api/v1/calculators/us-federal-add-working-days","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-27"},"timestamp":"2026-09-29T12:59:55Z","links":{"mcp":"https://tttkmbb.com/mcp","a2a":"https://tttkmbb.com/a2a","openapi":"https://tttkmbb.com/openapi.json","llms_txt":"https://tttkmbb.com/llms.txt","feed":"https://tttkmbb.com/feed.xml","ard":"https://tttkmbb.com/.well-known/ard.json","ai_catalog":"https://tttkmbb.com/.well-known/ai-catalog.json","agent_card":"https://tttkmbb.com/.well-known/agent-card.json","mcp_server_card":"https://tttkmbb.com/mcp/server-card","mcp_server_card_legacy":"https://tttkmbb.com/.well-known/mcp-server-card.json","ai_plugin":"https://tttkmbb.com/.well-known/ai-plugin.json","agent_capabilities":"https://tttkmbb.com/agent-capabilities.json","docs":"https://tttkmbb.com/docs/index.md","privacy":"https://tttkmbb.com/docs/privacy","terms":"https://tttkmbb.com/docs/terms","support":"https://tttkmbb.com/docs/support","china_work_calendar_data":"https://tttkmbb.com/api/v1/data/china-work-calendar/2026","uk_bank_holidays_data":"https://tttkmbb.com/api/v1/data/uk-bank-holidays","iana_tzdb_data":"https://tttkmbb.com/api/v1/data/iana-tzdb","global_working_day_data":"https://tttkmbb.com/api/v1/data/global-working-day","global_public_holiday_data":"https://tttkmbb.com/api/v1/data/global-public-holidays","global_working_day_reference_data":"https://tttkmbb.com/api/v1/data/global-working-day-reference","australia_public_holidays_data":"https://tttkmbb.com/api/v1/data/australia-public-holidays","us_federal_holidays_data":"https://tttkmbb.com/api/v1/data/us-federal-holidays","canada_federal_holidays_data":"https://tttkmbb.com/api/v1/data/canada-federal-holidays","japan_national_holidays_data":"https://tttkmbb.com/api/v1/data/japan-national-holidays","india_central_government_holidays_data":"https://tttkmbb.com/api/v1/data/india-central-government-holidays","uae_federal_holidays_data":"https://tttkmbb.com/api/v1/data/uae-federal-holidays","new_zealand_public_holidays_data":"https://tttkmbb.com/api/v1/data/new-zealand-public-holidays","south_africa_public_holidays_data":"https://tttkmbb.com/api/v1/data/south-africa-public-holidays","ireland_public_holidays_data":"https://tttkmbb.com/api/v1/data/ireland-public-holidays","france_public_holidays_data":"https://tttkmbb.com/api/v1/data/france-public-holidays","argentina_public_holidays_data":"https://tttkmbb.com/api/v1/data/argentina-public-holidays","uzbekistan_public_holidays_data":"https://tttkmbb.com/api/v1/data/uzbekistan-public-holidays","vietnam_public_holidays_data":"https://tttkmbb.com/api/v1/data/vietnam-public-holidays","bangladesh_public_holidays_data":"https://tttkmbb.com/api/v1/data/bangladesh-public-holidays","sri_lanka_public_holidays_data":"https://tttkmbb.com/api/v1/data/sri-lanka-public-holidays","nigeria_public_holidays_data":"https://tttkmbb.com/api/v1/data/nigeria-public-holidays","ghana_public_holidays_data":"https://tttkmbb.com/api/v1/data/ghana-public-holidays","pakistan_public_holidays_data":"https://tttkmbb.com/api/v1/data/pakistan-public-holidays","kenya_public_holidays_data":"https://tttkmbb.com/api/v1/data/kenya-public-holidays","egypt_public_holidays_data":"https://tttkmbb.com/api/v1/data/egypt-public-holidays","russia_public_holidays_data":"https://tttkmbb.com/api/v1/data/russia-public-holidays","colombia_public_holidays_data":"https://tttkmbb.com/api/v1/data/colombia-public-holidays","chile_public_holidays_data":"https://tttkmbb.com/api/v1/data/chile-public-holidays","greece_public_holidays_data":"https://tttkmbb.com/api/v1/data/greece-public-holidays","kazakhstan_public_holidays_data":"https://tttkmbb.com/api/v1/data/kazakhstan-public-holidays","peru_public_holidays_data":"https://tttkmbb.com/api/v1/data/peru-public-holidays","slovakia_public_holidays_data":"https://tttkmbb.com/api/v1/data/slovakia-public-holidays","hungary_public_holidays_data":"https://tttkmbb.com/api/v1/data/hungary-public-holidays","czech_public_holidays_data":"https://tttkmbb.com/api/v1/data/czech-public-holidays","croatia_public_holidays_data":"https://tttkmbb.com/api/v1/data/croatia-public-holidays","slovenia_public_holidays_data":"https://tttkmbb.com/api/v1/data/slovenia-public-holidays","estonia_public_holidays_data":"https://tttkmbb.com/api/v1/data/estonia-public-holidays","luxembourg_public_holidays_data":"https://tttkmbb.com/api/v1/data/luxembourg-public-holidays","malta_public_holidays_data":"https://tttkmbb.com/api/v1/data/malta-public-holidays","lithuania_public_holidays_data":"https://tttkmbb.com/api/v1/data/lithuania-public-holidays","latvia_public_holidays_data":"https://tttkmbb.com/api/v1/data/latvia-public-holidays","bulgaria_public_holidays_data":"https://tttkmbb.com/api/v1/data/bulgaria-public-holidays","romania_public_holidays_data":"https://tttkmbb.com/api/v1/data/romania-public-holidays","brazil_federal_holidays_data":"https://tttkmbb.com/api/v1/data/brazil-federal-holidays","mexico_labor_rest_days_data":"https://tttkmbb.com/api/v1/data/mexico-labor-rest-days","philippines_public_holidays_data":"https://tttkmbb.com/api/v1/data/philippines-public-holidays","indonesia_public_holidays_data":"https://tttkmbb.com/api/v1/data/indonesia-public-holidays","south_korea_public_holidays_data":"https://tttkmbb.com/api/v1/data/south-korea-public-holidays","italy_public_holidays_data":"https://tttkmbb.com/api/v1/data/italy-public-holidays","spain_public_holidays_data":"https://tttkmbb.com/api/v1/data/spain-national-holidays","germany_public_holidays_data":"https://tttkmbb.com/api/v1/data/germany-national-holidays","netherlands_public_holidays_data":"https://tttkmbb.com/api/v1/data/netherlands-public-holidays","belgium_public_holidays_data":"https://tttkmbb.com/api/v1/data/belgium-public-holidays","austria_public_holidays_data":"https://tttkmbb.com/api/v1/data/austria-public-holidays","poland_public_holidays_data":"https://tttkmbb.com/api/v1/data/poland-public-holidays","portugal_public_holidays_data":"https://tttkmbb.com/api/v1/data/portugal-public-holidays","denmark_public_holidays_data":"https://tttkmbb.com/api/v1/data/denmark-public-holidays","sweden_public_holidays_data":"https://tttkmbb.com/api/v1/data/sweden-public-holidays","norway_public_holidays_data":"https://tttkmbb.com/api/v1/data/norway-public-holidays","finland_public_holidays_data":"https://tttkmbb.com/api/v1/data/finland-public-holidays","switzerland_public_holidays_data":"https://tttkmbb.com/api/v1/data/switzerland-public-holidays","taiwan_government_work_calendar_data":"https://tttkmbb.com/api/v1/data/taiwan-government-work-calendar","hong_kong_general_holidays_data":"https://tttkmbb.com/api/v1/data/hong-kong-general-holidays","turkey_public_holidays_data":"https://tttkmbb.com/api/v1/data/turkey-public-holidays","saudi_financial_holidays_data":"https://tttkmbb.com/api/v1/data/saudi-financial-holidays","thailand_financial_holidays_data":"https://tttkmbb.com/api/v1/data/thailand-financial-holidays","working_day_catalog":"https://tttkmbb.com/api/v1/data/working-day-calendars","html":"https://tttkmbb.com/everyday/us-federal-add-working-days","markdown":"https://tttkmbb.com/everyday/us-federal-add-working-days.md","api":"https://tttkmbb.com/api/v1/calculate/us-federal-add-working-days"}}