@inverz/thai-zod
v1.0.0
Published
Zod schemas for Thai data with Thai error messages: national ID, tax ID, phone, postcode, Thai dates, birth date and baht amounts
Readme
@inverz/thai-zod
Zod schema สำหรับข้อมูลไทย: เลขบัตรประชาชน / เลขผู้เสียภาษี (ตรวจ checksum), เบอร์โทร, รหัสไปรษณีย์, วันที่ไทย, วันเกิด (ตรวจอายุ) และ จำนวนเงิน ข้อความผิดพลาดเป็นภาษาไทย และได้ค่าที่ทำความสะอาดแล้วไปใช้ต่อ ใช้ได้กับ zod 3.23 ขึ้นไปและ zod 4 ไม่มี React
Zod schemas for Thai national IDs, tax IDs, phone numbers, postcodes, Thai dates, birth dates and baht amounts, with Thai error messages. Works with zod 3.23+ and zod 4.
ติดตั้ง
npm i @inverz/thai-zod zodimport { z } from "zod";
import { zThaiId, zThaiPhone, zPostcode, zThaiDate, zBirthDate, zBaht } from "@inverz/thai-zod";
const signup = z.object({
nationalId: zThaiId(),
phone: zThaiPhone({ mobileOnly: true }),
birthDate: zBirthDate({ minAge: 18 }),
postcode: zPostcode(),
referrer: zThaiPhone({ optional: true, label: "เบอร์ผู้แนะนำ" }),
});
signup.parse({ nationalId: "1-1017-00203-45-0", phone: "081-234-5678", birthDate: "15 มี.ค. 2530", postcode: "10200", referrer: "" });
// { nationalId: "1101700203450", phone: "0812345678", birthDate: Date, postcode: "10200", referrer: undefined }ใช้กับ react-hook-form ผ่าน zodResolver(signup) ได้ตามปกติ
Schema
| schema | รับ | ได้ | ข้อความเมื่อผิด (ตัวอย่าง) |
|---|---|---|---|
| zThaiId() | "1-1017-00203-45-0" | "1101700203450" | เลขบัตรประชาชนต้องมี 13 หลัก / เลขบัตรประชาชนไม่ถูกต้อง |
| zThaiTaxId() | เลขผู้เสียภาษี 13 หลัก | ตัวเลขล้วน | เลขผู้เสียภาษีไม่ถูกต้อง |
| zThaiPhone() | มือถือ บ้าน 1XXX 1800 และ +66 | "0812345678" | เบอร์โทรไม่ถูกต้อง |
| zThaiPhone({ mobileOnly: true }) | | | ต้องเป็นเบอร์มือถือ (06, 08, 09) |
| zThaiPhone({ output }) | | "digits" / "international" (+66812345678) / "formatted" (081-234-5678) | |
| zPostcode() | "10200" หรือ 10200 | "10200" | รหัสไปรษณีย์ต้องเป็นตัวเลข 5 หลัก |
| zThaiDate({ min, max }) | Date, timestamp, "27 ก.ย. 2569", "27/09/2569", "2026-09-27" | Date | วันที่ไม่ถูกต้อง / ต้องไม่หลัง 27 ก.ย. 2569 |
| zBirthDate({ minAge, maxAge }) | เหมือน zThaiDate | Date | ต้องมีอายุอย่างน้อย 18 ปี |
| zBaht({ min, max }) | 1500, "1,500.50", "฿1,500 บาท" | 1500.5 | ทศนิยมได้ไม่เกิน 2 ตำแหน่ง / ต้องไม่เกิน 50,000 บาท |
zThaiDateใช้"today"เป็นmin/maxได้ และเทียบเป็นวัน ไม่สนเวลา- ปี พ.ศ. แปลงเป็น ค.ศ. ให้เอง (อ่านวันที่ด้วย
parseThaiDateของ @inverz/thai-date)
ตัวเลือกที่ใช้ได้กับทุก schema
| ตัวเลือก | คำอธิบาย |
|---|---|
| optional: true | ค่าว่าง ("", null, undefined) ผ่านเป็น undefined ฟอร์มส่ง "" มาเมื่อไม่กรอก จึงใช้ .optional() ของ zod อย่างเดียวไม่พอ |
| label | ชื่อช่องในข้อความ เช่น label: "เลขบัตรผู้ปกครอง" → "กรุณากรอกเลขบัตรผู้ปกครอง" |
| message | ข้อความเดียวแทนข้อความทั้งหมดของ schema นั้น |
| locale: "en" | ข้อความภาษาอังกฤษ |
ตั้งภาษาทั้งแอปด้วย setThaiZodLocale("en") (มีผลกับ schema ที่สร้างหลังเรียก)
TypeScript
type Signup = z.infer<typeof signup>;
// { nationalId: string; phone: string; birthDate: Date; postcode: string; referrer: string | undefined }หมายเหตุ
ฟังก์ชันตรวจเลขบัตรและเบอร์โทรมาจาก @inverz/thai-input ถูกรวมไว้ในแพ็กเกจตอน build ติดตั้งแพ็กเกจนี้จึงไม่ดึง React มาด้วย
License
MIT © 2026 Inverz Solutions Co.,Ltd.
