構造体


Calendar


カレンダー単位と絶対時点の関係の定義。日付の計算と比較の機能を提供します。


iOS 8.0+ iPadOS 8.0+ Mac Catalyst 13.0+ macOS 10.10+

tvOS 9.0+ VisionOS 1.0+ WatchOS 2.0+ Xcode 8.0+


struct Calendar





概観


Calendar は、年の開始、長さ、区分が定義される計算時間システムに関する情報をカプセル化します。カレンダーに関する情報を提供し、与えられた暦単位の範囲を決定したり、与えられた絶対時間に単位を追加したりするなど、暦の計算をサポートします。





トピックス


カレンダーの作成


enum Calendar.Identifier

使用可能なカレンダーの列挙。



ユーザのカレンダーを取得


static var autoupdatingCurrent: Calendar

ユーザ設定のカレンダーの変更を追跡するカレンダー。


static var current: Calendar

ユーザの現在のカレンダー。



コンポーネントの抽出


func date(Date, matchesComponents: DateComponents) -> Bool

日付に指定された日付コンポーネントがすべて含まれているかどうかを判断します。


func component(Calendar.Component, from: Date) -> Int

日付の 1 つのコンポーネントの値を返します。


func dateComponents(Set<Calendar.Component>, from: Date) -> DateComponents

カレンダーのタイムゾーンを使用して、日付のすべての日付コンポーネントを返します。


func dateComponents(Set<Calendar.Component>, from: Date, to: Date) -> DateComponents

2 つの日付の差を返します。


func dateComponents(Set<Calendar.Component>, from: DateComponents, to: DateComponents) -> DateComponents

DateComponents として指定された 2 つの日付の差を返します。


func dateComponents(in: TimeZone, from: Date) -> DateComponents

与えられたタイムゾーン (Calendar のタイムゾーンではなく) にあるかのように、日付のすべての日付コンポーネントを返します。


enum Calendar.Component

カレンダーの日付のさまざまなコンポーネントの列挙。



カレンダー情報の取得


var identifier: Calendar.Identifier

カレンダーの識別子。


var locale: Locale?

カレンダーのロケール。


var firstWeekday: Int

カレンダーの週の最初の曜日。


var minimumDaysInFirstWeek: Int

最初の週の最小日数。


var timeZone: TimeZone

カレンダーのタイムゾーン。


func maximumRange(of: Calendar.Component) -> Range<Int>?

与えられたコンポーネントが取ることができる値の最大範囲の制限。


func minimumRange(of: Calendar.Component) -> Range<Int>?

与えられたコンポーネントが取ることができる値の最小範囲の制限を返します。


func ordinality(of: Calendar.Component, in: Calendar.Component, for: Date) -> Int?

与えられた絶対時間に対して、指定されたより大きなカレンダーコンポーネント (週など) 内のより小さなカレンダーコンポーネント (日など) の序数を返します。


func range(of: Calendar.Component, in: Calendar.Component, for: Date) -> Range<Int>?

指定された絶対時刻を含む、より大きなカレンダーコンポーネント (月など) 内で、より小さなカレンダーコンポーネント (日など) が取り得る絶対時刻値の範囲を返します。



日付のスキャン


func startOfDay(for: Date) -> Date

与えられた日付の最初の瞬間を日付として返します。


func enumerateDates(startingAfter: Date, matching: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection, using: (Date?, Bool, inout Bool) -> Void)

与えられたコンポーネントのセットに一致する (または最も近い) 日付を計算し、列挙が停止されるまで、各日付に対してクロージャを 1 回呼び出します。


func nextDate(after: Date, matching: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection) -> Date?

与えられたコンポーネントのセットに一致する (または最も近い) 次の日付を計算します。


enum Calendar.MatchingPolicy

日付の検索に使用するメソッドを制御するための検索アルゴリズムのヒント。


enum Calendar.RepeatedTimePolicy

カレンダーの日に時間が繰り返される場合 (たとえば、夏時間への移行時に午前 2 時から午前 3 時までの時間が 2 回発生する場合など) に使用する結果を決定します。



コンポーネントから日付を計算


func date(from: DateComponents) -> Date?

指定されたコンポーネントから作成された日付を返します。


func date(byAdding: DateComponents, to: Date, wrappingComponents: Bool) -> Date?

与えられた日付にコンポーネントを追加して計算された日付を表す新しい Date を返します。


func date(byAdding: Calendar.Component, value: Int, to: Date, wrappingComponents: Bool) -> Date?

与えられた日付に特定のコンポーネントの量を追加して計算された日付を表す新しい Date を返します。


func date(bySetting: Calendar.Component, value: Int, of: Date) -> Date?

特定のコンポーネントを与えられた時刻に設定し、下位のコンポーネントを同じに保つようにして計算された日付を表す新しい Date を返します。コンポーネントにすでにその値がある場合、与えられた日付と同じ日付になる可能性があります。


func date(bySettingHour: Int, minute: Int, second: Int, of: Date, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection) -> Date?

指定された Date の与えられた時刻に時間、分、秒を設定して計算された日付を表す新しい Date を返します。



間隔の計算


func dateInterval(of: Calendar.Component, for: Date) -> DateInterval?

与えられた日付を含む与えられたカレンダーコンポーネントの開始時刻と期間を返します。


func dateInterval(of: Calendar.Component, start: inout Date, interval: inout TimeInterval, for: Date) -> Bool

2 つの inout パラメータを介して、与えられた日付を含む与えられたカレンダーコンポーネントの開始時刻と期間を返します。


func dateIntervalOfWeekend(containing: Date) -> DateInterval?

与えられた日付に含まれる週末の DateInterval を返します。日付が週末でない場合は nil を返します。


func dateIntervalOfWeekend(containing: Date, start: inout Date, interval: inout TimeInterval) -> Bool

2 つの参照パラメータによって返される、与えられた日付の前後の週末の範囲を検索します。


func nextWeekend(startingAfter: Date, direction: Calendar.SearchDirection) -> DateInterval?

与えられた日付より厳密に後に始まる次の週末の DateInterval を返します。


func nextWeekend(startingAfter: Date, start: inout Date, interval: inout TimeInterval, direction: Calendar.SearchDirection) -> Bool

2 つの inout パラメータを介して次の週末の範囲を返します。週末は与えられた日付より厳密に後に始まります。


enum Calendar.SearchDirection

検索すべき時間の方向。



日付の比較


func compare(Date, to: Date, toGranularity: Calendar.Component) -> ComparisonResult

指定されたコンポーネントまで 2 つの日付を比較します。


func isDate(Date, equalTo: Date, toGranularity: Calendar.Component) -> Bool

2 つの日付が指定されたコンポーネントまで等しいかどうかを示すブール値を返します。


func isDate(Date, inSameDayAs: Date) -> Bool

日付が別の日付と同じ日であるかどうかを示すブール値を返します。


func isDateInToday(Date) -> Bool

与えられた日付が今日中かどうかを示すブール値を返します。


func isDateInTomorrow(Date) -> Bool

与えられた日付が明日中かどうかを示すブール値を返します。


func isDateInYesterday(Date) -> Bool

与えられた日付が昨日中かどうかを示すブール値を返します。


func isDateInWeekend(Date) -> Bool

与えられた日付が週末期間内であるかどうかを示すブール値を返します。



カレンダーの比較


static func == (Calendar, Calendar) -> Bool

2 つのカレンダーが同じかどうかを示すブール値を返します。


static func != (Calendar, Calendar) -> Bool

2 つの値が等しくないかどうかを示すブール値を返します。



AM と PM のシンボルを取得


var amSymbol: String

カレンダーの locale にローカライズされた「AM」を表すために使用されるシンボル。


var pmSymbol: String

カレンダーの locale にローカライズされた「PM」を表すために使用されるシンボル。



曜日のシンボルを取得


var weekdaySymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの曜日のリスト。


var shortWeekdaySymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの短縮名の曜日のリスト。


var veryShortWeekdaySymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの非常に短い名前の曜日のリスト。


var standaloneWeekdaySymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの独立した曜日名のリスト。


var shortStandaloneWeekdaySymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの短い名前の独立した曜日のリスト。


var veryShortStandaloneWeekdaySymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの非常に短い名前の曜日のリスト。



月のシンボルを取得


var monthSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの月のリスト。


var shortMonthSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの短い名前の月のリスト。


var veryShortMonthSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの非常に短い名前の月のリストです。


var standaloneMonthSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの独立した月のリスト。


var shortStandaloneMonthSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの短い名前の独立した月のリスト。


var veryShortStandaloneMonthSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの非常に短い名前の独立した月のリスト。



四半期のシンボルを取得


var quarterSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの四半期の名前のリスト。


var shortQuarterSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの短い名前の四半期のリスト。


var standaloneQuarterSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの独立した名前の四半期のリスト。


var shortStandaloneQuarterSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの短い名前の独立した四半期のリスト。



紀元のシンボルを取得


var eraSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの紀元のリスト。


var longEraSymbols: [String]

カレンダーの locale にローカライズされた、このカレンダーの長い名前の紀元のリスト。



カレンダーの説明


var description: String

カレンダーのテキストによる説明。


var debugDescription: String

デバッグに適したロケールのテキストによる説明。


var customMirror: Mirror

カレンダーを映す鏡。


var hashValue: Int

カレンダーの計算されたハッシュ値。



コード化と復号化


func encode(to: any Encoder)

このカレンダーを与えられたエンコーダにコード化します。


init(from: any Decoder)

与えられた復号器から復号して新しいカレンダーインスタンスを作成します。



参照型の使用


class NSCalendar

カレンダー情報と計算をカプセル化したもので、Calendar にブリッジします。参照の意味やその他の Foundation 固有の動作が必要な場合は、NSCalendar を使用して下さい。


typealias Calendar.ReferenceType

この値型と同等の参照型のエイリアス。



イニシャライザ


init(identifier: Calendar.Identifier)



インスタンスメソッド


func dates(byAdding: DateComponents, startingAt: Date, in: Range<Date>?, wrappingComponents: Bool) -> Sendable & Sequence<Date>


func dates(byAdding: Calendar.Component, value: Int, startingAt: Date, in: Range<Date>?, wrappingComponents: Bool) -> Sendable & Sequence<Date>


func dates(byMatching: DateComponents, startingAt: Date, in: Range<Date>?, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection) -> Sendable & Sequence<Date>


func hash(into: inout Hasher)



構造体


struct Calendar.RecurrenceRule





関連


以下に準拠


CustomDebugStringConvertible

CustomReflectable

CustomStringConvertible

Decodable

Encodable

Hashable

ReferenceConvertible

Sendable





以下も見よ


暦の計算


struct DateComponents

カレンダーシステムとタイムゾーンで評価される単位 (年、月、日、時間、分など) で指定された日付または時刻。


struct TimeZone

特定の地政学的地域に関連する標準時の慣習に関する情報。


Weekday Weekday











トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ