طريقة 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 يتم إلقاء استثناء عند استدعاء هذا الطريقة على عنوان غير Number.

دعم المتصفح

toLocaleString() هو خاصية ECMAScript3 (ES3).

جميع المتصفحات تدعم ES3 (JavaScript 1999) بشكل كامل:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
الدعم الدعم الدعم الدعم الدعم الدعم