C#の日付・時間操作におけるベストプラクティスまとめ【初心者向けガイド】
生徒
「C#で日付や時間を扱うときに、気をつけたほうがいいポイントはありますか？」
先生
「もちろんあります。日付と時間の操作は、プログラムの中でも特に間違いが起きやすい部分です。」
生徒
「たしかに、日付って国によって書き方も違うし、時差もあるから大変そうです。」
先生
「その通りです。だからこそ、C#ではベストプラクティスを知っておくことが大切なのです。今日はそのポイントをわかりやすく解説します。」
1. DateTimeは基本的にUTCで扱う習慣をつけよう
C#で日付や時間操作を行うとき、まず知っておくべき重要なポイントは、日付や時刻はUTC（協定世界時）で保存し、表示するときにローカルタイムへ変換するという考え方です。UTCとは、世界共通の基準となる時間のことで、国や地域の時差の影響を受けません。もしローカルタイムで保存すると、時差変更やサマータイムの影響で表示がおかしくなることがあります。
特に、サーバーとユーザーの地域が違うシステムではとても重要です。例えば、海外の旅行予約システムやオンラインゲームなどは、必ずUTCで時間データを扱います。
var nowUtc = DateTime.UtcNow; // 現在時刻をUTC基準で取得
Console.WriteLine(nowUtc);
2. ローカル時間へ変換するときはToLocalTime()を使おう
画面に表示するときなどは、UTCのままだと人間にとって読みづらいので、ToLocalTime()を使って日本時間などのローカルタイムに変換します。
var localTime = nowUtc.ToLocalTime();
Console.WriteLine(localTime);
この変換はコンピュータが自動的に時差やサマータイムを考慮してくれるため、とても便利です。
3. TimeZoneInfoを使って特定の地域の時刻に変換する
もし特定の地域（例えばニューヨークやロンドンなど）の時間を扱いたい場合は、TimeZoneInfoを利用します。
var tokyo = TimeZoneInfo.FindSystemTimeZoneById("Tokyo Standard Time");
var tokyoTime = TimeZoneInfo.ConvertTimeFromUtc(nowUtc, tokyo);
Console.WriteLine(tokyoTime);
地域の名前を指定するだけで自動的に計算してくれるため、国際的なサービスを作る場合には欠かせません。
4. DateTimeKindを意識する習慣をつける
DateTimeには、時間が何基準かを表すDateTimeKindという情報があります。これを意識せずに扱うと、思わぬ変換ミスが起きることがあります。
var dt = new DateTime(2025, 1, 1, 12, 0, 0, DateTimeKind.Utc);
Kindを指定することで、UTCとして扱うことを明示できます。
5. AddDaysやAddHoursで計算するときの注意点
日付の計算はAddDays()やAddHours()などを使いますが、変換後に再計算する場合、UTCへ戻す習慣をつけると安全です。
var tomorrow = nowUtc.AddDays(1);
Console.WriteLine(tomorrow);
複数の計算が発生するシステムでは、途中でローカル時間が混ざると誤差が出ることがあります。
6. DateOnly と TimeOnly の使い分け
C#では、日付だけを扱えるDateOnly、時間だけを扱えるTimeOnlyが用意されています。たとえば誕生日や営業時間など、時間帯やサーバー地域が関係ないデータに最適です。
var birthday = new DateOnly(1990, 5, 1);
var openTime = new TimeOnly(9, 0);
これにより、UTC変換によるズレを防ぐことができます。
7. DateTimeOffsetを活用して時差情報を保持する
もし日付とともに時差情報も正確に記録したい場合は、DateTimeOffsetが最適です。これはUTCとの差分を保持できる特別な型で、航空券予約やログ管理に向いています。
var dto = DateTimeOffset.Now;
Console.WriteLine(dto);
この型を使うと、世界中のユーザーを扱うシステムでも安全です。
8. 文字列の変換はISO 8601形式を使うと安全
APIやJSONとの連携では、ISO 8601形式（例：2025-01-01T10:00:00Z）で文字列に変換するのがベストプラクティスです。
var iso = nowUtc.ToString("o");
Console.WriteLine(iso);
