首先我要说我完全同意 Marvins answer 但我希望有人会对更多技术细节感兴趣。
在java doc 之后,SimpleDateFormat 你找不到YYYY 的例子。但它有效并且通过了验证。深入检查:
public class SimpleDateFormat extends DateFormat {
//....
/**
* Returns the compiled form of the given pattern. The syntax of
* the compiled pattern is:
* <blockquote>
* CompiledPattern:
* EntryList
* EntryList:
* Entry
* EntryList Entry
* Entry:
* TagField
* TagField data
* TagField:
* Tag Length
* TaggedData
* Tag:
* pattern_char_index
* TAG_QUOTE_CHARS
* Length:
* short_length
* long_length
* TaggedData:
* TAG_QUOTE_ASCII_CHAR ascii_char
*
* </blockquote>
* ....
*
* @exception NullPointerException if the given pattern is null
* @exception IllegalArgumentException if the given pattern is invalid
*/
private char[] compile(String pattern) {
...
if ((tag = DateFormatSymbols.patternChars.indexOf(c)) == -1) {
throw new IllegalArgumentException("Illegal pattern character " +
"'" + c + "'");
}
...
}
...
}
检查允许的模式符号(用于验证条件)DateFormatSymbols.patternChars:
public class DateFormatSymbols implements Serializable, Cloneable {
...
static final String patternChars = "GyMdkHmsSEDFwWahKzZYuXL";
...
}
Y 是有效的模式元素,它是什么意思(让我们检查同一 DateFormatSymbols 类中的常量)?
static final int PATTERN_ERA = 0; // G
static final int PATTERN_YEAR = 1; // y
static final int PATTERN_MONTH = 2; // M
static final int PATTERN_DAY_OF_MONTH = 3; // d
static final int PATTERN_HOUR_OF_DAY1 = 4; // k
static final int PATTERN_HOUR_OF_DAY0 = 5; // H
static final int PATTERN_MINUTE = 6; // m
static final int PATTERN_SECOND = 7; // s
static final int PATTERN_MILLISECOND = 8; // S
static final int PATTERN_DAY_OF_WEEK = 9; // E
static final int PATTERN_DAY_OF_YEAR = 10; // D
static final int PATTERN_DAY_OF_WEEK_IN_MONTH = 11; // F
static final int PATTERN_WEEK_OF_YEAR = 12; // w
static final int PATTERN_WEEK_OF_MONTH = 13; // W
static final int PATTERN_AM_PM = 14; // a
static final int PATTERN_HOUR1 = 15; // h
static final int PATTERN_HOUR0 = 16; // K
static final int PATTERN_ZONE_NAME = 17; // z
static final int PATTERN_ZONE_VALUE = 18; // Z
static final int PATTERN_WEEK_YEAR = 19; // Y
static final int PATTERN_ISO_DAY_OF_WEEK = 20; // u
static final int PATTERN_ISO_ZONE = 21; // X
static final int PATTERN_MONTH_STANDALONE = 22; // L
在这里您可以找到Y 模式元素(名称清晰易读):
static final int PATTERN_WEEK_YEAR = 19; // Y
*_WEEK_YEAR 如果我们期望单个 YEAR(遵循命名约定 PATTERN_YEAR)会产生一些混淆。我们也可以找到
static final int PATTERN_YEAR = 1; // y
我们可以在互联网上搜索的含义差异(例如在 wiki 中)。但是在代码中使用它有什么区别呢?继续检查在SimpleDateFormat 中使用常量,我们可以发现PATTERN_WEEK_YEAR 和PATTERN_YEAR 在几乎所有情况下都以类似的方式使用。但逻辑上的差异很小(只需使用DateFormatSymbols.java 查找元素)...因此我们将确保代码提供与 wiki 术语含义相同的含义。
...按照这种 java 调查方式(使用 java doc 和源代码),我们可以澄清几乎所有问题,而无需额外帮助来深入了解 JDK 知识。