Ios 在线文档中未包含NSCalendar的某些方法。这些东西使用安全吗？

在使用Swift处理NSDate和NSCalendar时，我在NSCalendar中使用了一些API方法，这些方法是公开的，但未包含在在线文档中

以下是一些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应用程序中使用安全吗？我的意思是，它们是否会在没有通知或向后兼容的情况下被更改或删除，使用这些方法的任何应用程序是否会被批准？

这些方法是公开声明的（即它们在

NSCalendar.h

中），因此它们是合法使用的。它们可能没有在线记录，但这看起来像是一个文档问题，因为自2011年（撰写本文时）以来，它一直没有得到适当的更新

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

因此，假设您只支持iOS8+，那么您最好使用这些（方便的）API方法