# Date parser

Read a date written in a common human format and return it as ISO 8601 with weekday and week number.

- Endpoint: `POST https://setget.net/v1/tools/date-parse` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `date-parse`
- Page: https://setget.net/tools/date-parse

## Inputs

- `text` (required, string): The date to read, with an optional time.
- `day_first` (optional, boolean, default `false`): Read 03/05/2026 as 3 May (day first) instead of 5 March.

## Example 1

```json
{"input":{"text":"March 5, 2026"}}
```

Result:

```json
{"iso":"2026-03-05","date":"2026-03-05","time":null,"utc_offset":null,"weekday":"Thursday","day_of_year":64,"iso_week":"2026-W10-4","quarter":1,"leap_year":false,"format":"month day year","note":null}
```

## Example 2: Day first

```json
{"input":{"text":"03/05/2026","day_first":true}}
```

Result:

```json
{"iso":"2026-05-03","date":"2026-05-03","time":null,"utc_offset":null,"weekday":"Sunday","day_of_year":123,"iso_week":"2026-W18-7","quarter":2,"leap_year":false,"format":"numeric, day first","note":null}
```

## Example 3: An email (RFC 2822) date

```json
{"input":{"text":"Thu, 05 Mar 2026 14:30:00 +0100"}}
```

Result:

```json
{"iso":"2026-03-05T14:30:00+01:00","date":"2026-03-05","time":"14:30:00","utc_offset":"+01:00","weekday":"Thursday","day_of_year":64,"iso_week":"2026-W10-4","quarter":1,"leap_year":false,"format":"day month year","note":null}
```

**Is 03/05/2026 the 5th of March or the 3rd of May?** It depends on the country. By default the month comes first (5 March). Set day_first to true for the day first style used in most of the world (3 May).

**What if a number cannot be a month?** In 13/05/2026 the 13 can only be a day, so it is read that way and a note says so.

**Are two-digit years accepted?** No. "26" could be 1926 or 2026, so write all four digits.
