@kashi-ui/persian

中文文档
0.20.0发布于 2026/11/01MITTypeScriptES Module零依赖

ابزارهای فارسی کاشی: تاریخ شمسی، اعتبارسنجی کد ملی و شماره کارت، ارقام فارسی

原始使用文档

@kashi-ui/persian

ابزارهای فارسی کاشی: تاریخ شمسی، ارقام فارسی، اعتبارسنجی کد ملی و شماره کارت. بدون وابستگی، برای مرورگر، Node.js و هر فریم‌ورکی.

npm i @kashi-ui/persian
import { formatJalali, parseJalali, toISODate, isValidNationalId, getBankByCard, toEnDigits, isValidPostalCode, formatPlate, parseTime } from "@kashi-ui/persian";

formatJalali(new Date(2024, 7, 2), { style: "full" }); // "جمعه ۱۲ مرداد ۱۴۰۳"
parseJalali("۱۴۰۳/۵/۱۲");                            // Date
toISODate(date);                                      // "2024-08-02" (بدون خطای منطقهٔ زمانی)
isValidNationalId("۰۰۱۳۵۴۲۴۱۹");                      // true
getBankByCard("610433")?.name;                        // "بانک ملت"
toEnDigits("۰۹۱۲");                                   // "0912"
isValidPostalCode("۱۱۹۳۶-۵۳۴۷۱");                     // true
formatPlate({ first: "12", letter: "ب", middle: "345", region: "67" }); // "۱۲ ب ۳۴۵ ایران ۶۷"
parseTime("۹۳۰");                                     // { hours: 9, minutes: 30 }

تبدیل تاریخ برای همهٔ روزهای سال‌های ۱۳۰۰ تا ۱۵۰۰ با تقویم persian کتابخانهٔ ICU تست شده است.

مستندات کامل: kashi.sepantapouya.com · کد: GitHub · لایسنس MIT

版本与发布记录

@kashi-ui/persian 共发布 20 个版本,首次发布于 2026/10/27;过去 12 个月发布了 20 个版本。

版本发布日期距今
0.20.0latest2026/11/011 天前
0.19.02026/11/012 天前
0.18.02026/10/294 天前
0.17.02026/10/295 天前
0.16.02026/10/295 天前
0.15.02026/10/286 天前

关于 @kashi-ui/persian 的常见问题

@kashi-ui/persian 是什么?

ابزارهایفارسیکاشی:تاریخشمسی،اعتبارسنجیکدملیوشمارهکارت،ارقامفارسی

如何安装 @kashi-ui/persian?

在项目目录运行 npm install @kashi-ui/persian,或使用 pnpm add / yarn add / bun add。

@kashi-ui/persian 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@kashi-ui/persian 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@kashi-ui/persian 可以商用吗?

@kashi-ui/persian 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@kashi-ui/persian 还在维护吗?

最新版本 0.20.0 发布于 2026/11/01(1 天前);至今共发布 20 个版本,其中过去 12 个月发布了 20 个;首次发布于 2026/10/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。