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

# formatter

Static object.

Static class containing methods for formatting measurement units depending on the current language.

[Methods](#methods-summary)

## Methods {#methods-summary}

#|
|| **Name** | **Returns** | **Description** ||
|| [distance](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/formatter.md#distance)([value](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/formatter.md#distance-param-value)[, [significantDigits](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/formatter.md#distance-param-significantDigits)]) | String
| Returns string representation of distance formatted for the locale being used, and converted to the appropriate measurement system (for example, for en-US, distance will be in miles). ||
|| [duration](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/formatter.md#duration)([value](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/formatter.md#duration-param-value)[, [significantDigits](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/formatter.md#duration-param-significantDigits)]) | String
| Returns string representation of duration. \|
|#

## Methods details {#method_detail}

### distance {#distance}

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

**Returns** string representation of distance formatted for the locale being used, and converted to the appropriate measurement system (for example, for en-US, distance will be in miles).

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`value`](#distance-param-value)[*](*star) | — | Type: Number

Length in meters. ||
|| [`significantDigits`](#distance-param-significantDigits) | 2 | Type: Integer

Number of significant digits in the response. ||
|#

\* Mandatory parameter/option.

### duration {#duration}

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

**Returns** string representation of duration.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`value`](#duration-param-value)[*](*star) | — | Type: Number

Duration in seconds. ||
|| [`significantDigits`](#duration-param-significantDigits) | 2 | Type: Integer

Number of significant digits in the response. ||
|#

\* Mandatory parameter/option.

[*star]: Mandatory parameter/option.