# 本地化
> [Wiki](Home) ? \[\[API--中文手冊\]\] ? \[\[核心函數\]\] ? **本地化**
按語言和地區格式化數字、日期和不同的貨幣。D3默認的支持英語,你可以按照需要加載新的本地化來改變D3的格式化行為。
[\#](#locale) d3.**locale**(*definition*)
返回指定參數*definition*的新的本地化,數字格式的本地化必須包含下列屬性:
- decimal - 數字區域字符串||(例如`"."`)。
- thousands - 組分隔字符串(例如`","`)。
- grouping - 分組大小數組(例如\[3\]),根據需要循環。
- currency - 貨幣前后綴字符串(例如 \["$", ""\])。
(注意:thousands 屬性稍有命名不當,當組定義允許分組而不是幾千。)
本地化定義必須包含以下時間屬性:
- dateTime – 日期和時間(%c) 格式化字符串(例如:"%a %b %e %X %Y")。
- date - 日期 (%x) 格式化字符串(例如:"%m/%d/%Y")。
- time - 時間(%X) 格式化字符串(例如:"%H:%M:%S")。
- periods –本地的上午和下午,同樣(例如:\["AM", "PM"\])。
- days – 星期的全稱,以Sunday開始。
- shortDays -星期的簡稱,以Sunday開始。
- months –月份的全稱,以January開始。
- shortMonths -月份的簡稱,以January開始。
例如默認的美式英語 (en\_US) 本地化定義為:
```
{
"decimal": ".",
"thousands": ",",
"grouping": [3],
"currency": ["$", ""],
"dateTime": "%a %b %e %X %Y",
"date": "%m/%d/%Y",
"time": "%H:%M:%S",
"periods": ["AM", "PM"],
"days": ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"],
"shortDays": ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
"months": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"],
"shortMonths": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
}
```
默認的俄語 (ru\_RU) 本地化定義為:
```
{
"decimal": ",",
"thousands": "\xa0",
"grouping": [3],
"currency": ["", " руб."],
"dateTime": "%A, %e %B %Y г. %X",
"date": "%d.%m.%Y",
"time": "%H:%M:%S",
"periods": ["AM", "PM"],
"days": ["воскресенье", "понедельник", "вторник", "среда", "четверг", "пятница", "суббота"],
"shortDays": ["вс", "пн", "вт", "ср", "чт", "пт", "сб"],
"months": ["января", "февраля", "марта", "апреля", "мая", "июня", "июля", "августа", "сентября", "октября", "ноября", "декабря"],
"shortMonths": ["янв", "фев", "мар", "апр", "май", "июн", "июл", "авг", "сен", "окт", "ноя", "дек"]
}
```
[\#](#locale_numberFormat) locale.**numberFormat**(*specifier*)
[d3.format](Formatting#d3_format)本地化。
[\#](#locale_timeFormat) locale.**timeFormat**(*specifier*)
[d3.time.format](Time-Formatting#format)本地化。
[\#](#locale_timeFormat_utc) locale.timeFormat.**utc**(*specifier*)
[d3.time.format.utc](Time-Formatting#format_utc)本地化。