مرکز توسعهدهندگان
ابزارهای فارسی برای توسعهدهندگان
از توابع آماده برای تاریخ، متن، اعتبارسنجی و محاسبات مالی در پروژههای وب و بکاند استفاده کنید. کتابخانه کامل با TypeScript، API endpointها و documentation.
کاملاً آفلاین
هیچ دادهای به سرور ارسال نمیشود و همه پردازشها محلی است.
تایپسیف و سریع
TypeScript strict + بدون وابستگی خارجی در زمان اجرا.
کاربردهای مالی
محاسبات وام، حقوق، سود و تبدیل ریال/تومان.
تاریخ شمسی
تبدیل شمسی/میلادی/قمری با خروجی استاندارد.
API Endpointها
REST API کامل با احراز هویت و rate limiting.
Storage Layer
PostgreSQL + SQLite برای ذخیرهسازی دائمی و کش.
نصب کتابخانه
بستهی persian-tools را مستقیماً در پروژه نصب کنید و از ماژولها استفاده کنید.
نصب با pnpm
pnpm add persian-tools
نصب با npm
npm install persian-tools
نصب با yarn
yarn add persian-tools
نمونه کدها
نمونه کدهای جامع برای شروع سریع در پروژههای واقعی.
اعداد و تبدیلها
import { parseLooseNumber, numberToWordsFa } from 'persian-tools';
const parsed = parseLooseNumber('۱۲٬۳۴۵٫۶۷');
const words = numberToWordsFa(parsed ?? 0);
console.log(parsed, words);تاریخ و تقویم
import { convertDate, formatPersianDate } from 'persian-tools';
const result = convertDate({
from: 'jalali',
to: 'gregorian',
date: { year: 1403, month: 1, day: 1 },
});
console.log(formatPersianDate(new Date()));
console.log(result);اعتبارسنجی ایرانی
import { isValidNationalId, isValidIranianMobile } from 'persian-tools';
console.log(isValidNationalId('0010350829'));
console.log(isValidIranianMobile('09123456789'));محاسبات مالی
import { calculateLoan, calculateCompoundInterest } from 'persian-tools';
const loan = calculateLoan({
amount: 50000000,
rate: 18,
months: 24,
});
const compound = calculateCompoundInterest({
principal: 100000000,
rate: 20,
periods: 12,
frequency: 'monthly',
});دستهبندی ماژولها
- اعداد و فرمتدهی: parseLooseNumber، numberToWordsFa، formatMoneyFa
- متن فارسی: cleanPersianText، normalizePersianChars، slugifyPersian
- اعتبارسنجی: کد ملی، موبایل، شبا، کارت بانکی، کدپستی
- مالی: محاسبه وام، حقوق، مالیات و سود مرکب
- تاریخ: تبدیل شمسی/میلادی/قمری، فرمت تاریخ فارسی
- Validation: اعتبارسنجی ایمیل، URL، phone number، national ID
مستندات و مثالها
برای مشاهده جزئیات توابع، از مستندات Typedoc و مثالهای پوشهی examples استفاده کنید.
مسیر مستندات API: docs/api
مثالها: examples/
TypeScript types: dist/index.d.ts
API Endpointها
| Method | Endpoint | توضیحات |
|---|---|---|
GET | /api/health | بررسی سلامت سرویس (uptime, memory, version) |
GET | /api/version | نسخه جاری سرویس |
GET | /api/market | نرخ لحظهای ارز و طلا |
GET | /api/data/salary-laws | قوانین حقوق و دستمزد ۱۴۰۵ |
GET | /api/public/stats | آمار عمومی سایت |
GET | /api/site-settings | تنظیمات عمومی سایت (SEO, social links) |
POST | /api/auth/register | ثبتنام کاربر جدید |
POST | /api/auth/login | ورود به سیستم |
GET | /api/auth/me | اطلاعات کاربر جاری |
POST | /api/analytics | ارسال رویداد analytics |
فرمتکننده JSON
JSON خود را فرمت یا مینیفای کنید.
رمزگذاری و رمزگشایی Base64
متن را به Base64 تبدیل کنید یا برعکس.