# اعداد فارسی و دقت مبالغ

نمایش خوانا بدون تغییر مقدار واقعی مبلغ، قیمت و تعداد.

وضعیت: پیاده‌سازی‌شده | مخاطب: کاربران و توسعه‌دهندگان رابط
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## قالب نمایش

فیلدهای مبلغ، قیمت و تعداد از نمایش ارقام فارسی و گروه‌بندی سه‌رقمی مانند ۱٬۲۵۰٬۰۰۰ پشتیبانی می‌کنند. در زبان انگلیسی، همان مقدار با رقم لاتین و جداکنندهٔ مناسب نمایش داده می‌شود؛ برای عربی نیز رقم‌های عربی پیش‌بینی شده‌اند.

فیلد عددی خالی، صفر نمایش می‌دهد اما مدل داخلی می‌تواند همچنان خالی باشد تا ورود مبلغ مثبت و اعتبارسنجی با مقدار ساخته‌شده اشتباه نشود.

## ورود و ویرایش عدد

کاربر می‌تواند رقم فارسی، عربی یا لاتین وارد یا جای‌گذاری کند. جداکننده‌ها و نشانهٔ اعشار به مدل دهدهی استاندارد تبدیل می‌شوند. جابه‌جایی نشانگر و حذف کنار جداکننده با گروه‌بندی هماهنگ شده است.

مدل مبلغ رشته‌ای باقی می‌ماند؛ اعشار تایپ‌شده و صفرهای انتهایی بدون تبدیل زودهنگام به عدد ممیز شناور حفظ می‌شوند. توان علمی، عدد منفی و ساختار نامعتبر به‌عنوان مبلغ قابل قبول تلقی نمی‌شوند.

## واحد مالی را از قالب جدا کنید

تغییر رقم یا جداکننده، واحد پول را عوض نمی‌کند. ریال و تومان نسبت ثابت ده به یک دارند و تبدیل USDT به مرجع تازهٔ نرخ نیاز دارد.

دقت تعداد ابزار بازار از همان بازار دریافت می‌شود. پروژهٔ دارای واحد کامل، دقت متفاوتی دارد. جمع موجودی نقدی و محاسبات تخصیص، تا حد لازم با عدد صحیح بزرگ انجام می‌شوند.

## کجا اعمال شده است؟

- ورودی خرید و فروش پروژه و دارایی متصل.
- سرمایه‌گذاری هوشمند و سرمایهٔ آزمایشی کپی‌ترید.
- فرم مبلغ شارژ و هدف هشدار قیمت.
- نمایش مقادیر مرتبط در خروجی‌ها؛ شناسه، موبایل، شبا، تاریخ و رمز این قرارداد مالی را ندارند.

> ناموجود برابر صفر نیست: صفرِ فیلد خالی با نبود قیمت، نبود موجودی معتبر یا اختلال سرویس تفاوت دارد؛ دادهٔ ناموجود همچنان با وضعیت مشخص یا خط تیره نمایش داده می‌شود.

## مراجع پیاده‌سازی

- components/localized-number-input.tsx
- lib/localized-number-input.ts
- lib/investment-amount.ts
- components/investment-amount-input.tsx
- components/token-trade.tsx
- components/market-asset-trade.tsx
- components/cash-wallet.tsx
- tests/localized-number-input.test.mjs