本地化

Wiki ▸ API--中文手册 ▸ 核心函数 ▸ 本地化

按语言和地区格式化数字、日期和不同的货币。D3默认的支持英语，你可以按照需要加载新的本地化来改变D3的格式化行为。

# 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(specifier)

d3.format本地化。

# locale.timeFormat(specifier)

d3.time.format本地化。

# locale.timeFormat.utc(specifier)

d3.time.format.utc本地化。