C#で日付操作の落とし穴と注意点を解説|初心者向けにわかりやすく丁寧に解説
生徒
「C#で日付や時間を操作するときに、注意しないと失敗することがありますか?」
先生
「ありますよ。日付と時間の処理には、特に初心者がつまずきやすい落とし穴がいくつかあります。」
生徒
「落とし穴って何ですか?具体的に教えてください!」
先生
「それでは、C#で日付操作をするときに知っておくべき大切なポイントを順番に見ていきましょう。」
1. DateTimeは「瞬間」を表すが文化圏で解釈が変わる
C#のDateTime型は、ある瞬間の日時を表す型です。しかし、実際には同じ時間でも「どの国や地域(タイムゾーン)」で解釈するかによって異なる意味になってしまうことがあります。これは、日時が国や地域によって時差があるためです。
例えば、同じ2025/11/27 10:00という時間でも、日本とアメリカでは実際の時刻が違います。この違いを無視すると、システムが誤った動作をすることがあります。
初心者がよくやってしまう失敗例として、「DateTimeだけで扱い、タイムゾーンを考えない」というケースがあります。表示に使用する時間と内部処理で使う時間を混ぜてしまうと、データがずれてしまいます。
2. DateTime.NowとDateTime.UtcNowの違いを理解しよう
日付や時間を取得する方法としてよく使われるものに、DateTime.NowとDateTime.UtcNowがあります。見た目は似ていますが、意味が大きく異なります。
var localTime = DateTime.Now;
var utcTime = DateTime.UtcNow;
DateTime.Nowは「現在のPCが設定している地域の時間」を返します。日本で実行すれば日本時間、アメリカで実行すればアメリカ時間になります。
一方、DateTime.UtcNowは世界共通の協定世界時(UTC)の時間です。時差の影響を受けないため、データを保存する際に非常に便利です。
3. AddDaysでの計算は存在しない日付に注意
日付を計算するときによく使われるのがAddDaysやAddMonthsといったメソッドです。ただし、操作する日付によっては存在しない日付が発生してしまうことがあります。特に注意が必要なのが月をまたぐ計算です。
var date = new DateTime(2025, 1, 31);
var result = date.AddMonths(1);
Console.WriteLine(result);
2025/03/03 00:00:00
31日に1ヶ月足した場合、本来の2月には31日が存在しないため、C#は自動的に日数を調整して3月3日になります。これに気付かず動かすと、締め日処理やバッチ処理で誤動作する可能性があります。
月末処理を正確に行うには、必ずDateTime.DaysInMonth()を利用することで防ぐことができます。
4. 文字列から日付変換はフォーマット違いに注意
ユーザー入力など、文字列から日付に変換する場合には、フォーマットの違いでエラーが起きやすいです。
var date = DateTime.Parse("2025/11/27");
上の例は日本の形式ですが、アメリカでは11/27/2025と書くのが一般的です。異なる環境で動かすと例外(エラー)が発生することがあります。これを防ぐ方法がDateTime.ParseExactです。
var date = DateTime.ParseExact("2025/11/27", "yyyy/MM/dd", null);
フォーマットを指定することで、常に同じ結果を得られ、予期せぬエラーを防げます。
5. 日付の比較は文字列では行わない
初心者がやってしまう代表的な間違いは、日付を文字列のまま比較してしまうことです。
var a = "2025/11/27";
var b = "2025/1/1";
Console.WriteLine(a > b);
True
これは文字列として比較しているために正しい結果になりません。必ずDateTime型に変換してから比較しましょう。
var d1 = DateTime.Parse(a);
var d2 = DateTime.Parse(b);
Console.WriteLine(d1 > d2);