2nd/10_Wiki/Topics/Domain_Programming/Topic_JavaScript/JavaScript_toLocaleString.md

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit

id	title	category	status	verification_status	canonical_id	aliases	duplicate_of	source_trust_level	confidence_score	created_at	updated_at	review_reason	merge_history	tags	raw_sources	applied_in	github_commit
javascript-tolocalestring	JavaScript toLocaleString	Frontend	draft	conceptual		toLocaleString toLocaleString() JS toLocaleString locale formatting currency formatting number localization		B	0.88	2026-06-23	2026-06-23			javascript js web frontend w3schools tolocalestring i18n formatting	https://www.w3schools.com/js/js_tolocalestring.asp

JavaScript toLocaleString

🎯 한 줄 통찰 (One-line insight)

toLocaleString() converts a value to a string using local formatting rules, making it the built-in way to render numbers, dates, currencies, and percentages per a given locale. [S1]

🧠 핵심 개념 (Core concepts)

• Locale-aware conversion — The toLocaleString() method converts a value to a string using local formatting rules. [S1]
• Broad type support — It is available for Numbers, Dates, Arrays, and BigInts. [S1]
• Locale argument — Pass a language-and-country code (e.g. "en-US", "de-DE", "no-NO") for locale-specific formatting. [S1]
• Options object — A second options argument controls style (currency/percent), currency, fraction digits, and date field formats. [S1]
• Correct spelling — The method name is toLocaleString(), not toLocalString(); "locale" means a language and country format. [S1]

🧩 추출된 패턴 (Extracted patterns)

• Locale + options pair — Most calls take (locale, optionsObject) to pin both the regional format and the desired style. [S1]
• Currency/percent styling — Set {style:"currency", currency:"USD"} or {style:"percent"} to format money and ratios. [S1]
• Fraction-digit control — Use minimumFractionDigits / maximumFractionDigits to cap or pad decimals. [S1]
• Human-readable date fields — Supply {weekday, year, month, day} formats to spell out dates. [S1]

📖 세부 내용 (Details)

JavaScript toLocaleString() Method The toLocaleString() method converts a value to a string using local formatting rules. It is available for Numbers, Dates, Arrays, and BigInts. [S1]

Basic example: [S1]

let num = 1234567.89;

let text = num.toLocaleString();

Using Locales — Specify language and country codes for locale-specific formatting: [S1]

let num = 1234567.89;

let us = num.toLocaleString("en-US");
let de = num.toLocaleString("de-DE");
let no = num.toLocaleString("no-NO");

Formatting Currency [S1]

let price = 1299.95;

let dollars = price.toLocaleString("en-US",
{style:"currency", currency:"USD"});

let euros = price.toLocaleString("de-DE",
{style:"currency", currency:"EUR"});

let kroner = price.toLocaleString("no-NO",
{style:"currency", currency:"NOK"});

Formatting Percentages [S1]

let score = 0.875;

let result = score.toLocaleString("en-US", {style:"percent"});

Controlling Decimal Digits [S1]

let num = 3.14159;

let text = num.toLocaleString("en-US", {
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});

Note "The method name is toLocaleString(), not toLocalString(). The word locale means a language and country format, such as "en-US", "de-DE", or "no-NO"." [S1]

Formatting Dates [S1]

let date = new Date();

let text = date.toLocaleString("en-US");

Date Formatting Options [S1]

let date = new Date();

let text = date.toLocaleString("en-US", {
  weekday: "long",
  year: "numeric",
  month: "long",
  day: "numeric"
});

Readable File Sizes Example [S1]

function fileSize(bytes) {
  if (bytes < 1024) return bytes + " bytes";
  if (bytes < 1024 * 1024) return (bytes / 1024).toLocaleString("en-US", {maximumFractionDigits: 1}) + " KB";
  return (bytes / 1024 / 1024).toLocaleString("en-US", {maximumFractionDigits: 1}) + " MB";
}

let size = 1536000;
let text = fileSize(size);

Arrays and toLocaleString() [S1]

const dates = [
  new Date("2026-01-01"),
  new Date("2026-12-24")
];

let text = dates.toLocaleString("en-US");

🛠️ 적용 사례 (Applied in summary)

The page's own snippets are the canonical applied examples — locale number formatting, currency in USD/EUR/NOK, percentages, fraction-digit control, date field formatting, and a fileSize() helper. No external project/commit applications found in the source.

💻 코드 패턴 (Code patterns)

Format a number as USD currency (language: JavaScript):

let price = 1299.95;
let dollars = price.toLocaleString("en-US", {style:"currency", currency:"USD"});

Spell out a date in a given locale:

let date = new Date();
let text = date.toLocaleString("en-US", {
  weekday: "long",
  year: "numeric",
  month: "long",
  day: "numeric"
});

⚖️ 비교 및 선택 기준 (Comparison & decision criteria)

• toLocaleString() vs toString() — toString() produces a fixed, machine-style representation; toLocaleString() applies regional formatting rules (separators, currency symbols, date wording) driven by a locale argument. Choose toLocaleString() when output is shown to users in a specific region, and toString() for a stable, locale-independent string. [S1]

⚖️ 모순 및 업데이트 (Contradictions & updates)

No contradictions found in the source. (The page explicitly warns against the common misspelling toLocalString().)

✅ 검증 상태 및 신뢰도

• 상태: draft
• 검증 단계: conceptual (실제 적용 사례 발견 시 applied/validated로 승격 가능)
• 출처 신뢰도: B (W3Schools — widely used educational reference, not a primary standards body)
• 신뢰 점수: 0.88
• 중복 검사 결과: 신규 생성 (New discovery)

🔗 지식 그래프 (Knowledge Graph)

• 상위/루트: JavaScript Tutorial
• 관련 개념: JavaScript toString, JavaScript Type Conversion, JavaScript NaN, JavaScript Introduction
• 참조 맥락: Referenced whenever displaying numbers, money, percentages, or dates formatted for a user's region.

📚 출처 (Sources)

• [S1] W3Schools — JavaScript toLocaleString — https://www.w3schools.com/js/js_tolocalestring.asp

📝 변경 이력 (Change history)

• 2026-06-23: Initial draft synthesized from the W3Schools "JavaScript toLocaleString" page (Astra wiki-curation, P-Reinforce v3.1 format).