طريقة 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 Thai（泰国）
  • 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 调用该方法的对象不是 Number 时抛出的异常。

بھرائی جانے والا مرجع

toLocaleString() یہ ECMAScript3 (ES3) کی خصوصیت ہے۔

تمام براوزر ایس3 (جاوا اسکریپٹ 1999) کو پورا طور پر سپورٹ کرتے ہیں

کروم آئی ای ایج فائرفاکس سافری اوپرا
کروم آئی ای ایج فائرفاکس سافری اوپرا
پشتیبندگی پشتیبندگی پشتیبندگی پشتیبندگی پشتیبندگی پشتیبندگی