自定义格式

原文： https://docs.oracle.com/javase/tutorial/i18n/format/simpleDateFormat.html

Version note: This Date and Time section uses the date and time APIs in the java.util package. The java.time APIs, available in the JDK 8 release, provides a comprehensive date and time model that offers significant improvements over the java.util classes. The java.time APIs are described in the Date Time trail. The Legacy Date-Time Code page might be of particular interest.

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

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

关于模式

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

以下代码根据传递给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时上一代码示例生成的输出：

Customized Date and Time Formats | 图案 | 产量 | | —- | —- | | DD.MM.YY | 30.06.09 | | yyyy.MM.dd G’at’hh：mm：ss z | 公元 2009.06.30 PDT 08:29:36 | | EEE，MMM d，’’yy | 09 年 6 月 30 日星期二 | | h：mm a | 晚上 8:29 | | H：毫米 | 8:29 | | H：MM：SS：SSS | 8：28：36：249 | | K：mm a，z | 上午 8:29，PDT | | yyyy.MMMMM.dd GGG hh：mm aaa | 2009.June.30 AD 08:29 AM |

模式和区域设置

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

在下面的示例代码中，模式在创建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”模式生成“太平洋夏令时”。下表总结了这些规则：