# General Translation React SDKs (gt-react, gt-next): Currency
URL: https://generaltranslation.com/ru/docs/react/reference/components/currency.mdx
---

title: Currency
description: Форматирование денежных сумм для активной локали с помощью General Translation gt-react. Справка по API для Currency.

---

Компонент `<Currency>` отображает числовое значение в формате валюты для активной локали. Он только форматирует значение и не выполняет конвертацию по обменному курсу.

*Доступно в `gt-react`, `gt-next`, `gt-tanstack-start` и `gt-react-native`. В примерах используется импорт из `gt-react`; вместо этого импортируйте из пакета вашего фреймворка.*

## Обзор [#overview]

Передайте сумму через `children` и укажите код `currency`.

```tsx
<Currency>{100}</Currency>
// Вывод: $100.00
```

Все форматирование выполняется локально с помощью [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat).

## Как это работает [#how-it-works]

* **Локальное форматирование.** Сумма форматируется в браузере с помощью `Intl.NumberFormat`. Её значение никогда не отправляется в API General Translation.
* **Без конвертации.** `<Currency>` форматирует символ, разделение разрядов и количество знаков после запятой для выбранной валюты и локали, но не выполняет конвертацию между валютами.
* **Определение локали.** Форматирование определяется активной локалью, если оно не переопределено с помощью `locales`.

## Props [#props]

| Prop                    | Описание                                                | Type                       | Необязательно | По умолчанию    |
| ----------------------- | ------------------------------------------------------- | -------------------------- | ------------- | --------------- |
| [`children`](#children) | Сумма для форматирования.                               | `number \| string`         | Нет           | —               |
| [`currency`](#currency) | Код валюты ISO 4217.                                    | `string`                   | Да            | `USD`           |
| [`options`](#options)   | Параметры `Intl.NumberFormat`.                          | `Intl.NumberFormatOptions` | Да            | `{}`            |
| [`locales`](#locales)   | Локаль, используемая вместо текущей для форматирования. | `string[]`                 | Да            | Активная локаль |
| [`name`](#name)         | Имя переменной для записи.                              | `string`                   | Да            | —               |

### `children` [#children]

**Тип** `number | string` · **Обязательно**

Сумма, которую нужно отформатировать в виде валюты. Перед форматированием строки преобразуются в числа.

### `currency` [#currency]

**Type** `string` · **Необязательно** · **По умолчанию** `USD`

Код валюты по стандарту ISO 4217, например `USD` или `EUR`. Определяет символ и формат.

### `options` [#options]

**Тип** `Intl.NumberFormatOptions` · **Необязательный** · **По умолчанию** `{}`

Параметры форматирования в соответствии со спецификацией [`Intl.NumberFormatOptions`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat), например `currencyDisplay` и ограничения на количество знаков после запятой.

### `locales` [#locales]

**Тип** `string[]` · **Необязательно** · **По умолчанию** Активная локаль

Локали, для которых нужно выполнять форматирование. Если параметр не указан, используется активная локаль. См. [аргумент locales](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#locales_argument).

### `name` [#name]

**Type** `string` · **Необязательный**

Необязательное название поля Currency, используемое для метаданных.

## Примеры [#examples]

```tsx title="PriceDisplay.tsx"
import { Currency } from 'gt-react';

export default function PriceDisplay({ item }) {
  return <Currency>{item.price}</Currency>; // [!code highlight]
}
```

```tsx title="PriceDisplay.tsx"
import { Currency } from 'gt-react';

export default function PriceDisplay({ item }) {
  return <Currency currency="EUR">{item.price}</Currency>; // [!code highlight]
}
```

```tsx title="PriceDisplay.tsx"
import { T, Currency } from 'gt-react';

export default function PriceDisplay({ item }) {
  return (
    <T>
      The price is <Currency>{item.price}</Currency>. // [!code highlight]
    </T>
  );
}
```

```tsx title="PriceDisplay.tsx"
import { Currency } from 'gt-react';

export default function PriceDisplay({ item }) {
  return (
    <Currency
      currency="GBP"
      options={{ // [!code highlight]
        currencyDisplay: 'narrowSymbol',
        minimumFractionDigits: 2,
        maximumFractionDigits: 2,
      }}
    >
      {item.price}
    </Currency>
  );
}
```

## Заметки [#notes]

* `<Currency>` форматирует денежные суммы для активной локали, но не выполняет конвертацию валют.
* Его содержимое форматируется локально и никогда не отправляется в API.