[Xcode/Swift] TimeIntervalを知る

Swiftには、時間を扱うための便利な型や機能が用意されています。その中でも、時間の間隔を表すTimeIntervalは、アプリ開発でよく使用される重要な概念です。本記事では、TimeIntervalの基本と、簡単な使い方についてサンプルコードを交えながら説明します。

Contents 非表示

TimeIntervalとは
基本的な使い方
- 現在時刻との比較
- 時間の差を計算
カウントダウンクロック
ユースケース
まとめ

TimeIntervalとは

TimeIntervalは、時間間隔を秒単位で表す型です。Double型のエイリアス（別名）として定義されており、小数点を使用して秒以下の時間も表現できます。

例えば：

1秒は1.0
1分（60秒）は60.0
0.5秒（500ミリ秒）は0.5

といった形で使います。

基本的な使い方

現在時刻との比較

現在時刻から一定時間後を計算したり、2つの日付の差を計算するのにTimeIntervalを使用します。

以下は、現在時刻から5分後の時間を計算する例です：

import Foundation

let now = Date() // 現在の日時
let fiveMinutesLater = now.addingTimeInterval(60 * 5) // 5分後

print("現在時刻: \(now)")
print("5分後: \(fiveMinutesLater)")

// 出力結果
現在時刻: 2024-11-28 09:00:00 +0000
5分後: 2024-11-28 09:05:00 +0000

addingTimeIntervalメソッドを使うと、指定した秒数だけ時間を進めたDateを得ることができます。

時間の差を計算

2つの日付の差を秒単位で計算するのも簡単です。

let startDate = Date() // 開始日時
let endDate = startDate.addingTimeInterval(3600) // 1時間後

let timeInterval = endDate.timeIntervalSince(startDate) // 経過時間（秒）
print("開始日時: \(startDate)")
print("終了日時: \(endDate)")
print("経過時間: \(timeInterval)秒")

// 出力結果
開始日時: 2024-11-28 09:00:00 +0000
終了日時: 2024-11-28 10:00:00 +0000
経過時間: 3600.0秒

カウントダウンクロック

次に、TimeIntervalを使ったシンプルなカウントダウンクロックを作成してみましょう。

import SwiftUI

struct CountdownView: View {
    @State private var remainingTime: TimeInterval = 60 // 60秒のカウントダウン
    @State private var timerActive = false

    var body: some View {
        VStack(spacing: 20) {
            Text("残り時間: \(Int(remainingTime)) 秒")
                .font(.largeTitle)

            Button(action: {
                startCountdown()
            }) {
                Text(timerActive ? "カウントダウン中" : "スタート")
                    .padding()
                    .background(timerActive ? Color.gray : Color.blue)
                    .foregroundColor(.white)
                    .cornerRadius(10)
            }
            .disabled(timerActive)
        }
        .padding()
        .onDisappear {
            timerActive = false // 画面を離れたらタイマーを停止
        }
    }

    func startCountdown() {
        timerActive = true
        Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { timer in
            if remainingTime > 0 {
                remainingTime -= 1
            } else {
                timer.invalidate()
                timerActive = false
            }
        }
    }
}

このコードは、TimeIntervalを利用して残り時間を管理し、1秒ごとに減少させる簡単なカウントダウンクロックを構築します。