インスタンスメソッド

ordinality(of:in:for:)

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

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+

func ordinality(

of smaller: Calendar.Component,

in larger: Calendar.Component,

for date: Date

) -> Int?

パラメータ

smaller

より小さなカレンダーコンポーネント。

larger

より大きなカレンダーコンポーネント。

date

それの計算が実行される絶対時間。

戻り値

日付で指定された時刻における、より大きな値の中のより小さな値の序数。カレンダー内で大きい方が小さい方の値より論理的に大きくない場合、または与えられたコンポーネントの組み合わせが意味をなさない (または計算が未定義である) 場合は nil を返します。

議論

順序は、ほとんどの場合、コンポーネントの分解された値と同じではありません。通常、戻り値は 1 以上です。たとえば、時刻 00:45 は 1 日の最初の 1 時間であり、コンポーネントの hour と day については、結果はそれぞれ 1 になります。例外は月内の週の計算で、日付を含む月の最初の週より前の日には 0 を返します。

注意 : 一部の計算には比較的長い時間がかかる場合があります。