تبدیل اعداد به حروف فارسی با Abdal Number to Persian Words

کتابخانه Abdal Number to Persian Words ابزاری قدرتمند برای تبدیل اعداد به حروف فارسی است که از اعداد بزرگ، اعشاری و واحدهای سفارشی مانند تومان یا ریال پشتیبا...

انتشار: , زمان مطالعه: 4 دقیقه
تبدیل اعداد به حروف فارسی با Abdal Number to Persian Words
دسته بندی: تیم ابدال تعداد بازدید: 251

در بسیاری از برنامه‌های فارسی‌زبان، نیاز به تبدیل اعداد به حروف فارسی وجود دارد. این نیاز می‌تواند در سیستم‌های مالی، تولید فاکتور، و سایر کاربردهای مشابه مطرح شود. کتابخانه Abdal Number to Persian Words، توسعه‌یافته توسط ابراهیم شفیعی (ابراشا)، ابزاری قدرتمند برای انجام این تبدیل با دقت و صحت بالا است.

قابلیت‌های کتابخانه Abdal Number to Persian Words

  • پشتیبانی از اعداد بسیار بزرگ:
    قابلیت تبدیل اعداد تا سیدسیلیارد (10^99) به حروف فارسی، بدون افت دقت یا محدودیت در طول عدد.

  • تبدیل اعداد اعشاری با دقت بالا:
    پشتیبانی از اعداد اعشاری تا 15 رقم اعشار. این امکان فراهم شده که اعداد اعشاری به شکل دقیق و کامل به حروف فارسی تبدیل شوند، با خوانایی بالا.

  • واحدهای سفارشی:
    می‌توانید واحدهای پولی یا سفارشی مانند "تومان"، "ریال" یا هر واحد دیگری را به خروجی اضافه کنید، که برای کاربردهای مالی و تجاری ایده‌آل است.

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

  • انعطاف‌پذیری بالا:
    این کتابخانه برای پروژه‌های مالی، سیستم‌های فاکتورینگ، و دیگر پروژه‌هایی که نیاز به تبدیل اعداد به حروف فارسی دارند، بهینه شده است.

  • بدون محدودیت در اندازه اعداد:
    توانایی تبدیل اعداد تا حداکثر حافظه قابل پشتیبانی سیستم، بدون هیچ محدودیتی در مقیاس عدد.

  • پشتیبانی از منفی و ممیز:
    امکان تبدیل اعداد منفی (مانند -123) و اعداد اعشاری (مانند 123.456) با مقیاس‌های کوچک و بزرگ وجود دارد.

  • سازگاری کامل:
    کتابخانه در مرورگرها و محیط‌های سرور (مانند Node.js) به راحتی قابل استفاده است، که باعث افزایش کارایی در انواع پروژه‌ها می‌شود.

نصب و راه‌اندازی

پیش‌نیازها برای اجرا

برای اجرای Abdal Number to Persian Words، به موارد زیر نیاز دارید:

مرورگر وب مدرن: مرورگرهایی مانند Chrome، Firefox، یا Edge که از جاوااسکریپت ES6 پشتیبانی می‌کنند.

پشتیبانی از جاوااسکریپت: اگر کد در محیط مرورگر اجرا می‌شود، نیازی به تنظیمات اضافی نیست.

پیش‌نیازها برای نصب

  • Node.js: نسخه 12 یا بالاتر برای نصب و اجرای پروژه.

  • مدیر بسته‌ها: npm یا yarn برای نصب کتابخانه.

نصب از npm:

برای نصب کتابخانه با npm  ، می‌توانید به راحتی به صورت زیراقدام کنید:

npm install abdal-number-to-persian-words

نحوه استفاده

1. در Node.js:

کتابخانه را به پروژه خود وارد کنید:

const { numberToWords } = require('abdal-number-to-persian-words');

// تبدیل عدد به حروف فارسی
console.log(numberToWords(123456789, "تومان"));
// خروجی: صد و بیست و سه میلیون و چهارصد و پنجاه و شش هزار و هفتصد و هشتاد و نه تومان

2. در مرورگر (Browser):

فایل کتابخانه در پوشه dist است را به پروژه HTML خود اضافه کنید:
<script src="path/to/abdal-number-to-persian-words.js"></script>
<script>
    console.log(AbdalNumberToWords.numberToWords(123456789, "ریال"));
    // خروجی: صد و بیست و سه میلیون و چهارصد و پنجاه و شش هزار و هفتصد و هشتاد و نه ریال
</script>

برای استفاده در زمانی که فیلد های ورودی دارید

<script>
 
    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);

</script>

یا می توانید از CDN استفاده کنید

<script src="https://cdn.jsdelivr.net/gh/ebrasha/[email protected]/dist/abdal-number-to-persian-words.js"></script>

 

لیست اعداد بزرگی که پشتیبانی می‌کند

کتابخانه Abdal Number to Persian Words توانایی تبدیل اعداد بزرگ تا سیدسیلیارد را دارد. لیست کامل مقیاس‌های پشتیبانی‌شده عبارتند از: یک، هزار، میلیون، میلیارد، بیلیون، بیلیارد، تریلیون، تریلیارد، کوآدریلیون، کادریلیارد، کوینتیلیون، کوینتیلیارد، سکستیلیون، سکستیلیارد، سپتیلیون، سپتیلیارد، اکتیلیون، اکتیلیارد، نانیلیون، نانیلیارد، دسیلیون، دسیلیارد، آندسیلیون، آندسیلیارد، دودسیلیون، دودسیلیارد، تریدسیلیون، تریدسیلیارد، کوادردسیلیون، کوادردسیلیارد، کویندسیلیون، کویندسیلیارد، سیدسیلیون، سیدسیلیارد.

این مقیاس‌ها به شما امکان می‌دهند اعداد بسیار بزرگ را به حروف فارسی با دقت و صحت کامل تبدیل کنید.

 دسترسی به کتابخانه

برای مشاهده کد منبع و مستندات کامل کتابخانه Abdal Number to Persian Words، می‌توانید به مخزن رسمی آن در GitHub مراجعه کنید.

اینجا کلیک کنید تا به صفحه رسمی این کتابخانه در GitHub هدایت شوید و از کد و مستندات آن استفاده کنید.


دیدگاه های مربوط به این مقاله (برای ارسال دیدگاه در سایت حتما باید عضو باشید و پروفایل کاربری شما تکمیل شده باشد)