# generaltranslation: General Translation Core SDK: DataFormat
URL: https://generaltranslation.com/ja/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` (string)     | 複数形、日付、数値を扱う複雑なフォーマット      |
| `'I18NEXT'` | i18next メッセージ形式     | `I18nextMessage` (string) | シンプルな補間、既存の 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 形式のコンテンツ