docs(10_Wiki): W3Schools 위키화 — HTML/CSS/JavaScript(core)
W3Schools 튜토리얼을 P-Reinforce v3.1 포맷으로 위키화(영어 본문, 한/영 섹션 헤더). - Topic_HTML: 59문서 (튜토리얼+예제, 레퍼런스/메타 제외) - Topic_CSS: 190문서 (메인 + Advanced/Flexbox/Grid/RWD 전체) - Topic_JavaScript: 120문서 (코어 언어; Temporal/DOM상세/BOM/WebAPI/AJAX/jQuery/Graphics 등은 후속) 각 폴더 00_INDEX.md(MOC) 포함. 코드 verbatim, 미확인분은 "Not found in source" 표기. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,177 @@
|
||||
---
|
||||
id: javascript-tolocalestring
|
||||
title: "JavaScript toLocaleString"
|
||||
category: "Frontend"
|
||||
status: "draft"
|
||||
verification_status: "conceptual"
|
||||
canonical_id: ""
|
||||
aliases: ["toLocaleString", "toLocaleString()", "JS toLocaleString", "locale formatting", "currency formatting", "number localization"]
|
||||
duplicate_of: ""
|
||||
source_trust_level: "B"
|
||||
confidence_score: 0.88
|
||||
created_at: 2026-06-23
|
||||
updated_at: 2026-06-23
|
||||
review_reason: ""
|
||||
merge_history: []
|
||||
tags: ["javascript", "js", "web", "frontend", "w3schools", "tolocalestring", "i18n", "formatting"]
|
||||
raw_sources: ["https://www.w3schools.com/js/js_tolocalestring.asp"]
|
||||
applied_in: []
|
||||
github_commit: ""
|
||||
---
|
||||
|
||||
# [[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]
|
||||
```javascript
|
||||
let num = 1234567.89;
|
||||
|
||||
let text = num.toLocaleString();
|
||||
```
|
||||
|
||||
**Using Locales** — Specify language and country codes for locale-specific formatting: [S1]
|
||||
```javascript
|
||||
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]
|
||||
```javascript
|
||||
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]
|
||||
```javascript
|
||||
let score = 0.875;
|
||||
|
||||
let result = score.toLocaleString("en-US", {style:"percent"});
|
||||
```
|
||||
|
||||
**Controlling Decimal Digits** [S1]
|
||||
```javascript
|
||||
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]
|
||||
```javascript
|
||||
let date = new Date();
|
||||
|
||||
let text = date.toLocaleString("en-US");
|
||||
```
|
||||
|
||||
**Date Formatting Options** [S1]
|
||||
```javascript
|
||||
let date = new Date();
|
||||
|
||||
let text = date.toLocaleString("en-US", {
|
||||
weekday: "long",
|
||||
year: "numeric",
|
||||
month: "long",
|
||||
day: "numeric"
|
||||
});
|
||||
```
|
||||
|
||||
**Readable File Sizes Example** [S1]
|
||||
```javascript
|
||||
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]
|
||||
```javascript
|
||||
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):
|
||||
```javascript
|
||||
let price = 1299.95;
|
||||
let dollars = price.toLocaleString("en-US", {style:"currency", currency:"USD"});
|
||||
```
|
||||
Spell out a date in a given locale:
|
||||
```javascript
|
||||
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).
|
||||
Reference in New Issue
Block a user