NSCalendar的某些方法不包含在在线文档中。这些可以安全使用吗？

Question

在使用Swift使用NSDate和NSCalendar的过程中，我遇到了NSCalendar中一些公开但未包含在在线文档中的API方法。

NSCalendar documentation

遵循其中一些API方法：

@availability(iOS, introduced=8.0)
func compareDate(date1: NSDate, toDate date2: NSDate, toUnitGranularity unit: NSCalendarUnit) -> NSComparisonResult

@availability(iOS, introduced=8.0)
func isDate(date1: NSDate, equalToDate date2: NSDate, toUnitGranularity unit: NSCalendarUnit) -> Bool

@availability(iOS, introduced=8.0)
func isDateInToday(date: NSDate) -> Bool

这些方法使日期操作非常容易，但我不确定是否应该使用这些方法，因为这些方法没有文档记录。

现在的问题是，这些在iOS应用程序中使用是否安全？我的意思是，它们是否会在没有通知或向后兼容的情况下被更改或删除，是否会批准使用这些方法的任何应用程序？

Answer 1

这些方法是公开声明的（即它们在NSCalendar.h中），因此它们是合法使用的。它们可能没有在线记录，但这看起来像是一个文档问题，因为它自2011年以来（在撰写本文时）尚未正确更新。

另请注意，其他人已发现并评论了这些API添加的有用性，例如NSHipster。

因此，假设您只支持iOS 8+，那么您可以使用这些（方便的）API方法。