RU Локализация - Mingun/d3 GitHub Wiki

ВикиСправка по APIЯдроЛокализация
English | Русский

Форматирование чисел, дат и валют зависит от языка и локали. Хотя по умолчанию сборка D3 предназначена для американского английского, вы можете изменить поведение функций форматированя D3, загрузив новые локали при необходимости.

# d3.locale(definition)

Возвращает новую локаль по указанному опеределителю definition. Определитель локали должен включать следующие свойства для форматирвания чисел:

  • decimal — строка, помещаемая на место десятичной запятой (например, ".").
  • thousands — строка, помещаемая на место разделителя разрядов (например, ",").
  • grouping — массив размеров групп (например, [3]), зацикливается при необходимости.
  • currency — строки для префикса и суффикса валюты (например, ["$", ""]).

Обратите внимание, что название свойства thousands (тысячи) немного не соответствует истине, поскольку свойство grouping позволяет групировать не только по тысячам.

Определение локали так же должно включать следующие свойства для форматирования времени:

  • dateTime — формат строки для даты и времени (по %c) (например, "%a %b %e %X %Y").
  • date — формат строки для даты (по %x) (например, "%m/%d/%Y").
  • time — формат строки для времени (по %X) (например, "%H:%M:%S").
  • periods — эквиваленты обозначений A.M. (до полудня) и P.M. (после полудня) в локали (например, ["AM", "PM"]).
  • days — полные названия дней недели, начиная с воскресенья.
  • shortDays — аббревиатуры названий дней недели, начиная с воскресенья.
  • months — полные названия месяцев, начиная с января.
  • shortMonths — аббревиатуры названий месяцев, начиная с января.

Например, локаль по умолчанию для американского английского (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, использующий локаль.

⚠️ **GitHub.com Fallback** ⚠️