【Swift】Calendar構造体の使い方!暦法の変更と日付の計算

この記事からわかること
- SwiftのCalendar構造体の使い方
- ユーザー端末のカレンダー情報を取得する方法
- グレゴリオ暦(西暦)などの暦法を指定する方法
- 日付の一部(年、月、日など)だけを取得をする方法
- Calendar.Identifier型の種類
- Calendar.Component型の種類
- 日付の差分や加算、減算などの計算方法
index
[open]
\ アプリをリリースしました /
参考文献: API Collection Dates and Times
Swiftの日付や時間操作API
Swiftでは日付や時間などを操作、管理するためにいくつかの構造体やクラスが基礎となるFoundationフレークワークの中に用意されています。
Date構造体
・・・日付(カレンダーやタイムゾーンと無関係)
DateInterval構造体
・・・期間
TimeIntervalタイプエイリアス
・・・秒数(Double型のエイリアス)
DateComponents構造体
・・・日付(カレンダーやタイムゾーン)
Calendar構造体
・・・カレンダー
TimeZone構造体
・・・タイムゾーン
DateFormatterクラス
・・・文字列表現など
ざっくり見ると上記の通りです。それぞれ日時に関する機能を提供するAPIですが細かい役割が異なります。
おすすめ記事
【Swift UI】typealias(タイプエイリアス)の使い方とメリット
【Swift】DateFormatterの使い方!書式や日付形式の調整方法
【Swift】DateComponentsとは?使用方法とDate型との違い
【Swift】Date構造体の使い方!日付の計算や比較方法
Calendar構造体とは?
Calendar
構造体とは暦単位の日時情報を定義するオブジェクトです。Swiftで日時情報を扱う上でDate
型は欠かせませんが、Date型はあくまで特定の日時を表現するオブジェクトであり、カレンダーやタイムゾーンとは基本的には無関係です。
カレンダーやタイムゾーンから特定の日時情報(Date型)を参照することで曜日や国ごとの時差などを識別することが可能になります。
Calendar
構造体は暦(こよみ:グレゴリオ暦や和暦など)の設定や曜日情報、日付の差分、計算、比較など日時に纏わる機能を提供しています。
ユーザー端末のカレンダーインスタンスを取得する
ユーザーによって言語や暦などが異なるのはいうまでもありませんが、アプリを開発する際にはそのユーザーや地域に沿ったカレンダー情報を適切に扱う必要があります。Calendar
構造体ではユーザーが端末で指定しているカレンダー情報を取得するcurrent
プロパティを保持しています。
任意の暦法のインスタンスを生成する
端末に倣ったものではなく、任意の暦法のカレンダーインスタンスを生成したい場合はinit(identifier:)
を使用します。引数には列挙型Calendar.Identifier
で定義された値を渡します。例えばグレゴリオ暦(西暦)の場合は.gregorian
を指定します。
Calendar.Identifier型の種類
指定できるCalendar.Identifier型は以下の通りです。
値 | 説明 |
---|---|
gregorian | グレゴリオ暦を使用するカレンダー |
buddhist | 仏教の伝統に基づいたカレンダー |
chinese | 中国の伝統的な太陰太陽暦に基づいたカレンダー |
coptic | コプト正教会の暦に基づいたカレンダー |
ethiopicAmeteMihret | エチオピア正教会の暦に基づいたカレンダー |
ethiopicAmeteAlem | エチオピアの一般的な暦に基づいたカレンダー |
hebrew | ユダヤ暦に基づいたカレンダー |
indian | ヒンドゥー教やジャイナ教など、インド亜大陸の伝統的なカレンダーに基づいたカレンダー |
islamic | イスラム暦に基づいたカレンダー |
islamicCivil | イスラム暦の文明暦に基づいたカレンダー |
japanese | 日本の伝統的な太陽暦に基づいたカレンダー |
persian | ペルシャ暦に基づいたカレンダー |
republicOfChina | 中華民国(台湾)のカレンダー |
iso8601 | ISO8601 カレンダーの識別子。 |
日付(Date構造体)の生成
Calendar構造体からDate構造体を生成することも可能です。生成するためのメソッドは複数用意されているので使い方を見ていきます。
date(from:DateComponents)メソッド
date(from:DateComponents)
メソッドはDateComponents
型からDate型を生成するメソッドです。
逆にDate
型からDateComponents
型を生成するにはdateComponents(in:from:)
メソッドを使用します。
startOfDay(for: Date)メソッド
startOfDay(for: Date)
メソッドは引数に渡したDate型の最初の瞬間(= 0時00分00秒)のインスタンスを生成します。例えば以下のように現在時刻を保持したインスタンスから時間を初期化したインスタンスを生成できます。
DateオブジェクトはUTC(協定世界時)で日時情報を保持しているためであり、そのままprint
するとUTCと日本標準時(JTC)との誤差分(9時間)ズレてしまうため注意してください。
年や月、日など一部のみを取得
Calendar
構造体のcomponent(_:from:)
メソッドを使用して年や月、日など一部のみを取得することも可能です。
引数には取得したい一部をCalendar.Component型
で渡します。
Calendar.Component型
指定できるCalendar.Component型は以下の通りです。
値 | 説明 |
---|---|
era | 年代 |
year | 年 |
quarter | 四半期 |
month | 月 |
weekOfMonth | 月の中での週 |
weekOfYear | 年の中での週 |
weekday | 週の曜日 |
weekdayOrdinal | 週の中での曜日の順序 |
day | 日 |
hour | 時 |
minute | 分 |
second | 秒 |
nanosecond | ナノ秒 |
calendar | カレンダー |
timeZone | タイムゾーン |
quarterOfYear | 年の中での四半期 |
weekOfQuarter | 四半期の中での週 |
日付の計算
Calendar
構造体を使用して任意の日付(Date構造体)に対しての加算や減算、任意の日付(Date構造体)間同士の期間の計算などを行うメソッドも用意されています。
date(byAdding:,value:,to:)メソッド
date(byAdding:,value:,to:)
メソッドを使用することで任意の日付から2日後や3日前など日数を計算した日付を取得することができます。
任意の日付間の期間を計算する
任意の日付間の期間を計算する方法はいくつかあるかと思いますが、以下の方法でも取得することが可能です。
DateInterval型を取得する
日付の期間を保持するデータ型としてDateInterval
型が用意されています。Calender構造体ではdateInterval(of:for:)
メソッドを使用して任意の間隔のDateInterval
型を取得できます。
これを使用することで以下のように現在日時が含まれる週を取得することが可能です。
日時の特定の部分を再設定する
公式リファレンス:date(bySetting:value:of:)
日付情報の「秒数だけ0」にしたり、「年数だけ2024」にしたりといった特定の日時の部分だけを変更したい場合はdate(bySetting:value:of:)
メソッドを使用します。
まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。
ご覧いただきありがとうございました。