这是一篇写给新手的NSDate教程（Swift版）

如果有人问我项目中最常用的东西是什么，我会告诉他：日期处理。毫无疑问，不管项目和“日期”有何关系，开发人员都需要和 NSDate  对象打交道。无论是把日期对象

转换成可读字符串，还是使用日期对象进行某种计算，都需要了解这方面的编程知识。日期编程很容易掌握，而且可以帮助你在其他重要的任务中有所收获。对编程新手来说处理日期是个麻烦事，实际上，只要你掌握要领，就得心应手。

在程序中使用 NSDate ，最常见的操作是将其转换成字符串对象，这样就可以很方便的进行格式化，供用户查看。另外，就是逆操作：将字符串对象转换成日期对象。但是，这些并不是所有关于日期的操作，以下是一些例子：

• 日期比较

• 给定一个日期（比如当前日期），计算某个时间段（比如某天、某月或某年）之后或之前的日期

• 计算日期差值（给定两个日期，计算间隔）

• 将日期对象拆分开，并访问不同的部分（年，月等）

所有上面的操作，包含字符串和日期之间的互相转换，是本教程的讨论对象。接下来的部分，你将看到这些操作都是十分简单的——关键是了解工具和使用方法。

下面，我列出了一些关键文档的链接供你参考。请先进行查看以便获取必要的信息：

• NSDate

• NSDateFormatter

• NSDateComponents

• NSDateComponentFormatter

• NSCalendar

基础知识

在我们开始详细学习日期处理之前，需要先搞懂一些基础概念。那就从最简单的 NSDate 对象开始吧，在日期编程中，这个对象描述了 日期 和 时间 信息。所以它不但用于日期，也用于时间处理。 格式化 这个概念在直接处理 NSDate 对象时还用不到。可以把日期和时间看做是类中普通的属性。只有在将日期对象转换为字符串对象时，才能用到格式化，接下来我们会看到许多格式化的实例。简单说来，不论你需要的是日期、时间，或者两者都需要， NSDate 类都可以胜任。

另外一个稍后需要关注的类是 NSDateComponents   。这个类可以简单的看做是  NSDate  的“姐妹”类，因为它为开发者带来了许多关于日期的便捷操作。其中一项重要内容是：它可以将日期和时间分割成独立的属性，这样就可以直接访问每项属性，这在诸如日期计算之类的任务中非常有用。例如： NSDateComponents  实例中的“天”和“月”就可以按照如下方式展现：

let dateComponents = NSDateComponents() let day = dateComponents.day let month = dateComponents.month

这很简单。另外，访问日期组件（年，月，日等）并生成日期属性到 NSDateComponents 中去需要先执行一些转换命令，我们接下来会谈这个。除了上面这些功能外， NSDateComponents 类在计算过去或未来的时间上也很有用。只需要简单的对某个子属性（年，月年等）执行加减操作，就可以算出未来或过去的一个时间。另外， NSDateComponents 类还适合查找两个日期之间的间隔。后面我们会详细的说明。

我们暂时不会详细学习 NSDateComponents 类，这里我们只需要学一下如何将 NSDate 和 NSDateComponents 对象互相转换，要提到的另外一个重要角色是 NSCalendar 类。这个类的功能并不在本文的讨论范围，但是， NSDate 和 NSDateComponents 之间的互相转换，却是有 NSCalendar 类来控制的（因为需要制定某个 NSCalendar 对象，才能完成转换）。事实上，系统在进行转换时，需要知道使用的日历（历法）是哪个，然后才能获得正确的转换结果（要知道，世界上有许多不同的日历，其年月日的值是各不相同的）。你可以通过介绍中的文档链接查看关于calendar的详情，在这里，你只需要知道我们会用 NSCalendar 的 currentCalendar() 方法获取系统当前的calendar即可。

除了上述工具外，还有一个重要的 NSDateFormatter 类需要了解。这个类会帮助我们将 NSDate 对象转换为字符串对象，也可以将字符串对象转换为 NSDate 对象。通过它，可以将 NSDate 对象按照预定义的日期样式直接转换成字符串，也可以按自定义的日期格式进行转换。我们稍后会看到几个这样的实例，也会看到互相转换的例子。 NSDateFormatter 对象也支持本地化功能，只需要提供一个有效的 NSLocale 对象，就可以按照给定的locale设置转换成合适的字符串内容。

另外一个类似的类是 NSDateComponentsFormatter   ，它有一个重要目的：输入日期和时间，输出格式化好的可读字符串。它包含了许多方法来完成这个任务，在本教程最后部分你将看到几个这样的例子。但是在本教程中，除了例子中涉及的内容外，我们不会过多的讲解这个类。

接下来，我们将直接学习之前提到的工作时如何完成的。再次建议你新建一个 playground 文件，最好的学习方法就是自己亲身实践。

NSDate和字符串相互转换

一开始，我们需要通过 NSDate   类获取当前日期，并且将其赋值给一个常量。和其他语言不同，获取当前时间并不需要如  now()  或者  today()  之类特别的方法，只需要初始化一个  NSDate   对象即可。

let currentDate = NSDate()

在Xcode playground中写入代码后，结果如下：

注意： 这个值我们在后面会多次用到。现在来初始化一个  NSDateFormatter  对象，它是我们用来转换日期和字符串的工具。

let dateFormatter = NSDateFormatter()

dateFormatter   对象默认会使用系统中设置的区域信息，除非显式地设置区域。即便如此，手动设置区域也不是必须的。以下是设置区域的代码：

dateFormatter.locale = NSLocale.currentLocale()

设置其他区域也很简单，只需要通过 区域代码   匹配到对应的区域即可。

dateFormatter.locale = NSLocale(localeIdentifier: "el_GR") dateFormatter.locale = NSLocale(localeIdentifier: "fr_FR")

这两行代码展示了如何设置不同的区域，这里用的是希腊和法国。当然，这样依次设置多个区域是没有意义的，因为只有最后一次设置会生效。想知道区域信息对日期转换字符串有什么影响吗？马上你就会看到。

在将  NSDate   转换成字符串之前，你需要先“告诉”date formatter你想要什么样式的字符串。有两种方式可以设置格式:一种是通过一些预定义的日期格式化样式（style）；另外一种是通过某些说明符来手动设置日期格式。

我们先开始使用第一种方式，这里你会用到  NSDateFormatterStyle   的枚举类型，它有若干个枚举值，每个值都代表不同的样式。我们来逐个查看。第一个样式叫 完整样式（FullStyle） ，它的结果显示如下：

下面是代码，可以自己拷贝粘贴试试效果：

dateFormatter.dateStyle = NSDateFormatterStyle.FullStyle var convertedDate = dateFormatter.stringFromDate(currentDate)

除了日期样式的代码外， stringFromDate   方法的使用也很重要，它是真正执行转换的代码。当谈到日期、字符串转换时，就指的是这个方法，而其他步骤只是起到定制结果的辅助作用。如果你在项目里要用到日期转换，这个方法会非常方便。

接下来，我们来看一下 长样式（Long Style） ：

代码：

dateFormatter.dateStyle = NSDateFormatterStyle.LongStyle

和完整样式比，长样式少了“天”的信息。

下来是  中等样式(Medium Style) ：

dateFormatter.dateStyle = NSDateFormatterStyle.MediumStyle convertedDate = dateFormatter.stringFromDate(currentDate)

最后是短样式（Short Style）：

dateFormatter.dateStyle = NSDateFormatterStyle.ShortStyle convertedDate = dateFormatter.stringFromDate(currentDate)

现在你就知道了有哪些可用的日期样式，在项目中可以根据需要在日期中使用。每个样式都会产生不同的结果，说不定哪个会适合你。

之前我提到过如何改变默认的区域设置，既然我们已经学习了改变formatter，影响日期转换结果的方式，接下来我们试着改变一下区域设置，看看会产生什么样的效果。在这个例子中，我会用完整样式来转换日期字符串，设置区域为希腊和法国。

我想这个截图很好的说明了区域的作用，你可以按照自己的需要设置。

使用日期格式说明符

• EEEE：“星期”的全名（比如Monday）。如需缩写，指定1-3个字符（如E，EE，EEE代表Mon）。

• MMMM：“月份”的全名（比如October）。如需缩写，指定1-3个字符（如M，MM，MMM代表Oct）。

• dd：某月的第几天（例如，09或15）

• yyyy：四位字符串表示“年”（例如2015）

• HH：两位字符串表示“小时”（例如08或19）

• mm：两位字符串表示“分钟”（例如05或54）

• ss：两位字符串表示“秒”

• zzz：三位字符串表示“时区”（例如GMT）

• GGG：公元前BC或公元后AD

要查看完整的说明符文档，推荐访问 http://unicode.org/reports/tr35/tr35-6.html#Date_Format_Patterns 这个链接。

我们继续来看看这些说明符是如何发挥作用的。这次，让我们把当前时间转换成包含完整的星期、月份名称、日期和年份信息。

dateFormatter.dateFormat = "EEEE, MMMM dd, yyyy" convertedDate = dateFormatter.stringFromDate(currentDate)

没有必要解释代码了，这个用法很直截了当。让我们再转换一个时间字符串：

dateFormatter.dateFormat = "HH:mm:ss" convertedDate = dateFormatter.stringFromDate(currentDate)

到此，我们学到的转换都是把 *NSDate* 对象转成格式化的字符串对象。这个的逆过程也挺有意思，就是将格式化的字符串通过date formatter转换成  NSDate   对象，这里同样也会用到之前的日期样式和格式说明符。关键是要通过设置好的date formatter 对象调用  dateFromString  ，让我们来看个例子：

var dateAsString = "24-12-2015 23:59" dateFormatter.dateFormat = "dd-MM-yyyy HH:mm" var newDate = dateFormatter.dateFromString(dateAsString)

让我们看个包含时区信息的复杂字符串：

dateAsString = "Thu, 08 Oct 2015 09:22:33 GMT" dateFormatter.dateFormat = "EEE, dd MMM yyyy HH:mm:ss zzz" newDate = dateFormatter.dateFromString(dateAsString)

现在可以看到时间值（09:22）变成了12:22，这时因为时区生效了，实际上，时间并没有发生变换，这个时间（12:22）是GMT时间（09:22）加上我当前时区（EET：GMT+3）的时差后的结果。稍后我们会再看几个时区的例子，不过现在你可以在自己的机器上试一下效果。

到此，你已经掌握了日期、字符串间相互转换的知识。你可以自己尝试写写代码，来理解日期编程的原理。

使用NSDateComponents

let calendar = NSCalendar.currentCalendar()

现在，我们来看一个 *NSDate* 到 *NSDateComponents* 转换的具体例子：

let dateComponents = calendar.components([NSCalendarUnit.Day, NSCalendarUnit.Month, NSCalendarUnit.Year, NSCalendarUnit.WeekOfYear, NSCalendarUnit.Hour, NSCalendarUnit.Minute, NSCalendarUnit.Second, NSCalendarUnit.Nanosecond], fromDate: currentDate)   print("day = /(dateComponents.day)", "month = /(dateComponents.month)", "year = /(dateComponents.year)", "week of year = /(dateComponents.weekOfYear)", "hour = /(dateComponents.hour)", "minute = /(dateComponents.minute)", "second = /(dateComponents.second)", "nanosecond = /(dateComponents.nanosecond)" , separator: ", ", terminator: "")

• 年

• 月

• 日

• 一年中的第几个星期

• 小时

• 分钟

• 秒

• 毫微秒

这里需要注意：若某个组件没有在第一个参数中指定，就无法访问它。如：在这个例子中，我们没有指定 NSCalendarUnit.TimeZone ，这样就无法访问时区的组件，比如 print(dateComponents.timezone) 调用会造成一个运行时错误。如果你需要额外的日期组件，只能重新调用一次calendar.Components方法，把你需要的Calendar Unit添加进去。

date components到date对象的转换也很简单。这个过程中不需要使用calendar unit。只用初始换一个新的  NSDateComponents   对象，然后显式的设置你需要的组件的值，然后调用  NSCalendar   的  dateFromComponents  方法即可。

let components = NSDateComponents() components.day = 5 components.month = 01 components.year = 2016 components.hour = 19 components.minute = 30 newDate = calendar.dateFromComponents(components)

在文章的前面我们看到了如何通过设置时区来影响转换的字符串，如果你想知道改动时区会对转换日期对象有怎样的影响，可以参考下面的例子：

components.timeZone = NSTimeZone(abbreviation: "GMT") newDate = calendar.dateFromComponents(components) components.timeZone = NSTimeZone(abbreviation: "CST") newDate = calendar.dateFromComponents(components) components.timeZone = NSTimeZone(abbreviation: "CET") newDate = calendar.dateFromComponents(components)

比较日期和时间

另外一个使用场景是比对日期对象，查看一个日期是否早于、晚于或等于另外一个日期。简单说来，我会提供三种方法来比对日期对象，但不会说明哪种方法比较好一些，这些方法的差别不大，到底用哪个取决于你的需求。

开始接触比较方法之前，我们先创建两个自定义的日期对象作为示例。初始化两个date formatter对象，通过它们将格式化字符串转换成日期对象。

dateFormatter.dateFormat = "MMM dd, yyyy zzz" dateAsString = "Oct 08, 2015 GMT" var date1 = dateFormatter.dateFromString(dateAsString)!  dateAsString = "Oct 10, 2015 GMT" var date2 = dateFormatter.dateFromString(dateAsString)!

• 如果 date1 早于 date2，该方法返回date1

• 如过 date2 早于 date1，该方法返回date2

• 如果 date1 和 date2 相同，返回date1

laterDate  方法也可以用于这样的判断。

让我们来看一个用到这两个方法的例子：

// Comparing dates - Method #1 print("Earlier date is: /(date1.earlierDate(date2))") print("Later date is: /(date1.laterDate(date2))")

另外一个日期比较方法是 NSDate   的  compare:  方法，它需要搭配使用  NSComparisonResult  枚举体。通过下面的例子你就能明白我说的意思。先让我们来看一下它的使用场景：同样，我们有两个日期对象需要比对，然后判断两个日期是否相同，如果不同，哪个更早一些。代码如下：

结果为：

代码：

// Comparing dates - Method #2 if date1.compare(date2) == NSComparisonResult.OrderedDescending {  print("Date1 is Later than Date2") } else if date1.compare(date2) == NSComparisonResult.OrderedAscending {  print("Date1 is Earlier than Date2") } else if date1.compare(date2) == NSComparisonResult.OrderedSame {  print("Same dates") } 

第三个比对方法有点不同，因为它用到了时间间隔（time interval)的概念。这个方法也很简单，它可以查找到每个日期（到现在）的时间间隔，接下来就可以进行比对。

// Comparing dates - Method #3 if date1.timeIntervalSinceReferenceDate > date2.timeIntervalSinceReferenceDate {  print("Date1 is Later than Date2") } else if date1.timeIntervalSinceReferenceDate <  date2.timeIntervalSinceReferenceDate {  print("Date1 is Earlier than Date2") } else {  print("Same dates") } 

上面的这些方法也可以用到时间的比对上。现在我给大家最后一个例子，这个例子和前面的不同之处在于 date1  和  date2   对象包含了时间的表示。例子中又用到了 earlierDate  方法，另外，还用到了isEqualToDate:的方法，它的用法也很明显：

// Comparing time. dateFormatter.dateFormat = "HH:mm:ss zzz" dateAsString = "14:28:16 GMT" date1 = dateFormatter.dateFromString(dateAsString)! dateAsString = "19:53:12 GMT" date2 = dateFormatter.dateFromString(dateAsString)! if date1.earlierDate(date2) == date1 {  if date1.isEqualToDate(date2) {   print("Same time")  }  else {   print("/(date1) is earlier than /(date2)")  } } else {  print("/(date2) is earlier than /(date1)") } 

在其中你会看到“2000-01-01”的日期，你一定很好奇，因为我们从来没设置过这样的日期。这是因为若 NSDate   对象没有指定日期，只指定时间的话，会自动添加默认的日期属性。这不会影响到我们需要的时间值。

好了，现在你应该知道了如何比较日期对象了。

计算未来和过去的日期

计算过去和未来的日期比较有意思。这里你会用到 NSCalendarUnit ， NSDateComponents   等之前了解过的工具。在下面的例子中，我会展示两种不同的方法：第一种使用  NSCalendar   类和  NSCalendarUnit   结构体；第二种使用  NSDateComponents   类。最后，我们会用到第三种替代方案，但是通常情况下，不推荐使用。

首先，记住我们的当前日期（当然了，是在写这个教程是的日期、时间）。这个日期会作为我们的参照值。

现在，假定我们需要为这个日期往后推两个月又5天。最好用代码来描述：

let monthsToAdd = 2 let daysToAdd = 5

我们先用第一种方法来获取期望的日期，先看看代码，稍后我会解释：

var calculatedDate = NSCalendar.currentCalendar().dateByAddingUnit(NSCalendarUnit.Month, value: monthsToAdd, toDate: currentDate, options: NSCalendarOptions.init(rawValue: 0)) calculatedDate = NSCalendar.currentCalendar().dateByAddingUnit(NSCalendarUnit.Day, value: daysToAdd, toDate: calculatedDate!, options: NSCalendarOptions.init(rawValue: 0))

如你所见，这里用到的方法是 NSCAlendar  类的  dateByAddingUnit:value:toDate:options:  方法。它的作用是添加某个日历单元值（如年月日时分秒等）到现有的日期对象上，然后返回新的日期对象。我们需要添加两个日历单元到当前日期，直接用这个方法是不可能的（它每次只能设置一个calendar unit）。关键是调用两次这个方法，设置不同的日历单元，就能得到最终结果。

以下是在playground中调用效果，你可以看到两次添加的结果：

这个方法在你需要设置1~2个日历单元时，还是不错的。当日历单元多的时候，你就需要多次调用这个方法。

在日历单元比较多的时候，更好的方法是使用  NSDateComponents  类。方便起见，这个例子中我们还是设置月份和天。具体做法是：初始化一个  NSDateComponents   对象，并设置月份和天的信息。然后我们调用  NSCalendar   的另一个方法  dateByAddingComponents:toDate:options: ，并最终获得我们需要的日期对象。

let newDateComponents = NSDateComponents() newDateComponents.month = monthsToAdd newDateComponents.day = daysToAdd  calculatedDate = NSCalendar.currentCalendar().dateByAddingComponents(newDateComponents, toDate: currentDate, options: NSCalendarOptions.init(rawValue: 0))

let hoursToAddInSeconds: NSTimeInterval = 90 * 60 calculatedDate = currentDate.dateByAddingTimeInterval(hoursToAddInSeconds)

再次说明一下，上述的前两种方法更安全和通用。你可以按照需求选择使用。

上面的三个例子都是为当前日期对象添加某些日历单元的值。那么如何通过减去一些天数来获取之前的日期？

接下来的例子可以完成这个任务。首先，我们可以为当前日期添加一个负值，这样就可以得到之前的日期。然后通过格式化的方式获取字符串结果。这个结果比较有意思。

let numberOfDays = -5684718 calculatedDate = NSCalendar.currentCalendar().dateByAddingUnit(NSCalendarUnit.Day, value: numberOfDays, toDate: currentDate, options: NSCalendarOptions.init(rawValue: 0))  dateFormatter.dateFormat = "EEEE, MMM dd, yyyy GGG" dateAsString = dateFormatter.stringFromDate(calculatedDate!)

上面的这些代码片段可以帮助你理解计算过去和之前日期的方法。你可以自己试试改变这些代码，看看有什么不一样的结果。这样就可以更深入的理解这些功能。

计算日期间隔

dateFormatter.dateFormat = "yyyy-MM-dd HH:mm:ss" dateAsString = "2015-10-08 14:25:37" date1 = dateFormatter.dateFromString(dateAsString)!  dateAsString = "2018-03-05 08:14:19" date2 = dateFormatter.dateFromString(dateAsString)!

我们先来看看如何通过date components来计算日期对象间隔。我们又会用到 NSCalendar   类的一个方法。然后打印出各个日期部分的结果。显然，只要有可用的date components，通过这种方法获取需要的结果是很简单的：

var diffDateComponents = NSCalendar.currentCalendar().components([NSCalendarUnit.Year, NSCalendarUnit.Month, NSCalendarUnit.Day, NSCalendarUnit.Hour, NSCalendarUnit.Minute, NSCalendarUnit.Second], fromDate: date1, toDate: date2, options: NSCalendarOptions.init(rawValue: 0))  print("The difference between dates is: /(diffDateComponents.year) years, /(diffDateComponents.month) months, /(diffDateComponents.day) days, /(diffDateComponents.hour) hours, /(diffDateComponents.minute) minutes, /(diffDateComponents.second) seconds")

let dateComponentsFormatter = NSDateComponentsFormatter() dateComponentsFormatter.unitsStyle = NSDateComponentsFormatterUnitsStyle.Full

unitsStyle  属性指定我们使用的  dateComponentsFormatter   以何种格式打印日期的间隔。例如，这里我们使用  完整  样式，这样天数、月数等名字（如days，months）都会被显示出来。如果我们设置  缩写  样式，就会显示缩写名字（天数显示为d等）。你可以在 这个链接 中查找到所有的样式：

让我们继续会到日期间隔计算的话题上。我们先计算日期的间隔，再把该值传递给 *stringFromTimeInterval:* 方法，这样，就能获得日期间隔的字符串表示：

let interval = date2.timeIntervalSinceDate(date1) dateComponentsFormatter.stringFromTimeInterval(interval)

最后，第三种计算的方法中，我们将两个日期传递给 NSDateComponentsFormatter   对象的一个叫  stringFromDate:toDate:   的方法。但是这个方法需要有个前置的条件 ： NSDateComponentsFormatter   的  allowedUnits   属性必须被提前设置，这个属性接受数组类型的值，这里至少要设置一个日历单元的值。否则这个方法会返回nil值。所以，在这个方法的使用中，我们“告诉”它需要获取哪些日历单元，它会按照对应的日历单元返回结果：

dateComponentsFormatter.allowedUnits = [NSCalendarUnit.Year, NSCalendarUnit.Month, NSCalendarUnit.Day, NSCalendarUnit.Hour, NSCalendarUnit.Minute, NSCalendarUnit.Second] let autoFormattedDifference = dateComponentsFormatter.stringFromDate(date1, toDate: date2)

总结

正如我之前提到的，*NSDate*对象在工程中很常用，无可避免。不可否认，它在程序员的讨论话题中并不怎么出名，因此，我尝试通过一些小的例子来说明日期编程并没有什么复杂之处。教程中提到的*NSDate*和其他相关类都说明了，通过两三行代码就可以完成你的工作。希望这个教程可以帮助到你，尤其是当你刚接触到这方面的编程。