# Count Finland Working Days

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

- Calculator id: `finland-public-working-days-between` · Category: Everyday Life (`everyday`) · Tool name: `count_fi_working_days`
- Canonical page: https://tttkmbb.com/everyday/finland-public-working-days-between · This document: https://tttkmbb.com/everyday/finland-public-working-days-between.md · JSON definition: https://tttkmbb.com/everyday/finland-public-working-days-between.json

## Purpose

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

**Use when:** You need an auditable Finland working-day count.

**Do not use when:** Nationwide full-day public-holiday layer only. Midsummer Eve, Christmas Eve, employer, collective-agreement, sector, school, bank, Åland, Sámi and local closures are not inferred; private-sector annual-leave counting may treat Saturdays and certain eves differently.

## Example user requests

- Count Finland working days around Independence Day.
- Count Finland working days around Midsummer Eve is agreement-dependent.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `start_date` | date |  | required | First date in 2026-2027. |
| `end_date` | date |  | required | Last date in 2026-2027. |
| `include_start_date` | boolean |  | optional, default true | Whether start_date participates. |
| `include_end_date` | boolean |  | optional, default true | Whether end_date participates. |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `working_days` | integer |  | Authority-scope working dates. |
| `non_working_days` | integer |  | Weekend and exact authority events. |
| `public_holidays_counted` | list |  | Exact events in the range. |
| `territory` | string |  | FI (Finland). |
| `territory_name` | string |  | Finland |
| `day_type` | string |  | Deterministic classification: official_weekend, regular_workday, or the first published authority event kind. |
| `holiday_names` | string_list |  | Events applying on the date. |
| `holiday_kinds` | string_list |  | Authority event classifications. |
| `holiday_details` | list |  | Structured event details, including partial-day notes where published. |
| `calendar_scope` | string |  | Finland nationwide church and national full-day public holidays for 2026-2027 |
| `holiday_policy` | string |  | Finnish church and national public holidays are included; Midsummer Eve and Christmas Eve are not treated as nationwide statutory full-day holidays because their paid-day status is commonly agreement-dependent. |
| `substitute_day_policy` | string |  | No nationwide substitute-day closure is inferred when a public holiday falls on a weekend. |
| `calendar_profile` | string |  | finland-public-holidays |
| `dataset_version` | string |  | fi-nationwide-public-holidays-2026-2027.1 |
| `sources` | list |  | Authority and legislation sources. |

## Formula

`for each included date: working_days += status.is_working_day`

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

## Data Sources

- University of Helsinki Almanac Office – Flag days and public holidays — https://almanakka.helsinki.fi/en/flag-days-and-holidays (university_authoritative_calendar)
- Bank of Finland – Bank holidays — https://www.suomenpankki.fi/en/money-and-payments/bank-holidays/ (central_bank_official_calendar)
- Finlex – Annual Holidays Act 162/2005 — https://finlex.fi/en/legislation/translations/2005/eng/162 (government_legal_text)

Data freshness: `static`. Pinned fi-nationwide-public-holidays-2026-2027.1 package.

## API

- `GET https://tttkmbb.com/api/v1/calculate/finland-public-working-days-between?start_date=…&end_date=…`
- `POST https://tttkmbb.com/api/v1/calculate/finland-public-working-days-between` with JSON body `{"inputs": {…}}`
- Response: unified envelope (`success`, `request`, `result.values`, `result.units`, `sources`, `freshness`, `timestamp`, `next_actions`, `links`); see https://tttkmbb.com/docs/response-format.md
- Schema: https://tttkmbb.com/api/v1/calculators/finland-public-working-days-between · OpenAPI operationId `count_fi_working_days` in https://tttkmbb.com/openapi.json
- Authentication: none. Rate limit: fair use, see https://tttkmbb.com/docs/rate-limits.md.

## MCP

- Server: `https://tttkmbb.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no auth)
- Tool:  `run_calculator` with `{"calculator_id": "finland-public-working-days-between", "inputs": {…}}`

## Example

- Coverage starts with a published event: inputs `{"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/finland-public-working-days-between?start_date=2026-01-01&end_date=2026-01-01&include_start_date=true&include_end_date=true
```

## Limitations

Nationwide full-day public-holiday layer only. Midsummer Eve, Christmas Eve, employer, collective-agreement, sector, school, bank, Åland, Sámi and local closures are not inferred; private-sector annual-leave counting may treat Saturdays and certain eves differently. Normalize endpoints and count exact authority events over the declared weekday baseline. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Are Midsummer Eve and Christmas Eve nationwide statutory full-day holidays?**

No. They are paid days for a large part of the population under collective agreements, but this package does not infer them as universal nationwide full-day closures.

## Related

- [Finland Working Day](https://tttkmbb.com/everyday/finland-public-working-day.md) — Inspect a date and source evidence.
