# Count South Africa Working Days

> Counts national working and non-working dates in a South Africa 2026-2027 range.

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

## Purpose

Counts national working and non-working dates in a South Africa 2026-2027 range.

**Use when:** You need an auditable South Africa national working-day count.

**Do not use when:** You need employer, school, bank, exchange or locally exchanged schedules.

## Example user requests

- Count South Africa working days from 2026-11-03 to 2026-11-06.


## 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 |  | South Africa national working dates. |
| `non_working_days` | integer |  | Weekend and exact national public holiday dates. |
| `public_holidays_counted` | list |  | Exact national events in the range. |
| `territory` | string |  | ZA (South Africa). |
| `territory_name` | string |  | South Africa. |
| `holiday_names` | string_list |  | National public holidays applying on the date. |
| `calendar_scope` | string |  | National public holidays over a Monday-Friday baseline. |
| `employer_schedule_policy` | string |  | Employer-specific exchanges and rest days are not inferred. |
| `calendar_profile` | string |  | south-africa-public-holidays. |
| `dataset_version` | string |  | Pinned South African Government package. |
| `sources` | list |  | Official South African Government, legislation and Presidency sources. |

## Formula

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

Normalize endpoints and count the exact national package over the Saturday-Sunday baseline.

## Data Sources

- South African Government public holidays — https://www.gov.za/zu/about-sa/public-holidays (government)
- Public Holidays Act 36 of 1994 — https://www.gov.za/sites/default/files/gcis_document/201409/act36of1994.pdf (government_legislation)
- The Presidency special election public holiday — https://www.thepresidency.gov.za/node?kovsieapp=true&page=0 (government)

Data freshness: `static`. Pinned 2026-2027 package.

## API

- `GET https://tttkmbb.com/api/v1/calculate/south-africa-working-days-between?start_date=…&end_date=…`
- `POST https://tttkmbb.com/api/v1/calculate/south-africa-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/south-africa-working-days-between · OpenAPI operationId `count_south_africa_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": "south-africa-working-days-between", "inputs": {…}}`

## Example

- Election holiday week: inputs `{"start_date":"2026-11-03","end_date":"2026-11-06","include_start_date":true,"include_end_date":true}` → `{"working_days":3}`

```
GET https://tttkmbb.com/api/v1/calculate/south-africa-working-days-between?start_date=2026-11-03&end_date=2026-11-06&include_start_date=true&include_end_date=true
```

## Limitations

You need employer, school, bank, exchange or locally exchanged schedules. Normalize endpoints and count the exact national package over the Saturday-Sunday baseline. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Are employer holiday exchanges included?**

No. The count is national public holidays only over a Monday-Friday baseline.

## Related

- [South Africa Working Day](https://tttkmbb.com/everyday/south-africa-working-day.md) — Inspect a date and source evidence.