Swiftで「ある期間」を扱いたいときに便利なのが DateInterval です。
開始日時と終了日時をセットで管理できる構造体で、「このイベントはいつからいつまでか」「この時間は含まれているか」などの操作を直感的に行うことができます。
この記事では DateInterval の基本的な使い方や主要な引数の意味、代表的な活用シーン、注意点までを初心者にもわかりやすく丁寧に解説します。
DateIntervalとは？
DateInterval は、ある時間の区間（開始時刻と終了時刻）を表すための構造体です。
単なる2つの Date を別々に持つのではなく、「期間」としてひとまとまりに管理できるのが特徴です。
開始日時 (start)・終了日時 (end) をセットで保持し、それに伴う duration（継続時間） も自動で計算してくれます。
|
1 2 3 4 |
let start = Date() let end = start.addingTimeInterval(3600) // 1時間後 let interval = DateInterval(start: start, end: end) |
このように DateInterval を使うことで、「1時間の区間」を一つのオブジェクトとして簡潔に扱えるようになります。
主なプロパティと意味
DateInterval にはいくつかの便利なプロパティがあります。
| プロパティ名 | 型 | 説明 |
|---|---|---|
| start | Date | 区間の開始時刻 |
| end | Date | 区間の終了時刻 |
| duration | TimeInterval | 区間の長さ（秒数） |
例えば、 interval.duration を見れば、「この期間が何秒間か」がすぐにわかります。
よく使うイニシャライザ
DateInterval の生成には主に2種類のイニシャライザがあります。
|
1 2 |
DateInterval(start: Date, end: Date) |
開始と終了を明示的に指定する方法。もっとも汎用的です。
|
1 2 |
DateInterval(start: Date, duration: TimeInterval) |
開始日時と、継続時間（秒数）を指定する方法。
この場合はend は自動計算されます。
どちらも用途に応じて使い分けられます。
具体例：1時間のイベント期間を作る
|
1 2 3 4 5 6 7 |
let start = Date() let interval = DateInterval(start: start, duration: 3600) // 1時間の区間 print(interval.start) // 開始時刻 print(interval.end) // 終了時刻 print(interval.duration) // 3600.0 |
主要なメソッド
DateInterval には以下のような便利なメソッドも用意されています。
| メソッド | 説明 |
|---|---|
| contains(Date) | 指定した日時がこの区間内に含まれるか |
| intersects(DateInterval) | 他の DateInterval と重なっているかどうか |
| intersection(DateInterval) | 重なっている範囲を新たな DateInterval として返す |
| compare(DateInterval) | 時系列的にどちらが先かを比較する |
これらを活用すれば、複数のイベント同士の衝突チェックや、タイムスロットの空き時間計算などが簡単にできます。
例えば、下記は特定の日時がその区間内に含まれているかを判定するメソッド contains(_:) を使用した例です。
|
1 2 3 4 5 6 7 8 9 |
let now = Date() let interval = DateInterval(start: now, duration: 600) // 10分間 let after5Min = now.addingTimeInterval(300) let result = interval.contains(after5Min) // true（範囲内） let after20Min = now.addingTimeInterval(1200) let result2 = interval.contains(after20Min) // false（範囲外） |
contains(_:) を利用すれば、指定した日時が「有効期間内かどうか」を簡単に判断できます。
活用シーン
DateInterval は以下のような場面でよく使われます。
- カレンダーアプリでのイベントの開始〜終了時間管理
- タイムスケジュールや空き時間の計算
- 一定時間内に処理が完了しているかの判定
- 他のイベントとの重複チェック
- 時間フィルタ処理（データが指定範囲内か）
時間の「始まり」と「終わり」がはっきりしているものを管理する場合に特に有効です。
注意点と落とし穴
便利な DateInterval ですが、使う際にはいくつかの注意点もあります。
startとendを逆にしないこと（逆にするとクラッシュします）durationは秒単位なので、日時に換算したいときは注意- Dateの比較はタイムゾーンや精度によって微妙なズレが起こることもある
また、複数のタイムゾーンを扱うアプリでは Calendar や DateComponents と併用して、意図しない時間のズレが起きないように設計するのが大切です。
まとめ
今回は Swift の DateInterval について詳しく解説しました。
- DateInterval は「開始日〜終了日」という時間区間を一つの構造体として扱える
- contains, intersects など便利なメソッドが多数ある
- タイムスケジュールやイベント管理、時間内判定に最適
- start と end の順序やタイムゾーンに注意が必要
時間の概念はアプリ開発において非常に重要なテーマのひとつです。
DateInterval をうまく使いこなせれば、時間ベースの処理をシンプルに実装できるようになります。
ぜひ自分のアプリにも取り入れてみてくださいね！
