# generaltranslation: General Translation Core SDK: DataFormat
URL: https://generaltranslation.com/ru/docs/core/types/data-format.mdx
---
title: DataFormat
description: Перечисление поддерживаемых форматов содержимого для перевода
---

## Обзор

`DataFormat` определяет формат переводимого содержимого.

```typescript
type DataFormat = 'JSX' | 'ICU' | 'I18NEXT' | 'STRING';
```


## Определение типа

### Значения

| Значение    | Описание                     | Тип содержимого           | Сценарий использования                                                  |
| ----------- | ---------------------------- | ------------------------- | ----------------------------------------------------------------------- |
| `'JSX'`     | Формат компонентов JSX/React | `JsxChildren`             | Сложные UI-компоненты с элементами и переменными                        |
| `'ICU'`     | ICU MessageFormat            | `IcuMessage` (строка)     | Сложное форматирование с формами множественного числа, датами и числами |
| `'I18NEXT'` | Формат сообщений i18next     | `I18nextMessage` (строка) | Простая интерполяция, существующие проекты на i18next                   |
| `'STRING'`  | Формат обычной строки        | `string`                  | Простое текстовое содержимое                                            |

### Характеристики форматов

| Формат      | Переменные                 | Множественные формы                     | HTML-элементы           | Форматирование дат/чисел             |
| ----------- | -------------------------- | --------------------------------------- | ----------------------- | ------------------------------------ |
| **JSX**     | ✅ Сложные переменные       | ✅ Через ветвление                       | ✅ Полная поддержка HTML | ✅ Через переменные                   |
| **ICU**     | ✅ Синтаксис `{variable}`   | ✅ Встроенные формы множественного числа | ❌ Только текст          | ✅ Встроенные средства форматирования |
| **I18NEXT** | ✅ Синтаксис `{{variable}}` | ✅ Через count                           | ❌ Только текст          | ✅ Через средства форматирования      |
| **STRING**  | ❌                          | ❌                                       | ❌                       | ❌                                    |

***

## Примеры

### Спецификация формата

```typescript copy
const icuEntry: TranslateManyEntry = {
  source: 'Hello {name}',
  metadata: { dataFormat: 'ICU' }
};

const plainEntry: TranslateManyEntry = {
  source: 'Hello, world!',
  metadata: { dataFormat: 'STRING' }
};
```

***


## Примечания

* DataFormat определяет, как система перевода обрабатывает содержимое
* Указание формата в метаданных обеспечивает корректную обработку содержимого
* Автоопределение возможно, но рекомендуется указывать формат явно

## Связанные типы

* [`Content`](/docs/core/types/Content) — Объединение всех типов форматов содержимого
* [`JsxChildren`](/docs/core/types/jsx-children) — Содержимое в формате JSX