OTR_Internationalization

国際化（多言語化）

• TOP > 使い方 > 国際化（多言語化）

概要

国際化（i18n）・地域化（L10n）の対応項目と、Open 棟梁の対応部品。

• クライアント側のロケールは可変、サーバ側のロケールは固定が基本（ログはサーバのロケールに揃える）。
• 内部の時刻は UTC で保持し、表示時に変換する。

詳細

対応項目

項目	内容	.NET
文言	画面・メッセージ・ログの文言を外部リソース化する	.resx、CurrentUICulture
書式	数値・日時・通貨	CurrentCulture、CultureInfo
カレンダー	和暦・グレゴリオ暦など	CultureInfo.Calendar（JapaneseCalendar など）
タイムゾーン	内部は UTC、表示時に時差・夏時間を調整	DateTime.UtcNow、TimeZoneInfo
UI	ラベル幅の変化、右から左に書く言語	レイアウト、リソース
文字コード	UTF-8 / UTF-16 に統一	—

• CurrentCulture（書式）と CurrentUICulture（表示言語）は分けて扱う。

Open 棟梁の対応部品

対象	部品・設定
メッセージ	カルチャ別の定義ファイル（MSGDefinition_ja-JP.xml など）と設定 FxExceptionMessageCulture（メッセージ定義）
例外メッセージ（事前定義）	.resx リソース
時刻	GMTMaster（ローカル時刻と UTC の変換）
数値書式	FormatConverter（丸め、桁区切りなど）
文字コードの検証	StringChecker、JIS2k4Checker
画面の文言	.resx（既定）、または辞書テーブル方式（画面名＋コントロール名から多言語の文言を引き、親クラス2 で Control ツリーを走査して設定する）

コーディング・エージェントに任せる場合

• スキル opentouryo-app-design（references/internationalization.md・character-encoding.md）と opentouryo-message を使わせる。
• エージェントは文言をコードに直書きし、DateTime.Now を使いがちなので、リソース化と UTC 保持をレビューで確認する。

参考

• メッセージ定義
• 共通部品

---

Tags: 再構築