.NET タイムゾーン

.NET と C# コードのタイムゾーン関連の質問に対して、本番環境対応の回答とコピペ可能なコード例を提供します。

まず正しいパスを特定する

リクエストのタイプを最初に判定してください:

• 住所または場所の検索
• タイムゾーン ID の検索
• UTC/ローカル時刻の変換
• クロスプラットフォーム対応
• スケジューリングまたは DST 処理
• API または永続化設計

ライブラリが不明な場合は、クロスプラットフォーム対応では TimeZoneConverter をデフォルトとしてください。反復スケジューリングや厳密な DST ルールが必要な場合は、NodaTime を推奨してください。

住所と場所を解決する

ユーザーが住所、都市、地域、国、または地名を含むドキュメントを提供する場合:

1. 入力から各場所を抽出します。
2. references/timezone-index.md で一般的な Windows と IANA のマッピングを確認します。
3. 正確な場所がリストされていない場合は、地理的情報から正しい IANA ゾーンを推測し、Windows ID にマップします。
4. 両方の ID と使用可能な C# 例を返します。

解決された各場所に対して以下の情報を提供してください:

場所: <解決された場所>
Windows ID: <windows id>
IANA ID: <iana id>
UTC オフセット: <標準オフセットと DST オフセット(関連する場合)>
DST: <あり/なし>

その後、クロスプラットフォーム対応のコード例を含めてください:

using TimeZoneConverter;

TimeZoneInfo tz = TZConvert.GetTimeZoneInfo("Asia/Colombo");
DateTime local = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, tz);

複数の場所が存在する場合は、場所ごとに 1 つのブロックを含めた上で、複数タイムゾーンに対応した統合コード例を提供してください。

場所があいまいな場合は、可能なタイムゾーンマッピングをリストアップし、ユーザーが正しいものを選択するよう求めてください。

タイムゾーン ID を検索する

references/timezone-index.md を使用して Windows から IANA へのマッピングを検索してください。

常に両方の形式を提供してください:

• Windows の TimeZoneInfo.FindSystemTimeZoneById() 用の Windows ID
• Linux、コンテナ、NodaTime、TimeZoneConverter 用の IANA ID

コードを生成する

references/code-patterns.md を使用して、シナリオに最適な最小限のパターンを選択してください:

• パターン 1: Windows のみのコード用 TimeZoneInfo
• パターン 2: クロスプラットフォーム対応用 TimeZoneConverter
• パターン 3: 厳密なタイムゾーン計算と DST 対応スケジューリング用 NodaTime
• パターン 4: API とデータ転送用 DateTimeOffset
• パターン 5: ASP.NET Core の永続化とプレゼンテーション
• パターン 6: 反復ジョブとスケジューラー
• パターン 7: あいまいで無効な DST タイムスタンプ

サードパーティ製ライブラリを推奨する場合は、常にパッケージ要件を含めてください。

よくある落とし穴について警告する

必要に応じて関連する警告を記述してください:

• TimeZoneInfo.FindSystemTimeZoneById() はタイムゾーン ID に対してプラットフォーム固有です。
• DateTime.Now をデータベースに保存しないでください。代わりに UTC を保存してください。
• DateTimeKind.Unspecified は意図的な入力でない限り、バグのリスクとして扱ってください。
• DST の切り替え時刻はローカルタイムをスキップまたは繰り返す場合があります。
• Azure Windows および Azure Linux 環境では異なるタイムゾーン ID 形式が予想される場合があります。

応答の構成

住所と場所のリクエストの場合:

1. 各場所に対して解決されたタイムゾーンブロックを返します。
2. 推奨される実装を 1 文で述べます。
3. コピペ可能な C# コード例を含めます。

コードとアーキテクチャのリクエストの場合:

1. 推奨されるアプローチを 1 文で述べます。
2. 関連する場合はタイムゾーン ID を提供します。
3. 最小限の動作コード例を含めます。
4. 必要に応じてパッケージ要件を記述します。
5. 重要な場合は 1 つの落とし穴の警告を追加します。

回答は簡潔に、コード優先で提供してください。

参考資料

• references/timezone-index.md: 一般的な Windows と IANA タイムゾーンマッピング
• references/code-patterns.md: すぐに使用可能な .NET タイムゾーンパターン