Calendar.current.range()の戻り値

Question

Calendar.current.range(of: .weekOfMonth, in: .month, for: components)

これの戻り値はなんですか？
appleのドキュメントも見たのですがよくわかりませんでした。

ドキュメントの内容
Returns the range of absolute time values that a smaller calendar component (such as a day) can take on in a larger calendar component (such as a month) that includes a specified absolute time.

Answer 1

最後の引数は日付で、これは「date を含む月の weekOfMonth の範囲はどこからどこまでか」を返します。

Calendar.current.range(of: .weekOfMonth, in: .month, for: date)

---

まず、わかりやすい例として of: .day, in: .month の場合を考えます。

import Foundation

func d(_ str: String) -> Date {
    let f = DateFormatter()
    f.locale = Locale(identifier: "en_US_POSIX")
    f.dateFormat = "yyyy/MM/dd"
    return f.date(from: str)!
}

print(Calendar.current.range(of: .day, in: .month, for: d("2019/02/01"))!)
print(Calendar.current.range(of: .day, in: .month, for: d("2020/02/01"))!)
print(Calendar.current.range(of: .day, in: .month, for: d("2020/03/01"))!)
print(Calendar.current.range(of: .day, in: .month, for: d("2020/04/01"))!)

それぞれ 1..<29, 1..<30, 1..<32, 1..<31 と表示します。
これは、2019年2月の範囲は1〜28日、2020年2月はうるう年なので1〜29日、3月は1〜31日、4月は1〜30日という意味です。（..< なので最後の数字は含まないことに注意。）

---

次に、本題の of: .weekOfMonth, in: .month の場合ですが、

print(Calendar.current.range(of: .weekOfMonth, in: .month, for: d("2020/03/01"))!)
print(Calendar.current.range(of: .weekOfMonth, in: .month, for: d("2020/05/01"))!)

の結果は 1..<6, 1..<7 となります。これは以下のように考えられます。

     March 2020
Su Mo Tu We Th Fr Sa
 1  2  3  4  5  6  7  ... 第1週
 8  9 10 11 12 13 14  ... 第2週
15 16 17 18 19 20 21  ... 第3週
22 23 24 25 26 27 28  ... 第4週
29 30 31              ... 第5週

      May 2020
Su Mo Tu We Th Fr Sa
                1  2  ... 第1週
 3  4  5  6  7  8  9  ... 第2週
10 11 12 13 14 15 16  ... 第3週
17 18 19 20 21 22 23  ... 第4週
24 25 26 27 28 29 30  ... 第5週
31                    ... 第6週

また、うるう年でない年の2月は28日（つまり4週間）ですが、

print(Calendar.current.range(of: .weekOfMonth, in: .month, for: d("2015/02/01"))!)
print(Calendar.current.range(of: .weekOfMonth, in: .month, for: d("2019/02/01"))!)

の結果は 1..<5, 1..<6 となります。

   February 2015
Su Mo Tu We Th Fr Sa
 1  2  3  4  5  6  7  ... 第1週
 8  9 10 11 12 13 14  ... 第2週
15 16 17 18 19 20 21  ... 第3週
22 23 24 25 26 27 28  ... 第4週

   February 2019
Su Mo Tu We Th Fr Sa
                1  2  ... 第1週
 3  4  5  6  7  8  9  ... 第2週
10 11 12 13 14 15 16  ... 第3週
17 18 19 20 21 22 23  ... 第4週
24 25 26 27 28        ... 第5週

また、週の初めの日によっても変わります。今までは日曜日でしたが、これを月曜日に変更すると、

var cal = Calendar.current
cal.firstWeekday = 2
print(cal.range(of: .weekOfMonth, in: .month, for: d("2020/03/01"))!)

の結果は 1..<7 となります。

     March 2020
Mo Tu We Th Fr Sa Su
                   1  ... 第1週
 2  3  4  5  6  7  8  ... 第2週
 9 10 11 12 13 14 15  ... 第3週
16 17 18 19 20 21 22  ... 第4週
23 24 25 26 27 28 29  ... 第5週
30 31                 ... 第6週

---

さらに、of: .day, in: .weekOfMonth とするとその週が何日から何日までかを返します。

print(Calendar.current.range(of: .day, in: .weekOfMonth, for: d("2020/01/01"))!)
print(Calendar.current.range(of: .day, in: .weekOfMonth, for: d("2020/01/05"))!)
print(Calendar.current.range(of: .day, in: .weekOfMonth, for: d("2020/01/31"))!)

はそれぞれ 1..<5, 5..<12, 26..<32 と表示します。

    January 2020
Su Mo Tu We Th Fr Sa
          1  2  3  4
 5  6  7  8  9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31

Comments

[退会済みユーザー]

ものすごく丁寧にありがとうございましたm(__)m
おかげさまで理解できました！

※返信遅れてすみません。