获取日历月的第一个星期一

Question

我被困在日历/时区/日期组件/日期地狱中，我的头脑在旋转。

我正在创建一个日记应用程序，我希望它在全球范围内工作（使用 iso8601 日历）。

我正在尝试在 iOS 上创建一个类似于 macOS 日历的日历视图，以便我的用户可以浏览他们的日记条目（注意每个月的 7x6 网格）：

要获得本月的第一天，我可以执行以下操作：

func firstOfMonth(month: Int, year: Int) -> Date {

  let calendar = Calendar(identifier: .iso8601)

  var firstOfMonthComponents = DateComponents()
  // firstOfMonthComponents.timeZone = TimeZone(identifier: "UTC") // <- fixes daylight savings time
  firstOfMonthComponents.calendar = calendar
  firstOfMonthComponents.year = year
  firstOfMonthComponents.month = month
  firstOfMonthComponents.day = 01

  return firstOfMonthComponents.date!

}

(1...12).forEach {

  print(firstOfMonth(month: $0, year: 2018))

  /*

   Gives:

   2018-01-01 00:00:00 +0000
   2018-02-01 00:00:00 +0000
   2018-03-01 00:00:00 +0000
   2018-03-31 23:00:00 +0000
   2018-04-30 23:00:00 +0000
   2018-05-31 23:00:00 +0000
   2018-06-30 23:00:00 +0000
   2018-07-31 23:00:00 +0000
   2018-08-31 23:00:00 +0000
   2018-09-30 23:00:00 +0000
   2018-11-01 00:00:00 +0000
   2018-12-01 00:00:00 +0000
*/

}

这里有一个关于夏令时的直接问题。 可以通过取消注释注释行并强制以 UTC 计算日期来“修复”该问题。 我觉得在不同时区查看日历视图时，通过强制将其设置为 UTC，日期会变得无效。

真正的问题是：我如何获得包含该月第一天的一周中的第一个星期一？ 例如，我如何获得 2 月 29 日星期一或 4 月 26 日星期一？ （请参阅 macOS 屏幕截图）。 要到月底，我是否只需从开始的 42 天开始添加？ 还是那太天真了？

编辑

感谢当前的答案，但我们仍然被卡住了。

以下工作，直到您考虑夏令时：

Answer 1

好的，这将是一个冗长而复杂的答案（万岁！）。

总体而言，您走在正确的轨道上，但仍存在一些细微的错误。

概念化日期

现在（我希望） Date代表时间的瞬间已经非常成熟。 不太确定的是相反的情况。 Date代表一个瞬间，但什么代表日历值？

当您考虑它时，“天”或“小时”（甚至“月”）是一个范围。 它们是表示开始时刻和结束时刻之间所有可能时刻的值。

出于这个原因，我发现在处理日历值时考虑范围最有帮助。 换句话说，通过询问“这一分钟/小时/天/周/月/年的范围是多少？” 等等。

有了这个，我想你会发现更容易理解发生了什么。 你已经了解Range<Int>了吧？ 所以Range<Date>同样直观。

幸运的是， Calendar上有 API 可以获取范围。 不幸的是，由于 Objective-C 时代的保留 API，我们不能完全使用Range<Date> 。 但是我们得到了NSDateInterval ，这实际上是一回事。

您可以通过向Calendar询问包含特定时刻的小时/日/周/月/年范围来请求范围，如下所示：

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

let today = calendar.dateInterval(of: .day, for: now)

有了这个，你可以得到几乎任何东西的范围：

let units = [Calendar.Component.second, .minute, .hour, .day, .weekOfMonth, .month, .quarter, .year, .era]

for unit in units {
    let range = calendar.dateInterval(of: unit, for: now)
    print("Range of \(unit): \(range)")
}

在我写这篇文章的时候，它打印：

Range of second: Optional(2018-10-04 19:50:10 +0000 to 2018-10-04 19:50:11 +0000)
Range of minute: Optional(2018-10-04 19:50:00 +0000 to 2018-10-04 19:51:00 +0000)
Range of hour: Optional(2018-10-04 19:00:00 +0000 to 2018-10-04 20:00:00 +0000)
Range of day: Optional(2018-10-04 06:00:00 +0000 to 2018-10-05 06:00:00 +0000)
Range of weekOfMonth: Optional(2018-09-30 06:00:00 +0000 to 2018-10-07 06:00:00 +0000)
Range of month: Optional(2018-10-01 06:00:00 +0000 to 2018-11-01 06:00:00 +0000)
Range of quarter: Optional(2018-10-01 06:00:00 +0000 to 2019-01-01 07:00:00 +0000)
Range of year: Optional(2018-01-01 07:00:00 +0000 to 2019-01-01 07:00:00 +0000)
Range of era: Optional(0001-01-03 00:00:00 +0000 to 139369-07-19 02:25:04 +0000)

您可以看到显示的各个单位的范围。 这里有两点需要指出：

1. 此方法返回一个可选的（ DateInterval? ），因为它可能会在奇怪的情况下失败。 我想不出任何事情，但日历是变化无常的东西，所以请注意这一点。

2. 要求一个时代的范围通常是一个荒谬的操作，即使时代对于正确构建日期至关重要。 在某些日历（主要是日本日历）之外的时代很难有太多的精确度，所以说“共同时代（公元或公元）开始于第一年的 1 月 3 日”的价值可能是错误的，但我们不能真的对此有所作为。 此外，当然，我们不知道当前时代何时结束，所以我们只是假设它永远持续下去。

打印Date值

这让我想到下一点，关于打印日期。 我在您的代码中注意到了这一点，我认为这可能是您的某些问题的根源。 我赞赏你为解释夏令时这一令人憎恶的事情所做的努力，但我认为你被一些实际上不是错误的东西所吸引，但这是：

Dates总是以 UTC 打印。

永远永远永远。

这是因为它们是时间上的瞬间，无论您是在加利福尼亚、吉布提、加德满都还是其他任何地方，它们都是相同的瞬间。 一个Date值没有一个时区。 它实际上只是与另一个已知时间点的偏移。 但是，将560375786.836208打印为Date's描述对人类来说似乎没什么用，因此 API 的创建者将其打印为相对于 UTC 时区的公历日期。

如果你想打印一个日期，即使是为了调试，你几乎肯定需要一个DateFormatter 。

DateComponents.date

这不是你的代码的问题，而是更多的提醒。 该.date物业DateComponents并不能保证返回指定的组件匹配的第一个瞬间。 它不保证返回与组件匹配的最后时刻。 它所做的只是保证，如果它可以找到答案，它将在指定单位范围内的某处为您提供Date 。

我不认为您在技术上依赖于您的代码中的这一点，但了解这一点是件好事，而且我已经看到这种误解导致了软件中的错误。

---

考虑到所有这些，让我们来看看您想要做什么：

1. 你想知道一年的范围
2. 你想知道一年中的所有月份
3. 你想知道一个月的所有日子
4. 您想知道包含该月第一天的那一周

因此，根据我们对范围的了解，现在这应该非常简单，而且有趣的是，我们可以在不需要单个DateComponents值的情况下完成所有DateComponents 。 在下面的代码中，为了简洁起见，我将强制展开值。 在您的实际代码中，您可能希望有更好的错误处理。

年的范围

这很简单：

let yearRange = calendar.dateInterval(of: .year, for: now)!

一年中的几个月

这有点复杂，但还不错。

var monthsOfYear = Array<DateInterval>()
var startOfCurrentMonth = yearRange.start
repeat {
    let monthRange = calendar.dateInterval(of: .month, for: startOfCurrentMonth)!
    monthsOfYear.append(monthRange)
    startOfCurrentMonth = monthRange.end.addingTimeInterval(1)
} while yearRange.contains(startOfCurrentMonth)

基本上，我们将从一年中的第一个时刻开始，并在日历中查询包含该时刻的月份。 一旦我们得到了那个，我们将获得那个月的最后时刻，并为其增加一秒以（表面上）将其转移到下个月。 然后我们将获得包含该时刻的月份范围，依此类推。 重复直到我们有一个不再在年份中的值，这意味着我们已经聚合了初始年份的所有月份范围。

当我在我的机器上运行它时，我得到了这个结果：

[
    2018-01-01 07:00:00 +0000 to 2018-02-01 07:00:00 +0000, 
    2018-02-01 07:00:00 +0000 to 2018-03-01 07:00:00 +0000, 
    2018-03-01 07:00:00 +0000 to 2018-04-01 06:00:00 +0000, 
    2018-04-01 06:00:00 +0000 to 2018-05-01 06:00:00 +0000, 
    2018-05-01 06:00:00 +0000 to 2018-06-01 06:00:00 +0000, 
    2018-06-01 06:00:00 +0000 to 2018-07-01 06:00:00 +0000, 
    2018-07-01 06:00:00 +0000 to 2018-08-01 06:00:00 +0000, 
    2018-08-01 06:00:00 +0000 to 2018-09-01 06:00:00 +0000, 
    2018-09-01 06:00:00 +0000 to 2018-10-01 06:00:00 +0000, 
    2018-10-01 06:00:00 +0000 to 2018-11-01 06:00:00 +0000, 
    2018-11-01 06:00:00 +0000 to 2018-12-01 07:00:00 +0000, 
    2018-12-01 07:00:00 +0000 to 2019-01-01 07:00:00 +0000
]

同样，重要的是要在这里指出这些日期是 UTC，即使我在山区时区。 因此，小时在 07:00 和 06:00 之间变化，因为山区时区比 UTC 晚 7 或 6 小时，这取决于我们是否观察到 DST。 所以这些值对于我日历的时区是准确的。

一个月的日子

这就像之前的代码：

var daysInMonth = Array<DateInterval>()
var startOfCurrentDay = currentMonth.start
repeat {
    let dayRange = calendar.dateInterval(of: .day, for: startOfCurrentDay)!
    daysInMonth.append(dayRange)
    startOfCurrentDay = dayRange.end.addingTimeInterval(1)
} while currentMonth.contains(startOfCurrentDay)

当我运行它时，我得到了这个：

[
    2018-10-01 06:00:00 +0000 to 2018-10-02 06:00:00 +0000, 
    2018-10-02 06:00:00 +0000 to 2018-10-03 06:00:00 +0000, 
    2018-10-03 06:00:00 +0000 to 2018-10-04 06:00:00 +0000, 
    ... snipped for brevity ...
    2018-10-29 06:00:00 +0000 to 2018-10-30 06:00:00 +0000, 
    2018-10-30 06:00:00 +0000 to 2018-10-31 06:00:00 +0000, 
    2018-10-31 06:00:00 +0000 to 2018-11-01 06:00:00 +0000
]

包含一个月开始的一周

让我们回到上面创建的monthsOfYear数组。 我们将使用它来计算每个月的周数：

for month in monthsOfYear {
    let weekContainingStart = calendar.dateInterval(of: .weekOfMonth, for: month.start)!
    print(weekContainingStart)
}

对于我的时区，这会打印：

2017-12-31 07:00:00 +0000 to 2018-01-07 07:00:00 +0000
2018-01-28 07:00:00 +0000 to 2018-02-04 07:00:00 +0000
2018-02-25 07:00:00 +0000 to 2018-03-04 07:00:00 +0000
2018-04-01 06:00:00 +0000 to 2018-04-08 06:00:00 +0000
2018-04-29 06:00:00 +0000 to 2018-05-06 06:00:00 +0000
2018-05-27 06:00:00 +0000 to 2018-06-03 06:00:00 +0000
2018-07-01 06:00:00 +0000 to 2018-07-08 06:00:00 +0000
2018-07-29 06:00:00 +0000 to 2018-08-05 06:00:00 +0000
2018-08-26 06:00:00 +0000 to 2018-09-02 06:00:00 +0000
2018-09-30 06:00:00 +0000 to 2018-10-07 06:00:00 +0000
2018-10-28 06:00:00 +0000 to 2018-11-04 06:00:00 +0000
2018-11-25 07:00:00 +0000 to 2018-12-02 07:00:00 +0000

您会在这里注意到的一件事是，这将星期日作为一周的第一天。 例如，在您的屏幕截图中，您的一周包含 2 月 1 日，从 29 日开始。

该行为由Calendar上的firstWeekday属性控制。 默认情况下，该值可能为1 （取决于您的语言环境），表示周从星期日开始。 如果您希望您的日历在一周从Monday开始的地方进行计算，那么您需要将该属性的值更改为2 ：

var weeksStartOnMondayCalendar = calendar
weeksStartOnMondayCalendar.firstWeekday = 2

for month in monthsOfYear {
    let weekContainingStart = weeksStartOnMondayCalendar.dateInterval(of: .weekOfMonth, for: month.start)!
    print(weekContainingStart)
}

现在，当我运行该代码时，我看到包含 2 月 1 日的那一周从 1 月 29 日“开始”：

2018-01-01 07:00:00 +0000 to 2018-01-08 07:00:00 +0000
2018-01-29 07:00:00 +0000 to 2018-02-05 07:00:00 +0000
2018-02-26 07:00:00 +0000 to 2018-03-05 07:00:00 +0000
2018-03-26 06:00:00 +0000 to 2018-04-02 06:00:00 +0000
2018-04-30 06:00:00 +0000 to 2018-05-07 06:00:00 +0000
2018-05-28 06:00:00 +0000 to 2018-06-04 06:00:00 +0000
2018-06-25 06:00:00 +0000 to 2018-07-02 06:00:00 +0000
2018-07-30 06:00:00 +0000 to 2018-08-06 06:00:00 +0000
2018-08-27 06:00:00 +0000 to 2018-09-03 06:00:00 +0000
2018-10-01 06:00:00 +0000 to 2018-10-08 06:00:00 +0000
2018-10-29 06:00:00 +0000 to 2018-11-05 07:00:00 +0000
2018-11-26 07:00:00 +0000 to 2018-12-03 07:00:00 +0000

---

最后的想法

有了所有这些，您就拥有了构建与 Calendar.app 所示相同的 UI 所需的所有工具。

作为额外的奖励，无论您的日历、时区和语言环境如何，我在此处发布的所有代码都可以运行。 它可以为日本日历、科普特日历、希伯来日历、ISO8601 等构建 UI。它可以在任何时区工作，也可以在任何语言环境中工作。

此外，拥有像这样的所有DateInterval值可能会使实现您的应用程序更容易，因为进行“范围包含”检查是您在制作日历应用程序时想要进行的那种检查。

唯一的另一件事是确保在将这些值呈现为String时使用DateFormatter 。 请不要拉出单独的日期组件。

如果您有后续问题，请将它们作为新问题发布，并在评论中@mention我。

Answer 2

查看我几年前写的一些代码来做类似的事情，它就像......

• 获取当月第一天的日期
• 获取当天的dayNumber ( CalendarUnit.weekday )
• 要显示的前一周的天数 = dayNumber - 1
• 从第一天减去它以获得日历开始日期

Answer 3

那对我有用...

let calendar = Calendar.autoupdatingCurrent
let date = Date().description(with: Locale.current)

func firstDayOfMonth(month:Int, year:Int) -> Date {

    var firstOfMonthComponents = DateComponents()
    firstOfMonthComponents.calendar = calendar
    firstOfMonthComponents.year = year
    firstOfMonthComponents.month = month
    firstOfMonthComponents.day = 01
    
    return firstOfMonthComponents.date!
}

func firstMonday(month:Int, year:Int) -> Date {
    
    let first = firstDayOfMonth(month: month, year: year)

    let dayNumber = calendar.component(.weekday, from: first)
    let daysToAdd = ((calendar.firstWeekday + 7) - dayNumber) % 7
    return calendar.date(byAdding: .day, value: daysToAdd, to: first)!

}

(1...12).forEach {
    print(firstMonday(month: $0, year: 2021).description(with: Locale.current))
}

Answer 4

我有第一个问题的答案：

第一个问题：我现在如何获得包含该月第一天的一周中的第一个星期一？ 例如，我如何获得 2 月 29 日星期一或 4 月 26 日星期一？ （请参阅 macOS 屏幕截图）。 要到月底，我是否只需从开始的 42 天开始添加？ 还是那太天真了？

let calendar = Calendar(identifier: .iso8601)
    func firstOfMonth(month: Int, year: Int) -> Date {



        var firstOfMonthComponents = DateComponents()
        firstOfMonthComponents.calendar = calendar
        firstOfMonthComponents.year = year
        firstOfMonthComponents.month = month
        firstOfMonthComponents.day = 01

        return firstOfMonthComponents.date!
    }

    var aug01 = firstOfMonth(month: 08, year: 2018)
    let dayOfWeek = calendar.component(.weekday, from: aug01)
    if dayOfWeek <= 4 { //thursday or earlier
         //take away dayOfWeek days from aug01
    else {
         //add 7-dayOfWeek days to aug01
    }