iOS DateFormatter dateFormat fromTemplate 中允许的格式说明符是什么？

Question

我找不到DateFormatter.dateFormat(fromTemplate:options:locale:) 的模板参数中允许的格式说明符列表。

1. dateFormat 引导我去...
2. Date and Time Programming Guide。这些页面都没有列出格式说明符。所以我检查了建议的相关文档...
3. Date and Time Programming Guide for Core Foundation 没有列表。
4. Data Formatting Guide 有一个小节标题“使用格式字符串指定自定义格式”，但它只是让我回到上面的（1）。数据格式指南中的其他页面都没有格式说明符。

有谁知道 Apple 在哪里记录这些说明符？

Answer 1

我将通过一些示例扩展评论中的答案。对于 iOS 7 及更高版本，格式代码在这里：http://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns。表格太大，无法在这里全部复制，但这里有一些帮助我入门。有关所有格式和说明，请参见该链接。

• 时代：G (AD), GGGG (Anno Domini)
• 年份：y (1984), yy (84), yyyy (1984)
• 月：M、MM、MMM、MMMM、MMMMM。还有：L
• 一个月中的某天：d, dd
• 星期几名称：E, EEEE, EEEEE, EEEEEE

这是我发现有助于探索这些的游乐场片段。

import Foundation

let components = DateComponents(
    calendar: Calendar(identifier: .gregorian), 
    timeZone: nil, 
    era: 1, 
    year: 1984, 
    month: 1, 
    day: 2, 
    hour: nil, minute: nil, second: nil, 
    nanosecond: nil, weekday: nil, 
    weekdayOrdinal: nil, quarter: nil, 
    weekOfMonth: nil, weekOfYear: nil, 
    yearForWeekOfYear: nil)
let aDate = Calendar(identifier: .gregorian).date(from: components)!
let en_US = Locale(identifier: "en_US")
var df = DateFormatter()
func formatdate(_ template: String) -> String {
    let custom = DateFormatter.dateFormat(fromTemplate: template, options: 0, locale: en_US)
    df.dateFormat = custom
    return df.string(from: aDate)
}

formatdate("Mdyyyy") // "1/2/1984"
formatdate("yyyyMMdd") // "01/02/1984"
formatdate("yyyyMMMdd") // "Jan 02, 1984"
formatdate("yyyyMMMMdd") // "January 02, 1984"
formatdate("yyyyMMMMMdd") // "J 02, 1984"
formatdate("yyyyG") // "1984 AD"
formatdate("yyyyGGGG") // "1984 Anno Domini"
formatdate("yyyyMMMddE") // "Mon, Jan 02, 1984"
formatdate("yyyyMMMddEEEE") // "Monday, Jan 02, 1984"
formatdate("yyyyMMMddEEEEE") // "M, Jan 02, 1984"

formatdate("MdYYYY") // "1/2/1984"
formatdate("YYYYMMdd") // "01/02/1984"
formatdate("YYYYMMMdd") // "Jan 02, 1984"
formatdate("YYYYMMMMdd") // "January 02, 1984"
formatdate("YYYYMMMMMdd") // "J 02, 1984"
formatdate("YYYYG") // "1984 AD"
formatdate("YYYYGGGG") // "1984 Anno Domini"
formatdate("YYYYMMMddE") // "Mon, Jan 02, 1984"
formatdate("YYYYMMMddEEEE") // "Monday, Jan 02, 1984"
formatdate("YYYYMMMddEEEEE") // "M, Jan 02, 1984"