# Thai Date Format

> Thai Date Format (แปลงวันที่ไทย พ.ศ./ค.ศ.)

- Skill: `boom-vitt/thai-date-format` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add boom-vitt/thai-date-format`
- Raw SKILL.md: https://api.skillmd.com/api/skills/boom-vitt/thai-date-format/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Boom-Vitt (https://skillmd.com/u/boom-vitt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/boom-vitt/thai-date-format

---


# Thai Date Format (แปลงวันที่ไทย พ.ศ./ค.ศ.)

## Overview
แปลงระหว่าง พ.ศ. กับ ค.ศ. (`BE = CE + 543`), จัดรูปแบบวันที่ไทยตามสไตล์ราชการ / ธุรกิจ / กันเอง / สั้น, และสลับเลขอารบิก ↔ เลขไทย. Handles full month names (มกราคม) and abbreviations (ม.ค.).

## When to use
- รายงาน/หนังสือราชการที่ต้องการ พ.ศ.
- Parse วันที่จากเอกสาร PDF/Excel ที่ใช้ภาษาไทย
- แสดงผลในแอปสำหรับผู้ใช้ไทย (ทั้งเลขไทยและ พ.ศ.)
- DO NOT use for pre-1941 historical documents where the Thai fiscal year started 1 April; this module assumes Gregorian-aligned years.

## Example prompts
- "แปลง วันที่ 16 พฤษภาคม พ.ศ. 2569 เป็น ISO date"
- "Format วันนี้แบบราชการพร้อมเลขไทย"
- "Parse '๑๖ พ.ค. ๖๙' ให้เป็น Date object"

## Quick reference

### Year conversion
`BE = CE + 543` (e.g., 2026 → 2569). Pre-1941 documents may use a 1 April fiscal-year start — not handled here; convert manually if needed.

### Month tables

| # | Full (เต็ม) | Abbreviated (ย่อ) |
|---|---|---|
| 1 | มกราคม | ม.ค. |
| 2 | กุมภาพันธ์ | ก.พ. |
| 3 | มีนาคม | มี.ค. |
| 4 | เมษายน | เม.ย. |
| 5 | พฤษภาคม | พ.ค. |
| 6 | มิถุนายน | มิ.ย. |
| 7 | กรกฎาคม | ก.ค. |
| 8 | สิงหาคม | ส.ค. |
| 9 | กันยายน | ก.ย. |
| 10 | ตุลาคม | ต.ค. |
| 11 | พฤศจิกายน | พ.ย. |
| 12 | ธันวาคม | ธ.ค. |

### Numerals
| Arabic | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
|---|---|---|---|---|---|---|---|---|---|---|
| Thai | ๐ | ๑ | ๒ | ๓ | ๔ | ๕ | ๖ | ๗ | ๘ | ๙ |

### Format styles

| Style | Output example | Use case |
|---|---|---|
| `raachakan` | `วันที่ 16 พฤษภาคม พ.ศ. 2569` | หนังสือราชการ |
| `business` | `16 พฤษภาคม 2569` | จดหมายธุรกิจ ใบกำกับภาษี |
| `casual` | `16 พ.ค. 69` | SMS, chat |
| `short` | `16/05/2569` | ตาราง, spreadsheet |

## Implementation
- Python: [`convert.py`](convert.py) — `python convert.py` runs self-tests
- TypeScript: [`convert.ts`](convert.ts) — `npx tsx convert.ts` runs self-tests

## ปฏิทินจันทรคติ (Lunar calendar — ขึ้น/แรม)
Thai Buddhist lunar dates use **ขึ้น N ค่ำ** (waxing, days 1–15 as moon grows) and **แรม N ค่ำ** (waning, days 1–14 or 1–15 as moon shrinks), tied to lunar months written either as เดือนอ้าย, เดือนยี่, เดือนสาม … เดือนสิบสอง or simply เดือน ๑–๑๒ / เดือน 1–12.

### When this format is used
- พิธีกรรมทางศาสนา (Buddhist religious ceremonies, ordinations, ทอดกฐิน, ทอดผ้าป่า)
- วันพระ (every ขึ้น ๘ ค่ำ, ขึ้น ๑๕ ค่ำ, แรม ๘ ค่ำ, แรม ๑๔/๑๕ ค่ำ)
- วันสำคัญทางพุทธศาสนา — วิสาขบูชา (ขึ้น ๑๕ ค่ำ เดือน ๖), มาฆบูชา (ขึ้น ๑๕ ค่ำ เดือน ๓), อาสาฬหบูชา (ขึ้น ๑๕ ค่ำ เดือน ๘), วันเข้าพรรษา (แรม ๑ ค่ำ เดือน ๘), วันออกพรรษา (ขึ้น ๑๕ ค่ำ เดือน ๑๑)
- Official Buddhist event invitations typically write the lunar date first, then the Gregorian/BE date in parentheses: `วันขึ้น ๑๕ ค่ำ เดือน ๖ (ตรงกับวันอังคารที่ ๑๙ พฤษภาคม พ.ศ. ๒๕๖๙)`

### Basic structure
- A lunar month = waxing half (ขึ้น ๑–๑๕ ค่ำ, 15 days) + waning half (แรม ๑ ค่ำ to แรม ๑๔ or ๑๕ ค่ำ).
- เดือนคี่ (odd months) usually have แรม ๑๔ ค่ำ as the last day; เดือนคู่ (even months) usually have แรม ๑๕ ค่ำ. Adhikamāsa (อธิกมาส) leap-month years add an extra เดือน ๘ (called เดือน ๘-๘).
- DO NOT attempt manual conversion to Gregorian — alignment shifts every year. If conversion is needed, point the user at **PyThaiNLP** (`pythainlp.util` has lunar helpers) or the **thai-calendar-converter** npm package.

### Formatting rules
- Always use Thai numerals when written formally: `ขึ้น ๑๕ ค่ำ เดือน ๖`, not `ขึ้น 15 ค่ำ เดือน 6`.
- Space between each token: `ขึ้น` + space + numeral + space + `ค่ำ` + space + `เดือน` + space + numeral.
- For the first two months, ordinal names อ้าย (1) and ยี่ (2) are preferred in traditional contexts; numeric เดือน ๑ / เดือน ๒ is acceptable in modern writing.

## รูปแบบเวลา (Thai time format)
Thai uses a **dot** as the hour/minute separator (NOT colon) and ends with **น.** (abbreviation of นาฬิกา). Business and official writing always uses the **24-hour clock + น.**

### Canonical form
- `08.30 น.` (8:30 AM)
- `13.45 น.` (1:45 PM)
- `00.05 น.` (just after midnight)
- `23.59 น.` (one minute before midnight)

### Rules
- Always two-digit hour with leading zero: `08.30 น.` not `8.30 น.`.
- Always two-digit minute: `13.05 น.` not `13.5 น.`.
- Dot separator, not colon: `08.30` not `08:30`.
- Space before `น.` and keep the trailing dot.
- For time ranges use เวลา prefix and ถึง / `–`: `เวลา 09.00 – 12.00 น.` or `เวลา 09.00 ถึง 12.00 น.`.

### Traditional 6-period system (โมง / บ่าย / เย็น / ทุ่ม / ตี)
Still common in speech and casual chat, but **do not use in official documents, contracts, invoices, or formal invitations**:
- ตี ๑–ตี ๕ = 01.00–05.00 น.
- ๖ โมงเช้า–๑๑ โมงเช้า = 06.00–11.00 น.
- เที่ยง / เที่ยงวัน = 12.00 น.
- บ่ายโมง–บ่าย ๓ โมง = 13.00–15.00 น.
- ๔ โมงเย็น–๖ โมงเย็น = 16.00–18.00 น.
- ๑ ทุ่ม–๕ ทุ่ม = 19.00–23.00 น.
- เที่ยงคืน = 00.00 น.

## Common mistakes
- **Adding 543 to a parsed BE year.** If the input already says `พ.ศ. 2569`, don't add 543 again — that gives 3112. Always know whether the year you hold is BE or CE.
- **Mixing scripts in one date.** `๑๖ May 2569` looks weird; either go full Thai (`๑๖ พฤษภาคม ๒๕๖๙`) or full Arabic.
- **Two-digit year ambiguity.** `๖๙` could be 2469 or 2569 BE. This skill uses a heuristic (`yy >= 70` → 2400s, else 2500s); for legal documents, prefer 4-digit years.
- **Hard-coding day/month separators.** Thai dates commonly use spaces, not slashes. Slash-form `dd/mm/yyyy` exists but is informal.
- **Month abbreviation dots.** Always include trailing dot: `ม.ค.` not `มค`. The parser handles either, but the formatter emits the canonical dotted form.
- **Colon in Thai time.** `08:30 AM` or `08:30 น.` is wrong for Thai writing — use dot: `08.30 น.`. The `AM`/`PM` suffix is also wrong; switch to 24-hour + `น.`
- **Missing leading zero in time.** `8.30 น.` or `9.5 น.` on an official document looks unprofessional. Always pad to `08.30 น.` and `09.05 น.`
- **Trying to hand-convert lunar dates.** Do not guess the Gregorian equivalent of `ขึ้น ๑๕ ค่ำ เดือน ๖` — the mapping shifts each year and adhikamāsa years insert an extra เดือน ๘. Use PyThaiNLP or thai-calendar-converter, or quote the lunar date verbatim alongside the official Gregorian date supplied by the issuer.