> [Wiki](Home) ? [[API--中文手冊]] ? [[核心函數]] ? **本地化**
按語言和地區格式化數字、日期和不同的貨幣。D3默認的支持英語,你可以按照需要加載新的本地化來改變D3的格式化行為。
<a name="locale" href="#locale">#</a> d3.<b>locale</b>(<i>definition</i>)
返回指定參數*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) 本地化定義為:
```json
{
"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) 本地化定義為:
```json
{
"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": ["янв", "фев", "мар", "апр", "май", "июн", "июл", "авг", "сен", "окт", "ноя", "дек"]
}
```
<a name="locale_numberFormat" href="#locale_numberFormat">#</a> locale.<b>numberFormat</b>(<i>specifier</i>)
[d3.format](Formatting#d3_format)本地化。
<a name="locale_timeFormat" href="#locale_timeFormat">#</a> locale.<b>timeFormat</b>(<i>specifier</i>)
[d3.time.format](Time-Formatting#format)本地化。
<a name="locale_timeFormat_utc" href="#locale_timeFormat_utc">#</a> locale.timeFormat.<b>utc</b>(<i>specifier</i>)
[d3.time.format.utc](Time-Formatting#format_utc)本地化。