https://github.com/ebrasha/abdal-number-to-persian-words
کتابخانه تبدیل اعداد به حروف فارسی ابدال یک ابزار قدرتمند برای تبدیل اعداد تا 10 به توان 99 به حروف فارسی است که از اعداد بسیار بزرگ، اعشاری و واحدهای سفارشی مانند تومان یا ریال با دقت کامل و رعایت قواعد زبان فارسی پشتیبانی می‌کند.
https://github.com/ebrasha/abdal-number-to-persian-words
abdal abdal-number-to-persian-words ebrahim-shafiei ebrasha farsi number-to-persian-words persian rial toman
Last synced: about 2 months ago
JSON representation
کتابخانه تبدیل اعداد به حروف فارسی ابدال یک ابزار قدرتمند برای تبدیل اعداد تا 10 به توان 99 به حروف فارسی است که از اعداد بسیار بزرگ، اعشاری و واحدهای سفارشی مانند تومان یا ریال با دقت کامل و رعایت قواعد زبان فارسی پشتیبانی می‌کند.
- Host: GitHub
- URL: https://github.com/ebrasha/abdal-number-to-persian-words
- Owner: ebrasha
- License: mit
- Created: 2025-01-02T18:44:49.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-01-03T18:29:31.000Z (5 months ago)
- Last Synced: 2025-03-25T21:36:03.100Z (3 months ago)
- Topics: abdal, abdal-number-to-persian-words, ebrahim-shafiei, ebrasha, farsi, number-to-persian-words, persian, rial, toman
- Language: JavaScript
- Homepage:
- Size: 52.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Abdal Number to Persian Words
## 💎 هدف اصلی
هدف اصلی از ساخت کتابخانه **Abdal Number to Persian Words** ارائه ابزاری قدرتمند و کارآمد برای تبدیل اعداد به حروف فارسی است. این کتابخانه با قابلیت پشتیبانی از اعداد بسیار بزرگ (تا **سیدسیلیارد**) و اعداد اعشاری، راه‌حلی جامع برای پروژه‌هایی که نیاز به تبدیل دقیق اعداد به متن فارسی دارند، فراهم می‌کند.
این ابزار به گونه‌ای طراحی شده است که بتواند در کاربردهای مختلف از جمله سیستم‌های مالی، تولید فاکتور، و برنامه‌های فارسی‌زبان مورد استفاده قرار گیرد. **Abdal Number to Persian Words** محدودیت‌های رایج کتابخانه‌های مشابه را پشت سر گذاشته و با رعایت کامل قواعد زبان فارسی، امکان افزودن واحدهای سفارشی مانند تومان یا ریال را نیز فراهم کرده است.
## 🛠️ پیش نیاز برای برنامه نویسان
برای استفاده از کتابخانه **Abdal Number to Persian Words**، نیاز به محیط جاوااسکریپت با پشتیبانی از ماژول‌های ES6 دارید. در زیر پیش‌نیازهای لازم برای شروع آمده است:
1. **Node.js**: نسخه 12 یا بالاتر (برای نصب و اجرای پروژه).
2. **مدیریت بسته‌ها**: npm یا yarn برای نصب کتابخانه.
3. **دانش پایه**: آشنایی با جاوااسکریپت و مدیریت پروژه‌های Node.js.
4. **ابزار توسعه**:
- ویرایشگر کد مانند VS Code یا WebStorm.
- دسترسی به اینترنت برای دانلود کتابخانه از GitHub یا npm.
### 🔥 پیش‌نیازها برای اجرا
برای اجرای **Abdal Number to Persian Words**، به موارد زیر نیاز دارید:
1. **مرورگر وب مدرن**:
- مرورگرهایی مانند Chrome، Firefox، یا Edge که از جاوااسکریپت ES6 پشتیبانی می‌کنند.
2. **پشتیبانی از جاوااسکریپت**:
- اگر کد در محیط مرورگر اجرا می‌شود، نیازی به تنظیمات اضافی نیست.
## ✨ قابلیت ها
1. **پشتیبانی از اعداد بسیار بزرگ**:
- قابلیت تبدیل اعداد تا **سیدسیلیارد** (10^99) به حروف فارسی.
2. **تبدیل اعداد اعشاری با دقت بالا**:
- پشتیبانی از اعداد اعشاری تا **15 رقم اعشار**. اعداد اعشاری به شکل دقیق و کامل به حروف فارسی تبدیل می‌شوند.
3. **واحدهای سفارشی**:
- امکان افزودن واحدهای پولی یا سفارشی مانند "تومان" یا "ریال" به خروجی.
4. **دقت در قواعد زبان فارسی**:
- خوانش روان و رعایت کامل دستور زبان فارسی برای تولید متون.
5. **انعطاف‌پذیری بالا**:
- مناسب برای پروژه‌های مالی، سیستم‌های فاکتورینگ، و هر نوع پروژه‌ای که نیاز به تبدیل اعداد به حروف فارسی دارد.
6. **بدون محدودیت در اندازه اعداد**:
- تا حداکثر حافظه قابل پشتیبانی سیستم، بدون محدودیت.
7. **پشتیبانی از منفی و ممیز**:
- امکان تبدیل اعداد منفی و اعداد اعشاری با مقیاس‌های کوچک و بزرگ.
8. **سازگاری کامل**:
- قابل استفاده در مرورگرها و محیط‌های سرور (مانند Node.js).
### لیست اعداد بزرگی که پشتیبانی می‌کند
کتابخانه **Abdal Number to Persian Words** توانایی تبدیل اعداد بزرگ تا **سیدسیلیارد** را دارد. در زیر لیست کامل مقیاس‌هایی که این کتابخانه پشتیبانی می‌کند، آمده است:
- یک
- هزار
- میلیون
- میلیارد
- بیلیون
- بیلیارد
- تریلیون
- تریلیارد
- کوآدریلیون
- کادریلیارد
- کوینتیلیون
- کوینتیلیارد
- سکستیلیون
- سکستیلیارد
- سپتیلیون
- سپتیلیارد
- اکتیلیون
- اکتیلیارد
- نانیلیون
- نانیلیارد
- دسیلیون
- دسیلیارد
- آندسیلیون
- آندسیلیارد
- دودسیلیون
- دودسیلیارد
- تریدسیلیون
- تریدسیلیارد
- کوادردسیلیون
- کوادردسیلیارد
- کویندسیلیون
- کویندسیلیارد
- سیدسیلیون
- سیدسیلیارد
## 🚀 نحوه نصب و استفاده
### نصب کتابخانه
برای استفاده از **Abdal Number to Persian Words**، می‌توانید از دو روش زیر استفاده کنید:
#### 1. **نصب از مخزن GitHub**:
مخزن این کتابخانه را کلون کرده و به پروژه خود اضافه کنید:
```bash
git clone https://github.com/ebrasha/abdal-number-to-persian-words.git
```
سپس فایل اصلی را در پروژه خود وارد کنید.
#### 2. **نصب از npm**:
اگر کتابخانه روی npm منتشر شده است، می‌توانید به راحتی آن را نصب کنید:
```bash
npm install abdal-number-to-persian-words
```
### نحوه استفاده
##### 1. در Node.js:
کتابخانه را به پروژه خود وارد کنید:
```javascript
const { numberToWords } = require('abdal-number-to-persian-words');
// تبدیل عدد به حروف فارسی
console.log(numberToWords(123456789, "تومان"));
// خروجی: صد و بیست و سه میلیون و چهارصد و پنجاه و شش هزار و هفتصد و هشتاد و نه تومان
```
#### 2. در مرورگر (Browser):
فایل کتابخانه در پوشه dist است را به پروژه HTML خود اضافه کنید:
```javascript
console.log(AbdalNumberToWords.numberToWords(123456789, "ریال"));
// خروجی: صد و بیست و سه میلیون و چهارصد و پنجاه و شش هزار و هفتصد و هشتاد و نه ریال
```
برای استفاده در زمانی که فیلد های ورودی دارید
```javascript
function updateOutput() {
const numberInput = document.getElementById('charge_amount'); // دریافت ورودی عدد
const unitInput = document.getElementById('unit'); // دریافت ورودی واحد
const outputElement = document.getElementById('output'); // دریافت خروجی
const numberValue = numberInput.value.replace(/,/g, ''); // حذف کاما از ورودی عدد
const unitValue = unitInput.value.trim(); // دریافت مقدار واحد
try {
const words = AbdalNumberToWords.numberToWords(numberValue, unitValue); // تبدیل عدد به حروف فارسی
outputElement.textContent = words; // نمایش نتیجه در خروجی
} catch (error) {
outputElement.textContent = "Error: Invalid input."; // نمایش پیام خطا
}
}
// اتصال رویداد به ورودی‌ها
document.getElementById('charge_amount').addEventListener('input', updateOutput);
document.getElementById('unit').addEventListener('input', updateOutput);
```
یا می توانید از CDN استفاده کنید
```javascript
```
##### امکانات نمونه:
1. اعداد اعشاری:
```javascript
console.log(numberToWords(123456.789, "ریال"));
// خروجی: صد و بیست و سه هزار و چهارصد و پنجاه و شش ممیز هفتصد و هشتاد و نه صدم ریال
```
2. اعداد منفی:
```javascript
console.log(numberToWords(-12345, "تومان"));
// خروجی: منفی دوازده هزار و سیصد و چهل و پنج تومان
```
3. اعداد بدون واحد:
```javascript
console.log(numberToWords(987654321));
// خروجی: نهصد و هشتاد و هفت میلیون و ششصد و پنجاه و چهار هزار و سیصد و بیست و یک
```
## ❤️ کمک به پروژه
https://alphajet.ir/abdal-donation
## 🤵 برنامه نویس
دست ساز با عشق توسط ابراهیم شفیعی (ابراشا)
E-Mail = [email protected]
Telegram: https://t.me/ProfShafiei
## ☠️ گزارش خطا
اگر با مشکلی در پیکربندی مواجه هستید یا چیزی آنطور که انتظار دارید کار نمی‌کند، لطفا از [email protected] استفاده کنید.طرح مشکلات بر روی GitLab یا Github نیز پذیرفته می‌شوند.