روش JavaScript Number toLocaleString()

تعریف و استفاده

toLocaleString() با استفاده از فرمت زبان محلی، عدد را به عنوان رشته بازمی‌گرداند.

فرمت زبان وابسته به تنظیمات منطقه‌ای کامپیوتر شماست.

مثال

مثال 1

استفاده از تنظیمات منطقه‌ای برای تبدیل عدد به رشته:

let num = 1000000;
let text = num.toLocaleString();

آزمایش کنید

مثال 2

استفاده از محیط زبانی خاص فنلاند برای تبدیل عدد به رشته:

let num = 1000000;
let text = num.toLocaleString("fi-FI");

آزمایش کنید

مثال 3

استفاده از محیط زبانی خاص ایالات متحده برای تبدیل عدد به رشته پولی:

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

آزمایش کنید

مثال 4

استفاده از options پارامتر (شیء) برای فرمت‌دهی پول:

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

آزمایش کنید

مثال 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

آزمایش کنید

مثال 6

استفاده از محیط زبان خاص JAPAN:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

آزمایش کنید

نحوه

number.toLocaleString(locales, options)

پارامتر

پارامتر توضیح
locales اختیاری. فرمت زبان خاص مورد استفاده. لطفاً جدول زیر را ببینید.
options اختیاری. یک شیء با گزینه‌های فرمت. لطفاً جدول زیر را ببینید.

locales مقدارهای پذیرفته شده:

  • ar-SA عربی (عربستان سعودی)
  • bn-BD بنگالی (بنگلادش)
  • bn-IN بنگالی (هند)
  • cs-CZ چک (جمهوری چک)
  • da-DK دانمارکی (دانمارک)
  • de-AT آلمانی اتریش
  • de-CH آلمانی سوئیس
  • de-DE آلمانی استاندارد (در آلمان استفاده می‌شود)
  • el-GR یونانی مدرن
  • en-AU انگلیسی استرالیا
  • en-CA انگلیسی کانادا
  • en-GB انگلیسی بریتانیا
  • en-IE انگلیسی ایرلند
  • en-IN انگلیسی هند
  • en-NZ انگلیسی نیوزیلند
  • en-US انگلیسی امریکا
  • en-ZA انگلیسی (آفریقای جنوبی)
  • es-AR اسپانیایی آرژانتین
  • es-CL اسپانیایی شیلی
  • es-CO اسپانیایی کلمبیا
  • es-ES اسپانیایی کاستیلیا (در شمال و مرکز اسپانیا استفاده می‌شود)
  • es-MX اسپانیایی مکزیک
  • es-US اسپانیایی امریکا
  • fi-FI فنلاندی (فنلاند)
  • fr-BE فرانسوی بلژیک
  • fr-CA فرانسوی کانادا
  • fr-CH فرانسوی سوئیس
  • fr-FR فرانسوی استاندارد (بخصوص در فرانسه)
  • he-IL عبرانی (اسرائیل)
  • hi-IN هندی (هند)
  • hu-HU مجاریایی (مجاریا)
  • id-ID اندونزیایی (اندونزی)
  • it-CH ایتالیایی (سوئیس)
  • it-IT ایتالیایی استاندارد (در ایتالیا استفاده می‌شود)
  • ja-JP ژاپنی (ژاپن)
  • ko-KR کره‌ای (جمهوری کره)
  • nl-BE هلندی بلژیک
  • nl-NL هلندی استاندارد (هلندی)
  • no-NO نروژی (نروژ)
  • pl-PL پولندی (پولند)
  • pt-BR پورتوگالی برزیل
  • pt-PT پورتوگالی اروپایی (نوشتار و گفتار پورتوگالی)
  • ro-RO رومانیایی (رومانی)
  • ru-RU روسی (فدراسیون روسیه)
  • sk-SK اسلواک (اسلواک)
  • sv-SE سوئد (سوئد)
  • ta-IN تامیل (هند)
  • ta-LK تامیل (سریلانکا)
  • th-TH تایلند (تایلند)
  • tr-TR ترکی (ترکیه)
  • zh-CN چین بزرگ، با خط ساده
  • zh-HK هنگ کنگ، با خط فشرده
  • zh-TW تایوان، با خط فشرده

options گزینه‌هایی که پارامتر می‌پذیرد:

گزینه‌ها مقدار
currency مقدارهای مجاز: هر کد ارز (مانند "EUR", "USD", "INR" و غیره)
currencyDisplay

مقدارهای مجاز:

  • "symbol"(مقدار پیش‌فرض)
  • "code"
  • "name"
localeMatcher

مقدارهای مجاز:

  • "best-fit"(مقدار پیش‌فرض)
  • "lookup"
maximumFractionDigits عدد از 0 تا 20 (مقدار پیش‌فرض 3 است)
maximumSignificantDigits عدد از 1 تا 21 (مقدار پیش‌فرض 21 است)
minimumFractionDigits عدد از 0 تا 20 (مقدار پیش‌فرض 3 است)
minimumIntegerDigits عدد از 1 تا 21 (مقدار پیش‌فرض 1 است)
minimumSignificantDigits عدد از 1 تا 21 (مقدار پیش‌فرض 21 است)
style

مقدارهای مجاز:

  • "currency"
  • "decimal"(مقدار پیش‌فرض)
  • "percent"
useGrouping

مقدارهای مجاز:

  • "true"(مقدار پیش‌فرض)
  • "false"

مقدار بازگشتی

نوع توضیح
متنی نمایانش متنی عدد محلی.

جزئیات فنی

مقدار بازگشتی

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

پرتاب

استثنا توضیح
TypeError استثنایی که وقتی شیء فراخوانی این روش نه عدد است، پرتاب می‌شود.

پشتیبانی مرورگر

toLocaleString() این ویژگی ECMAScript3 (ES3) است.

همه مرورگرها به طور کامل ES3 (JavaScript 1999) را پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی