# 国際化

- Human documentation: [https://docs.univer.ai/ja-JP/guides/slides/getting-started/i18n](https://docs.univer.ai/ja-JP/guides/slides/getting-started/i18n)

- Agent Markdown: [https://docs.univer.ai/ja-JP/guides/slides/getting-started/i18n.md](https://docs.univer.ai/ja-JP/guides/slides/getting-started/i18n.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.2.0`

- Source: [slides/getting-started/i18n.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/slides/getting-started/i18n.ja-JP.mdx)

---

## インターフェースの言語

`locale` はメニュー、ツールチップ、ダイアログなどの UI の言語パックを選択します。`locales` は言語パックを登録しますが、言語は選択しません。この設定は Univer インスタンス内の各ユニットで共有されます。`LocaleType.EN_US` などの `LocaleType` 値を使ってください。

* **全製品：UI**：`locale` はメニュー、ツールチップ、ダイアログ、プラグインのラベルを翻訳します。ユーザーの内容や既存ユニット名は変更しません。
* **Sheets：セル書式と数式**：数値/日付の表示は、数値書式の locale 上書き値、ワークブックスナップショットの `locale`、インスタンスの `locale` の順で選択されます。`region` はこれらを置き換えません。`DOLLAR` や財務関数の結果の通貨書式、中日韓入力の正規化は引き続き `locale` を使います。
* **Docs：統計**：`locale` は単語分割と単語数の計算に使われます。

### 実行時の言語の切り替え

言語を切り替える前に、導入済みのプラグインやプリセットの言語パックをすべて読み込んでください。`loadLocales()` は翻訳をマージしますが言語は切り替えません。`setLocale()` は言語を選択しますがダウンロードは行いません。翻訳がない場合はキーが表示されます。以下は共通 UI パックの例です。他の導入済みプラグインの対象言語パックも同じ呼び出しでマージしてください。

```typescript
import { LocaleType, mergeLocales } from '@univerjs/core'
import UIEnUS from '@univerjs/ui/locale/en-US'

univerAPI.loadLocales(LocaleType.EN_US, mergeLocales(UIEnUS))
univerAPI.setLocale(LocaleType.EN_US)

console.log(univerAPI.getCurrentLocale()) // enUS
```

### 言語パックのマージ

`mergeLocales` メソッドは、複数のプラグインやプリセットの言語パックを1つの完全な言語パックオブジェクトに統合するために使用します。使い方は以下の通りです。

#### プラグインモード

```typescript
import { mergeLocales } from '@univerjs/core'

// 複数の言語パックオブジェクトを引数で渡してマージできます
const locales = mergeLocales(
  plugin1Locales,
  plugin2Locales,
  presetLocales,
)
// 配列としてまとめて渡すことも可能です
const locales = mergeLocales([
  plugin1Locales,
  plugin2Locales,
  presetLocales,
])
```

#### プリセットモード

```typescript
import { mergeLocales } from '@univerjs/presets'

// 複数の言語パックオブジェクトを引数で渡してマージできます
const locales = mergeLocales(
  plugin1Locales,
  plugin2Locales,
  presetLocales,
)
// 配列としてまとめて渡すことも可能です
const locales = mergeLocales([
  plugin1Locales,
  plugin2Locales,
  presetLocales,
])
```

### カスタム言語パック

Univer はカスタム言語パックにも対応しています。必要に応じて言語パックオブジェクトを組み立て、`Univer` インスタンスに渡すことができます。プリセットの言語パックは通常、`<rootDir>/packages/<PLUGIN_NAME>/locale` ディレクトリに保存されています。

```typescript
import { LocaleType, Univer } from '@univerjs/core'

const univer = new Univer({
  locale: LocaleType.JA_JP,
  locales: {
    [LocaleType.JA_JP]: {
      ui: {
        shortcut: {
          undo: '元に戻す',
          redo: 'やり直す',
        },
      },
    },
  },
})
```

### 翻訳への貢献

Univer には、現在以下の組み込み言語パックが用意されています：

* `zh-CN`: 中国語（簡体字）
* `en-US`: 英語
* `zh-TW`: 中国語（繁体字）
* `zh-HK`: 中国語（繁体字・香港）
* `ru-RU`: ロシア語
* `vi-VN`: ベトナム語
* `fa-IR`: ペルシャ語
* `fr-FR`: フランス語
* `ja-JP`: 日本語
* `ko-KR`: 韓国語
* `es-ES`: スペイン語
* `ca-ES`: カタルーニャ語
* `sk-SK`: スロバキア語
* `ar-SA`: アラビア語
* `de-DE`: ドイツ語
* `id-ID`: インドネシア語
* `it-IT`: イタリア語
* `pl-PL`: ポーランド語
* `pt-BR`: ポルトガル語（ブラジル）

Univer は多様性にあふれるオープンソースプロジェクトであり、世界中の開発者によるロケール追加や改善を歓迎しています。

## 地域設定

`region` は地域に依存する機能で使う地域の慣習を指定します。この設定は Univer インスタンス内の各ユニットで共有されます。

どちらにも `LocaleType` を使ってください。例えば `LocaleType.EN_US` の値は `enUS` で、`en-US` は言語パックのファイル名 / BCP 47 タグです。`region` に `US` や `SG` などの国コードを渡さないでください。UI が別の言語を使う場合、地域に対応する言語パックの追加読み込みは不要です。

`region` を明示しない場合は `locale` に追従し、後から `setLocale()` を呼んでも更新されます。初期化時に `region` を指定するか `setRegion()` を呼ぶと追従が止まり、その後の言語変更でも地域は維持されます。追従に戻す公開 API はありません。同時に変更したい場合は両方を設定してください。

`createUniver()` または `new Univer()` の `locale` の横に `region: LocaleType.DE_DE` を追加すると、UI 言語を維持したままドイツの地域慣習を使えます。

```typescript
import { LocaleType } from '@univerjs/core'

univerAPI.setRegion(LocaleType.DE_DE)
univerAPI.setLocale(LocaleType.EN_US)

console.log(univerAPI.getCurrentRegion()) // deDE
```

この例では UI が英語になり、地域はドイツのままです。`getCurrentLocale()` と `getCurrentRegion()` は現在の識別子を返します。両方を切り替えるには、同じ `LocaleType` 値で両方の setter を呼びます。

* **Sheets：通貨操作**：`region` は通貨ツールバーアイコン、通貨/会計書式の選択肢とプレビュー、通貨コマンドで適用する書式を決めます。既存セルの書式や金額の換算は行いません。
* **Docs：統計**：`region` は統計ダイアログとステータスバーの数値表示（桁区切りなど）に使われ、計算規則は変えません。
* **スレッドコメントを有効にした場合**：`region` は日時の表示形式を決め、24 時間表記とラテン数字を使います。`locale` はコメント UI の翻訳に使われます。保存済みタイムスタンプは変わりません。`region` はタイムゾーン設定ではありません。
* **Boards、Slides、Bases、PDFs**：`locale` は UI の翻訳を制御します。`region` は統合したスレッドコメントなどの共通機能で使えますが、ボード/スライドのテキスト、Base のフィールド、PDF の内容を自動で再書式設定しません。

## 右から左へのレイアウト

> [!WARNING: 注意]
> 現在、RTL は UI レイヤーのみでサポートされています。レンダリングレイヤーでは RTL をサポートしていません。

> [!WARNING: 注意事項]
> すべてのプラグインに言語パックが含まれているわけではありません。各機能のドキュメント内で、その有無を明記します。

```typescript
univerAPI.setDirection('rtl')
```