---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# formatter

Статический объект.

Статический класс, содержащий методы форматирования единиц измерения с учётом текущего языка.

## Методы {#method}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [distance](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md#distance)([value](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md#distance-param-value)[, [significantDigits](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md#distance-param-significantDigits)]) | String | Returns отформатированное согласно локальным правилам и переведённое в нужную систему единиц измерения строковое представление расстояния. ||
|| [duration](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md#duration)([value](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md#duration-param-value)[, [significantDigits](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/formatter.md#duration-param-significantDigits)]) | String | Returns строковое представление интервала времени. ||
|#

## Описание методов {#description-methods}

### distance

```javascript
{String} distance(value[, significantDigits])
```

**Returns** отформатированное согласно локальным правилам и переведённое в нужную систему единиц измерения строковое представление расстояния.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `value`[*](*parametr) | — | Тип: Number

Длина в метрах. ||
|| `significantDigits`| 2 | Тип: Integer

Число значащих цифр в ответе. ||
|#

\* Обязательный параметр/опция.

### duration

```javascript
{String} duration(value[, significantDigits])
```

**Returns** строковое представление интервала времени.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `value`[*](*parametr) | — | Тип: Number

Длина в метрах. ||
|| `significantDigits`| 2 | Тип: Integer

Число значащих цифр в ответе. ||
|#

\* Обязательный параметр/опция.

[*parametr]:Обязательный параметр/опция.