使用 Swift 3.0 *** 控日期_app

概述作者：Joe，原文链接，原文日期：2016-09-20 译者：Cwift；校对：walkingway；定稿：CMB 当你在想要大规模重命名时，一个附带的挑战就是要确保所有相关的文档都必须同步更新。比如，截至到 2016 年 9 月 20 日，DateFormatter 的文档依旧没有与版本统一，引用的是 Swift 2.3 风格的 API（译者注：现在是 2017年，文档依旧没有更新...）。

作者：Joe，原文链接，原文日期：2016-09-20
译者：Cwift；校对：walkingway；定稿：CMB

当你在想要大规模重命名时，一个附带的挑战就是要确保所有相关的文档都必须同步更新。比如，截至到 2016 年 9 月 20 日，DateFormatter 的文档依旧没有与版本统一，引用的是 Swift 2.3 风格的 API（译者注：现在是 2017年，文档依旧没有更新...）。随着时间的推移，这些疏漏毫无疑问都会被纠正，这里是一些使用 Date 以及 DateFormatter 实现的日期格式化的示例。

官方文档中当前的示例如下：

let dateFormatter = DateFormatter()dateFormatter.dateStyle = .mediumStyledateFormatter.timeStyle = .noStyle let date = Date(timeIntervalSinceReferenceDate: 118800) // US English Locale (en_US)dateFormatter.locale = Locale(localeIDentifIEr: "en_US")NSLog("%@",dateFormatter.stringFromDate(date)) // Jan 2,2001 // french Locale (fr_FR)dateFormatter.locale = Locale(localeIDentifIEr: "fr_FR")NSLog("%@",dateFormatter.stringFromDate(date)) // 2 janv. 2001 // Japanese Locale (ja_JP)dateFormatter.locale = Locale(localeIDentifIEr: "ja_JP")NSLog("%@",dateFormatter.stringFromDate(date)) // 2001/01/02

在 Swift 3.0 中变为：

let dateFormatter = DateFormatter()dateFormatter.dateStyle = .mediumdateFormatter.timeStyle = .none

注意 .mediumStyle 被简化为 .medium。这种简化符合规则，我们知道类型是 DateFormatter.Style 所以没有理由重复 Style 一词。使用 .none 替换 .noStyle 也是同理。

现在看看设置格式化器的环境时发生的改动：

// US English Locale (en_US)dateFormatter.locale = Locale(IDentifIEr: "en_US")print(dateFormatter.string(from:date)) // Jan 2,2001 // french Locale (fr_FR)dateFormatter.locale = Locale(IDentifIEr: "fr_FR")print(dateFormatter.string(from:date)) // 2 janv. 2001 // Japanese Locale (ja_JP)dateFormatter.locale = Locale(IDentifIEr: "ja_JP")print(dateFormatter.string(from:date)) // 2001/01/02

再一次，我们看到了从 Locale(localeIDentifIEr:) 到 Locale(IDentifIEr:) 的简化。减少了类型名及其引用。类似地，DateFormatter 的 stringFromDate 方法已经被简化为 string(from:)，完整的方法签名是 string(from:Date)。理解这种模式了吗？

继续用一个 String 描述的信息生成一个 Date 对象，苹果的文档展示了这样的示例：

let RFC3339DateFormatter = DateFormatter()RFC3339DateFormatter.locale = Locale(localeIDentifIEr: "en_US_POSIX")RFC3339DateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZZZZZ"RFC3339DateFormatter.timeZone = TimeZone(forSecondsFromGMT: 0) let string = "1996-12-19T16:39:57-08:00"let date = RFC3339DateFormatter.dateFromString(string)

为了减少啰嗦和不必要的词汇，得到了下面的写法：

let RFC3339DateFormatter = DateFormatter()RFC3339DateFormatter.locale = Locale(IDentifIEr: "en_US_POSIX")RFC3339DateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZZZZZ"RFC3339DateFormatter.timeZone = TimeZone(secondsFromGMT: 0) let string = "1996-12-19T16:39:57-08:00"let date = RFC3339DateFormatter.date(from:string)

TimeZone 构造器中删除了无关的三个字符（for），而且正如期望， dateFromString 方法变成了 date(from:)。

经验法则

从 Swift 2 转换到 Swift 3 时，一个通用法则是：去除多余的单词。如果你之前习惯了写 formatter.timeStyle = .fullStyle，现在你要习惯 formatter.timeStyle = .full 的写法。如果你看到了 someTypeFromAnotherType() 这样的写法，它可能已经被替换为 someType(from:AnotherType)。说一下我的体验，在使用 Swift 3 几个月时间后，再回到 Swift 2 会感觉命名过于冗长，这还是在我喜欢这种详细自说明语言风格的前提下。不过一旦你学会了 Swift，你会拥抱海明威而避开托尔斯泰。

愉快地 Swift 吧！