自定义格式

上一节 Using Predefined Formats 描述了 DateFormat 类提供的格式样式。在大多数情况下，这些预定义格式就足够。但是，如果要创建自己的自定义格式，可以使用 SimpleDateFormat 类。

下面的代码示例演示了 SimpleDateFormat 类的方法。你可以在名为 SimpleDateFormatDemo 的文件中找到示例的完整源代码。

关于模式

创建 SimpleDateFormat 对象时，指定模式 String。模式 String 的内容决定了日期和时间的格式。有关模式语法的完整说明，请参阅 Date Format Pattern Syntax 中的表。

以下代码根据传递给 SimpleDateFormat 构造函数的模式 String 格式化日期和时间。format 方法返回的 String 包含要显示的格式化日期和时间。

Date today;
String output;
SimpleDateFormat formatter;

formatter = new SimpleDateFormat(pattern, currentLocale);
today = new Date();
output = formatter.format(today);
System.out.println(pattern + " " + output);

下表显示了指定 U.S. Locale 时上一代码示例生成的输出：

模式和语言环境

SimpleDateFormat 类是语言环境敏感的。如果在没有 Locale 参数的情况下实例化 SimpleDateFormat，它将根据默认的 Locale 格式化日期和时间。模式和 Locale 都决定了格式。对于相同的模式，如果 Locale 不同，SimpleDateFormat 可能会以不同方式格式化日期和时间。

在下面的示例代码中，模式在创建 SimpleDateFormat 对象的语句中进行了硬编码：

Date today;
String result;
SimpleDateFormat formatter;

formatter = new SimpleDateFormat("EEE d MMM yy", currentLocale);
today = new Date();
result = formatter.format(today);
System.out.println("Locale: " + currentLocale.toString());
System.out.println("Result: " + result);

当 currentLocale 设置为不同的值时，前面的代码示例生成此输出：

Locale: fr_FR
Result: mar. 30 juin 09
Locale: de_DE
Result: Di 30 Jun 09
Locale: en_US
Result: Tue 30 Jun 09

日期格式模式语法

你可以从下表中的符号列表中为日期和时间设计自己的格式模式：

不是字母的字符被视为带引号的文本。也就是说，即使它们没有包含在单引号内，它们也会出现在格式化文本中。

你指定的符号字母数也决定了格式。例如，如果“zz”模式导致“PDT”，然后“zzzz”模式生成“Pacific Daylight Time”。下表总结了这些规则：