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

# formatter

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

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

[Методы ](#methods-summary)

## Методы {#methods-summary}

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

# Описание методов {#method_detail}

### distance {#distance}

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

**Возвращает** строковое представление расстояния, отформатированное согласно локальным правилам и переведённое в нужную систему единиц измерения (например, для локали en_US расстояние будет представлено в милях).

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

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

Длина в метрах. ||
|| [`significantDigits`](#distance-param-significantDigits) | 2 | Тип: Integer

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

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

### duration {#duration}

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

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

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

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

Интервал времени в секундах. ||
|| [`significantDigits`](#duration-param-significantDigits) | 2 | Тип: Integer

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

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

<!-- XLIFF_FARM_ZjJmZGJi_CACHING -->

[*star]: Обязательный параметр.