# Add Malaysia Division Working Days

> Adds or subtracts dates using the selected Malaysian division's 2027 official public-holiday schedule and weekly baseline.

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

## Purpose

Adds or subtracts dates using the selected Malaysian division's 2027 official public-holiday schedule and weekly baseline.

**Use when:** You need a deterministic division-specific offset in 2027.

**Do not use when:** The division is unknown or replacement-day/employer rules matter.

## Example user requests

- Add five Kuala Lumpur working days after 2027-02-05.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `start_date` | date |  | required | Gregorian start date in 2027. |
| `division` | enum: KUL \| LBN \| PJY \| JHR \| KDH \| KTN \| MLK \| NSN \| PHG \| PRK \| PLS \| PNG \| SBH \| SWK \| SGR \| TRG |  | required | Required federal-territory/state code: KUL, LBN, PJY, JHR, KDH, KTN, MLK, NSN, PHG, PRK, PLS, PNG, SBH, SWK, SGR or TRG. |
| `working_days` | integer |  | required | Signed offset; start date is excluded for non-zero offsets. (min -1000, max 1000) |

## Output

| Field | 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. |
| `public_holidays_skipped` | list |  | Official events crossed. |
| `territory` | string |  | MY. |
| `territory_name` | string |  | Malaysia. |
| `division` | string |  | Normalized division code. |
| `division_name` | string |  | Federal territory or state. |
| `weekday` | string |  | Gregorian weekday. |
| `is_working_day` | boolean |  | False for the division's declared weekly baseline or applicable official holiday. |
| `day_type` | string |  | Regular weekday, official weekend or public holiday. |
| `weekend_days` | string_list |  | Division weekly-rest baseline. |
| `holiday_names` | string_list |  | Official events applying to the date. |
| `holiday_observed` | boolean |  | Always false here because no substitute date is inferred. |
| `rest_day_policy` | string |  | Employer roster and replacement-day policy are not inferred. |
| `substitute_day_policy` | string |  | Replacement dates are not inferred. |
| `calendar_scope` | string |  | Selected division's federal/state public holidays and weekly baseline. |
| `calendar_profile` | string |  | malaysia-bkpp-public-holidays. |
| `dataset_version` | string |  | Pinned BKPP/JPM 2027 package. |
| `sources` | list |  | Official government and legislative sources. |

## Formula

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

Skip the selected division's weekend baseline and exact official events; do not infer replacement days.

## Data Sources

- BKPP JPM Hari Kelepasan Am — https://www.kabinet.gov.my/hari-kelepasan-am/ (federal_government_official_schedule, published 2026-08-20)
- BKPP JPM 2027 schedule notice — https://www.kabinet.gov.my/3689-2/ (federal_government_notice, published 2026-08-20)
- Malaysia.gov.my public holidays — https://www.malaysia.gov.my/my/government/public-holidays--school-holidays/cuti-umum (government_portal)
- Holidays Act 1951 (Act 369) — https://www.kabinet.gov.my/storage/2024/11/1951_12_31_akta369.pdf (legislation)
- Holidays Ordinance (Sabah Cap. 56) — https://www.kabinet.gov.my/akta-dan-warta/ (state_legislation_index)
- Public Holidays Ordinance (Sarawak Cap. 8) — https://www.kabinet.gov.my/akta-dan-warta/ (state_legislation_index)

Data freshness: `static`. BKPP publishes the next federal/state schedule after official review; refresh only after the official page changes.

## API

- `GET https://tttkmbb.com/api/v1/calculate/malaysia-add-working-days?start_date=…&division=…&working_days=…`
- `POST https://tttkmbb.com/api/v1/calculate/malaysia-add-working-days` 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/malaysia-add-working-days · OpenAPI operationId `add_my_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: `add_my_working_days` (dedicated) or `run_calculator` with `{"calculator_id": "malaysia-add-working-days", "inputs": {…}}`

## Example

- Kuala Lumpur offset: inputs `{"start_date":"2027-02-05","division":"KUL","working_days":1}` → `{"result_date":"2027-02-08"}`

```
GET https://tttkmbb.com/api/v1/calculate/malaysia-add-working-days?start_date=2027-02-05&division=KUL&working_days=1
```

## Limitations

The division is unknown or replacement-day/employer rules matter. Skip the selected division's weekend baseline and exact official events; do not infer replacement days. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Are replacement days added?**

No. Only dates in the pinned BKPP table are used.

## Related

- [Malaysia Division Public-Holiday Working Day](https://tttkmbb.com/everyday/malaysia-working-day.md) — Inspect a date and source basis.