[Xcode/Swift] Date型を深く知る

Contents 非表示

Dateの基本
Dateの比較と計算
Calendarを使った日付操作
DateFormatterを使った日付のフォーマット
DateComponentsを使ったカスタム日付の作成
タイムゾーンとロケールの操作
DateとTimeIntervalの扱い
ISO8601DateFormatterによるISO 8601形式の操作
まとめ

Dateの基本

Date型は、1970年1月1日（Unixエポック）からの秒数で時刻を表します。Date型のインスタンスは、現在の日時や特定の日時を保持します。

// 現在の日付と時刻を取得
let now = Date()

// 特定の日時を作成
let customDate = Date(timeIntervalSince1970: 1624046400) // 2021年6月18日 12:00:00 UTC

Dateの比較と計算

Date型では、日付の比較や計算を行うことができます。以下は、二つの日付を比較したり、時間を加減するサンプルです。

let now = Date()
let oneHourLater = now.addingTimeInterval(3600) // 1時間後の日時

// 日付の比較
if oneHourLater > now {
    print("1時間後は未来です。")
}

// 日付の引き算
let timeInterval = oneHourLater.timeIntervalSince(now) // 3600秒（1時間）

Calendarを使った日付操作

Calendarを使うと、日付の計算がさらに柔軟に行えます。特定の日付に日数、月数、年数を加算・減算することが可能です。

let now = Date()
let calendar = Calendar.current

// 1日後
if let tomorrow = calendar.date(byAdding: .day, value: 1, to: now) {
    print("明日は\(tomorrow)です。")
}

// 1ヶ月前
if let lastMonth = calendar.date(byAdding: .month, value: -1, to: now) {
    print("1ヶ月前は\(lastMonth)でした。")
}

DateFormatterを使った日付のフォーマット

DateFormatterは、Date型を人間が読みやすい形式に変換したり、その逆を行ったりするために使用します。

let now = Date()
let formatter = DateFormatter()
formatter.dateStyle = .full
formatter.timeStyle = .short
formatter.locale = Locale(identifier: "ja_JP")

let formattedDate = formatter.string(from: now)
print("現在の日時: \(formattedDate)") // 例: 2024年8月15日(木) 12:34

DateComponentsを使ったカスタム日付の作成

DateComponentsを使うと、年、月、日、時刻などを個別に指定して日付を作成できます。

var components = DateComponents()
components.year = 2025
components.month = 5
components.day = 10
components.hour = 15
components.minute = 30

let calendar = Calendar.current
if let customDate = calendar.date(from: components) {
    print("カスタム日付: \(customDate)")
}

タイムゾーンとロケールの操作

Date型はタイムゾーンやロケールの違いを意識せずに使えますが、DateFormatterなどでこれらを考慮する必要があります。

let formatter = DateFormatter()
formatter.dateStyle = .long
formatter.timeStyle = .long
formatter.timeZone = TimeZone(abbreviation: "PST") // 太平洋標準時
formatter.locale = Locale(identifier: "en_US")

let now = Date()
let formattedDate = formatter.string(from: now)
print("PSTでの現在の日時: \(formattedDate)")

DateとTimeIntervalの扱い

TimeIntervalは秒単位の時間を表す型で、Doubleとして定義されています。時間の計算や日時の差分を表すのに便利です。

let startDate = Date()
// 処理の実行...
let endDate = Date()

let duration = endDate.timeIntervalSince(startDate)
print("処理時間: \(duration)秒")

ISO8601DateFormatterによるISO 8601形式の操作

ISO 8601形式は、国際的に標準化された日時フォーマットです。ISO8601DateFormatterを使うと、これに対応する日付の操作が可能です。

let isoFormatter = ISO8601DateFormatter()
let now = Date()

// ISO 8601形式に変換
let isoString = isoFormatter.string(from: now)
print("ISO 8601形式: \(isoString)")

// ISO 8601形式からDateに変換
if let dateFromISO = isoFormatter.date(from: isoString) {
    print("ISO 8601から変換された日付: \(dateFromISO)")
}

まとめ

Date型は、シンプルなAPIでありながら非常に多機能であり、日付や時間に関する操作を柔軟に行うことができます。CalendarやDateFormatter、DateComponentsなどと組み合わせることで、あらゆる日時関連の処理を行うことが可能です。このガイドを参考に、ぜひ様々な場面でDate型を活用してみてください。