こんにちは！開発現場を渡り歩く中で、数々の「日付バグ」の修羅場を潜り抜けてきた先輩エンジニアです。
Excelのマクロ（VBA）からステップアップして、本格的なVB.NETの世界へ足を踏み入れたあなた。おめでとうございます！VB.NETは、背後に広大な.NETの海（ライブラリ）を控えた非常に強力な言語です。
さて、業務アプリケーションを作るとき、避けて通れないのが「日時・時刻の計算」です。「昨日より1日進める」「締め日の月をまたぐ計算をする」……一見、簡単そうに見えますよね。しかし、ここにはプログラミング初学者が必ずと言っていいほどハマる、甘くない落とし穴がいくつも口を開けて待っています。
今回は、VB.NETにおける日時の扱い方、そして実務で絶対に知っておくべき`DateTime`と`DateTimeOffset`の使い分けの極意を、優しく、かつ本質的なところまで徹底解説します。ここをクリアすれば、あなたの書くコードの信頼性はグッと跳ね上がりますよ！
—
1. なぜ「日付の計算」はバグを生みやすいのか？
「日付なんて、今の時刻に`+1`すればいいだけじゃないの？」
そう思っていませんか？ 現実はそう甘くありません。
- 「うるう年（2月29日）」の存在
- 月によって日数（28日、30日、31日）がバラバラなこと
- そして何より「タイムゾーン」と「夏時間（DST）」の壁
これらを考慮せずに「単純な足し算・引き算」をコードに書くと、海外サーバーと連携した瞬間や、特定の季節になった途端にシステムが怪しい挙動を起こし始めます。
VB.NETでは、こうしたカオスの海を安全に渡るための強力な道具が用意されています。まずは基本のキから見ていきましょう。
—
2. 【基本】VB.NETの王道：DateTime構造体と TimeSpan
日付や時刻を扱うとき、私たちは主に `DateTime`（日付と時刻） と `TimeSpan`（時間の間隔） という2つの構造体を使います。
まずは、最も安全で正しい日付の加算・減算のコードを見てみましょう。
Imports System
Module DateBasicsSample
Sub Main()
‘ 現在のローカル日時を取得
Dim today As DateTime = DateTime.Now
Console.WriteLine(“今日の日付: ” & today.ToString(“yyyy/MM/dd HH:mm:ss”))
‘ 【正解】AddDaysメソッドを使う（うるう年も自動で考慮されます）
Dim tomorrow As DateTime = today.AddDays(1)
Console.WriteLine(“明日の日付: ” & tomorrow.ToString(“yyyy/MM/dd HH:mm:ss”))
‘ 【正解】特定の月数を足す（月末の調整も自動！）
Dim nextMonth As DateTime = today.AddMonths(1)
Console.WriteLine(“1ヶ月後の日付: ” & nextMonth.ToString(“yyyy/MM/dd HH:mm:ss”))
‘ 2つの日時の差（TimeSpan）を求める
Dim targetDate As New DateTime(2025, 12, 31)
Dim diff As TimeSpan = targetDate – today
Console.WriteLine(“2025年末まで、あと ” & diff.Days & ” 日です。”)
End Sub
End Module
💡 ここがポイント！
初心者がやりがちな間違いとして、`today.Day = today.Day + 1` のように直接プロパティを書き換えようとすることがあります（そもそも`DateTime`のプロパティは読み取り専用なのでコンパイルエラーになりますが）。
必ず `AddDays()` や `AddMonths()` といった専用のメソッドを使いましょう。.NETの裏側が、うるう年や大小の月を完璧に計算してくれます。
—
3. 最大の落とし穴：DateTime と DateTimeOffset の使い分け
さて、ここからが本題のハイライトです。
もしあなたが、クラウド（AzureやAWSなど）で動くシステムや、海外の拠点とデータをやり取りするシステムを作るなら、`DateTime`だけを使っていると痛い目を見ます。
ここで登場するのが `DateTimeOffset` です。
DateTimeの何が問題なのか？
`DateTime`型は、保持している値に「どこの国の時間か（タイムゾーン）」という明確な情報がすっぽり抜け落ちているか、あやふやになりやすいという弱点があります。
例えば、ログに記録された `2023/10/10 15:30:00`。これは日本時間の15:30なのか、協定世界時（UTC）の15:30なのか、`DateTime` 単体では判別がつかないことが多いのです。
DateTimeOffset の強み
`DateTimeOffset` は、「日付と時刻」に加えて「UTC（協定世界時）からの時差」をセットで保持します。
次のコードを見比べてみてください。
Imports System
Module TimeZoneSample
Sub Main()
‘ 1. DateTime: タイムゾーンの文脈があいまいになりがち
Dim dtNow As DateTime = DateTime.UtcNow
Console.WriteLine(“DateTime (UTC): ” & dtNow.ToString(“yyyy/MM/dd HH:mm:ss”))
‘ 2. DateTimeOffset: 「今、世界基準で何時で、時差はいくつあるか」を完全に保持
Dim dtoNow As DateTimeOffset = DateTimeOffset.UtcNow
Console.WriteLine(“DateTimeOffset (UTC基準): ” & dtoNow.ToString(“yyyy/MM/dd HH:mm:ss zzz”))
‘ 日本時間に変換するのも一発！
Dim japanTzi = TimeZoneInfo.FindSystemTimeZoneById(“Tokyo Standard Time”)
Dim dtoJapan As DateTimeOffset = TimeZoneInfo.ConvertTime(dtoNow, japanTzi)
Console.WriteLine(“日本時間に変えたよ: ” & dtoJapan.ToString(“yyyy/MM/dd HH:mm:ss zzz”))
End Sub
End Module
🛠️ 実務での使い分けの鉄則
- 単体のデスクトップアプリで、端末のローカル時間だけで完結する場合：
今まで通り `DateTime` でも大きな問題はありません（ただし `DateTime.Now` よりも `DateTime.UtcNow` を基本にしつつ表示時のみ変換する設計がモダンです）。
- Webアプリ、クラウド連携、データベースに日時を保存する場合：
原則としてすべて `DateTimeOffset` を使ってください。 「いつ、どこのタイムゾーンで発生したデータか」が明確になり、後からグローバルな集計をする際にデータの崩壊を防げます。
—
4. 現場で役立つ！日付演算のベストプラクティス・小技集
最後に、開発現場で「あ、これどうやるんだっけ？」となりがちな実用スニペットをいくつかプレゼントします。
① 「今月の末日」を正確に求める方法
「月末の締め処理」などでよく使います。翌月の0日目を指定するというのがプログラミングの定石テクニックです。
‘ 現在の年と月をベースに、翌月の1日を取得し、そこから1日引く
Dim now As DateTime = DateTime.Now
Dim lastDayOfThisMonth As DateTime = New DateTime(now.Year, now.Month, 1).AddMonths(1).AddDays(-1)
Console.WriteLine(“今月の末日は: ” & lastDayOfThisMonth.ToString(“yyyy/MM/dd”))
② 曜日を判定する
VB.NETの`DayOfWeek`列挙型を使えば、スマートに曜日が取れます。日本語で曜日を表示させたい場合は、書式指定が便利です。
Dim today As DateTime = DateTime.Now
‘ “dddd” というフォーマットを指定すると、ロケールに応じた曜日（月曜日、火曜日など）が取れます
Console.WriteLine(“今日は ” & today.ToString(“yyyy年MM月dd日 (dddd)”) & ” です。”)
‘ 曜日で条件分岐したい場合
If today.DayOfWeek = DayOfWeek.Saturday OrElse today.DayOfWeek = DayOfWeek.Sunday Then
Console.WriteLine(“週末ですね！ゆっくり休んでください。”)
Else
Console.WriteLine(“お仕事ファイトです！”)
End If
—
まとめ：日付処理を制する者は、システムを制す
いかがでしたでしょうか？
日付の処理は、地味に見えて実はシステムの「土台」に関わる非常に重要な部分です。
1. 日付の加算・減算は、直接プロパティをいじらず `AddDays` や `AddMonths` などの専用メソッドを使う。
2. グローバルやクラウドを見据えるなら、タイムゾーン情報を持つ `DateTimeOffset` を積極的に採用する。
ここをクリアできれば、もう「マクロの延長」のコードからは完全に卒業です。自信を持って、堅牢で美しいVB.NETのコードを書き進めていきましょう！
あなたのエンジニアライフが、バグのない素晴らしいものになるよう応援しています。それでは、次のコードの世界でお会いしましょう！
