日期和时间格式

公共抽象类
的DateFormat
扩展格式
java.lang.Object的
↳ java.text.Format子
↳ java.text.DateFormat
已知的直接子类
SimpleDateFormat的
类概述

一个抽象类，日期/时间格式化子类的格式和解析日期或时间在一个语言无关的方式。日期/时间格式化子类，如SimpleDateFormat的，允许进行格式化（即日期- >文本），分析（文本- >日期）和标准化。作为一个日期对象或1970年1月1日起，日00:00:00 GMT以来的毫秒表示的日期。

DateFormat中提供了许多类的方法获取默认的日期/时间格式化基于默认或给定的语言环境和格式样式。包括完整的，长，中，短期和格式样式。方法描述中提供更多的细节和使用这些样式的例子。

的DateFormat帮助你格式化和分析任何语言环境的日期。个月，一周天，甚至日历格式：月球与太阳，你的代码可以是完全独立的区域公约。

要格式化当前Locale的日期，使用静态工厂方法之一：

myString的= 的DateFormat 。getDateInstance 。（）格式（myDate ）;

如果格式化多个日期，它是更有效地获得该格式并多次使用，使系统不具备获取信息，了解当地的语言和国家公约多次。



“ ）;
}

要格式化不同语言环境的一个数字，指定调用它 getDateInstance的：

DateFormat中DF = 的DateFormat （日期格式。长， 场所，法国）;

DateFormat中也可以用来解析字符串：

myDate = DF 。解析（myString的）;

使用getDateInstance获得一个国家正常的日期格式。其他静态工厂方法是：使用getTimeInstance得到一个国家的时间格式。使用getDateTimeInstance获得日期和时间格式。在不同的选项，你可以通过这些工厂方法来控制结果的长度;从短期至中期长全。确切的结果取决于语言环境，但一般：

总之是完全的数字，如52年12月13日下午3:30
媒介是更长的时间，如1952年1月12日，
龙是时间，如1952年1月12日，或三时三十〇分32秒时，
全是几乎完全指定，如周二，1952年4月12日，AD或下午3点30分42秒PST。
如果需要，可以设置时区上的格式。对于更大控制在格式化或解析，尝试从工厂方法得到一个SimpleDateFormat的铸造的DateFormat。这将工作的大多数国家，只记得它放在一个try块的情况下，你遇到一个不寻常的。

有版本的解析和格式的方法使用 ，让您 的ParsePosition和FieldPosition

逐步解析一个字符串件;
将任何特定的领域。
同步

日期格式不同步。建议为每个线程创建独立的格式实例。如果多个线程同时访问一个格式，它必须保持外部同步。

参见

NumberFormat的
SimpleDateFormat的
日历
时区
总结

嵌套类
类 DateFormat.Field 被用作属性键和值的AttributedCharacterIterator的 formatToCharacterIterator（对象）的方法返回这个内部类的实例。
常量
INT AM_PM_FIELD FieldPosition选择为'一'字段对齐，对应的 AM_PM领域。
INT DATE_FIELD FieldPosition为'D'字段对齐的选择，“ 日期 “ 字段对应。
INT DAY_OF_WEEK_FIELD 的FieldPosition为“E”字段对齐选择，对应 DAY_OF_WEEK领域。
INT DAY_OF_WEEK_IN_MONTH_FIELD 的FieldPosition为“F”字段对齐选择，对应的 DAY_OF_WEEK_IN_MONTH领域。
INT DAY_OF_YEAR_FIELD 的FieldPosition为“D”字段对齐选择，对应的 DAY_OF_YEAR领域。
INT 默认 定义的默认格式样式的格式风格不变。
INT ERA_FIELD FieldPosition为“G”字段对齐选择，对应的自责领域。
INT 全 格式定义完整的风格的风格不变。
INT HOUR0_FIELD FieldPosition为“K”字段对齐选择，对应的 小时字段。
INT HOUR1_FIELD FieldPosition选择“H”字段对齐，对应的 小时字段。
INT HOUR_OF_DAY0_FIELD FieldPosition '轰'的字段对齐选择，对应的HOUR_OF_DAY领域。
INT HOUR_OF_DAY1_FIELD FieldPosition为'K'字段对齐选择，对应的HOUR_OF_DAY领域。
INT 龙 确定长期的风格格式风格不变。
INT 介质 格式风格不变定义介质风格。
INT MILLISECOND_FIELD FieldPosition选择“S”字段对齐，对应的 微差领域。
INT MINUTE_FIELD FieldPosition选择为“M”字段对齐，相当于每 分钟领域。
INT MONTH_FIELD FieldPosition为“M”字段对齐选择，对应到一个月领域。
INT “SECOND_FIELD FieldPosition的'字段的对齐选择，对应的 第二场。
INT 淡 格式定义短的风格的风格不变。
INT TIMEZONE_FIELD FieldPosition为“Z”字段对齐选择，对应的ZONE_OFFSET和DST_OFFSET 领域。
INT WEEK_OF_MONTH_FIELD 的FieldPosition为“W”字段对齐选择，对应的 WEEK_OF_MONTH领域。
INT WEEK_OF_YEAR_FIELD FieldPosition'W'字段对齐的选择，对应的 WEEK_OF_YEAR领域。
INT YEAR_FIELD FieldPosition为'Y'字段对齐选择，对应的2003 年 7月至2004年6 。
领域
保护 日历 日历 日历本的DateFormat用来格式化一个数字代表日期。
保护 的NumberFormat NumberFormat的 使用数字格式来格式化一个数字。
受保护的构造
的DateFormat（）
构造一个新的实例的DateFormat。
公共方法
物件 克隆（）
返回一个新的DateFormat实例具有相同的属性。
布尔 等于（对象对象）
比较指定对象与此日期格式，并表示如果他们是平等的。
抽象 的StringBuffer 格式（日期日期，StringBuffer的缓冲区，FieldPosition场）
作为一个使用此日期格式的字符串追加到指定的字符串缓冲区的模式的字符串格式指定的日期。
最后 的StringBuffer 格式（对象对象，StringBuffer的缓冲区，FieldPosition场）
格式指定的对象作为字符串使用此日期格式的字符串追加到指定的字符串缓冲区的格局。
最后的 字符串 格式（日期日期）
格式化指定的日期，此日期格式的规则。
静态 场所[] getAvailableLocales（）
返回的DateFormat实例是可用的语言环境而定制的数组。
日历 getCalendar（）
返回本所使用的日历的DateFormat。
最后静态 的DateFormat getDateInstance（INT风格）
返回一个用于格式化和解析用户的默认语言环境的日期指定样式的DateFormat实例。
最后静态 的DateFormat getDateInstance（INT风格，语言环境的语言环境）
返回一个DateFormat中的格式化和解析日期，在指定的样式指定的语言环境的实例。
最后静态 的DateFormat getDateInstance（）
返回一个用于格式化和解析日期默认语言环境的默认样式的DateFormat实例。
最后静态 的DateFormat getDateTimeInstance（INT，INT timeStyle DATESTYLE 区域设置区域设置）
返回一个用于格式化和解析日期和时间值在指定的区域设置指定的样式的DateFormat实例。
最后静态 的DateFormat getDateTimeInstance（INT DATESTYLE，诠释timeStyle）
返回一个用于格式化和解析日期和时间值的方式为用户的默认语言环境的适当的DateFormat实例。
最后静态 的DateFormat getDateTimeInstance（）
返回一个用于格式化和解析日期和时间值中的默认样式为默认语言环境的DateFormat实例。
最后静态 的DateFormat 的getInstance（）
返回一个用于格式化和解析日期和时间在短期风格默认语言环境的DateFormat实例。
NumberFormat的 getNumberFormat（）
返回的NumberFormat使用的DateFormat。
最后静态 的DateFormat getTimeInstance（INT风格）
返回一个用于格式化和解析用户的默认语言环境的时间在指定的样式值的DateFormat实例。
最后静态 的DateFormat getTimeInstance（）
返回一个DateFormat中的默认样式为默认的语言环境中的时间值的格式化和解析实例。
最后静态 的DateFormat getTimeInstance（INT风格，语言环境的语言环境）
返回一个用于格式化和解析指定的区域设置中指定的样式的时间值的DateFormat实例。
时区 getTimeZone（）
返回此日期格式的日历的时区。
INT 的hashCode（）
返回此对象的整数哈希代码。
布尔 isLenient（）
表示此日期格式所使用的日历是否是宽松的。
日期 字符串字符串（解析）
解析一个使用此日期格式的规则，从指定的字符串的日期。
抽象的 日期 解析（字符串字符串的ParsePosition位置）
解析一个从指定的字符串所指定的索引开始日期的位置。
物件 的parseObject（字符串字符串的ParsePosition位置）
解析一个从指定的字符串所指定的索引开始日期的位置。
无效 setCalendar（日历 CAL）
设置此日期格式所使用的日历。
无效 setLenient（布尔值）
指定解析日期/时间是否应宽松。
无效 setNumberFormat（NumberFormat的格式）
设置此日期格式所使用的NumberFormat。
无效 setTimeZone（TimeZone的时区）
此日期格式所使用的日历设置时区。
[展开]
继承的方法
从类 java.text.Format子
从类 java.lang.Object继承
常量

公共静态最终诠释 AM_PM_FIELD

日期：API等级1
FieldPosition选择为'一'字段对齐，对应的 AM_PM领域。
恒值： 14（0x0000000e）
公共静态最终诠释 DATE_FIELD

日期：API等级1
FieldPosition为'D'字段对齐的选择，“ 日期 “ 字段对应。
常量的值： 3（0x00000003）
公共静态最终诠释 DAY_OF_WEEK_FIELD

日期：API等级1
的FieldPosition为“E”字段对齐选择，对应 DAY_OF_WEEK领域。
恒值： 9（0x00000009）
公共静态最终诠释 DAY_OF_WEEK_IN_MONTH_FIELD

日期：API等级1
的FieldPosition为“F”字段对齐选择，对应的 DAY_OF_WEEK_IN_MONTH领域。
恒值： 11（0x0000000b）
公共静态最终诠释 DAY_OF_YEAR_FIELD

日期：API等级1
的FieldPosition为“D”字段对齐选择，对应的 DAY_OF_YEAR领域。
恒值： 10（0X0000000A）
公共静态最终诠释 DEFAULT

日期：API等级1
定义的默认格式样式的格式风格不变。默认是中等。
恒值： 2（0X00000002）
公共静态最终诠释 ERA_FIELD

日期：API等级1
FieldPosition为“G”字段对齐选择，对应的自责领域。
恒值： 0（0X00000000）
公共静态最终诠释 全

日期：API等级1
格式定义完整的风格的风格不变。
恒值： 0（0X00000000）
公共静态最终诠释 HOUR0_FIELD

日期：API等级1
FieldPosition为“K”字段对齐选择，对应的 小时字段。
恒值： 16（0x00000010）
公共静态最终诠释 HOUR1_FIELD

日期：API等级1
FieldPosition选择“H”字段对齐，对应的 小时字段。
恒值： 15（0x0000000f）
公共静态最终诠释 HOUR_OF_DAY0_FIELD

日期：API等级1
FieldPosition '轰'的字段对齐选择，对应的HOUR_OF_DAY领域。HOUR_OF_DAY0_FIELD从零开始的24小时时钟。例如，23:59 + 00:59 01:00结果。
常量的值： 5（0x00000005）
公共静态最终诠释 HOUR_OF_DAY1_FIELD

日期：API等级1
FieldPosition为'K'字段对齐选择，对应的HOUR_OF_DAY领域。HOUR_OF_DAY1_FIELD是一个基于24小时时钟。例如，23:59 + 24:59 01:00结果。
恒值： 4（0x00000004）
公共静态最终诠释 龙

日期：API等级1
确定长期的风格格式风格不变。
恒值： 1（0x00000001）
公共静态最终诠释 介质

日期：API等级1
格式风格不变定义介质风格。
恒值： 2（0X00000002）
公共静态最终诠释 MILLISECOND_FIELD

日期：API等级1
FieldPosition选择“S”字段对齐，对应的 微差领域。
恒值： 8（0x00000008）
公共静态最终诠释 MINUTE_FIELD

日期：API等级1
FieldPosition选择为“M”字段对齐，相当于每 分钟领域。
恒值： 6（0x00000006）
公共静态最终诠释 MONTH_FIELD

日期：API等级1
FieldPosition为“M”字段对齐选择，对应到一个月领域。
恒值： 2（0X00000002）
公共静态最终诠释 “SECOND_FIELD

日期：API等级1
FieldPosition的'字段的对齐选择，对应的 第二场。
恒值： 7（0x00000007）
公共静态最终诠释 淡

日期：API等级1
格式定义短的风格的风格不变。
常量的值： 3（0x00000003）
公共静态最终诠释 TIMEZONE_FIELD

日期：API等级1
FieldPosition为“Z”字段对齐选择，对应的ZONE_OFFSET和DST_OFFSET 领域。
恒值： 17（0x00000011）
公共静态最终诠释 WEEK_OF_MONTH_FIELD

日期：API等级1
的FieldPosition为“W”字段对齐选择，对应的 WEEK_OF_MONTH领域。
恒值： 13（0x0000000d）
公共静态最终诠释 WEEK_OF_YEAR_FIELD

日期：API等级1
FieldPosition'W'字段对齐的选择，对应的 WEEK_OF_YEAR领域。
恒值： 12（0x0000000c）
公共静态最终诠释 YEAR_FIELD

日期：API等级1
FieldPosition为'Y'字段对齐选择，对应的2003 年 7月至2004年6 。
恒值： 1（0x00000001）
领域

保护 日历 日历

日期：API等级1
日历本的DateFormat用来格式化一个数字代表日期。
受保护的 NumberFormat的 NumberFormat的

日期：API等级1
使用数字格式来格式化一个数字。
受保护的构造

受保护 的DateFormat （）

日期：API等级1
构造一个新的实例的DateFormat。
公共方法

公共 对象 的clone （）

日期：API等级1
返回一个新的DateFormat实例具有相同的属性。
返回

一个浅拷贝的DateFormat。
参见

Cloneable接口
公共布尔 等于 （对象对象）

日期：API等级1
比较指定对象与此日期格式，并表示如果他们是平等的。
参数

物件 此日期格式比较的对象。
返回

真实的，如果对象是的DateFormat对象，它具有相同的属性，此日期格式; ， 否则返回false。
参见

hashCode（）方法
公共抽象 StringBuffer的 格式 （日期日期，StringBuffer的缓冲区，FieldPosition场）

日期：API等级1
作为一个使用此日期格式的字符串追加到指定的字符串缓冲区的模式的字符串格式指定的日期。
如果该领域的成员字段指定格式字段包含一个值，然后将其beginIndex和endIndex的成员首次出现在这一领域的格式化文本的位置更新。
参数

日期 格式化的日期。
缓冲 目标字符串缓冲区，追加格式化的日期/时间。
场 ：一个可选的对齐字段输入输出：在格式化文本的对齐字段的偏移量。
返回

字符串缓冲区。
公众最终 StringBuffer的 格式 （Object 对象，StringBuffer的缓冲区，FieldPosition场）

日期：API等级1
格式指定的对象作为字符串使用此日期格式的字符串追加到指定的字符串缓冲区的格局。
如果该领域的成员字段指定格式字段包含一个值，然后将其beginIndex和endIndex的成员首次出现在这一领域的格式化文本的位置更新。
参数

物件 源对象的格式，必须是一个日期或一个 数字。如果对象是一个数字，然后构造一个日期使用的longValue（）的数量。
缓冲 目标字符串缓冲区，追加格式化的日期/时间。
场 ：一个可选的对齐字段输入输出：在格式化文本的对齐字段的偏移量。
返回

字符串缓冲区。
抛出

IllegalArgumentException 如果对象既不是一个日期，也不是一个 数量的实例。
公众最终的 字符串 格式 （日期日期）

日期：API等级1
格式化指定的日期，此日期格式的规则。
参数

日期 格式化的日期。
返回

格式化字符串。
公共静态 语言环境[] getAvailableLocales的 （）

日期：API等级1
返回的DateFormat实例是可用的语言环境而定制的数组。
请注意，Android不支持用户提供本地化服务提供商。
公共的 日历 getCalendar （）

日期：API等级1
返回本所使用的日历的DateFormat。
返回

使用此日期格式的日历。
公共静态最后 的DateFormat getDateInstance （INT风格）

日期：API等级1
返回一个用于格式化和解析用户的默认语言环境的日期指定样式的DateFormat实例。参见“ 警惕的默认语言环境 “。
参数

风格 一个短期，中期，长期，全面，或DEFAULT。
返回

DateFormat中的实例样式和默认语言环境。
抛出

IllegalArgumentException 如果风格是不是一个短期，中期，长期，全面，或DEFAULT。
公共静态最后 的DateFormat getDateInstance （INT风格，语言环境的语言环境）

日期：API等级1
返回一个DateFormat中的格式化和解析日期，在指定的样式指定的语言环境的实例。
参数

风格 一个短期，中期，长期，全面，或DEFAULT。
语言环境 语言环境。
返回

DateFormat中的实例的风格和 语言环境。
抛出

IllegalArgumentException 如果风格是不是一个短期，中期，长期，全面，或DEFAULT。
公共静态最后 的DateFormat getDateInstance （）

日期：API等级1
返回一个用于格式化和解析日期默认语言环境的默认样式的DateFormat实例。
返回

DateFormat中的默认样式和区域的实例。
公共静态最后 的DateFormat getDateTimeInstance （INT DATESTYLE，本地化的语言环境，诠释timeStyle ）

日期：API等级1
返回一个用于格式化和解析日期和时间值在指定的区域设置指定的样式的DateFormat实例。
参数

DATESTYLE 一个短期，中期，长期，全面，或DEFAULT。
timeStyle 一个短期，中期，长期，全面，或DEFAULT。
语言环境 语言环境。
返回

DateFormat中的的实例DATESTYLE， timeStyle和语言环境。
抛出

IllegalArgumentException 如果DATESTYLE，或timeStyle是不是一个短期，中期，长期，全面，或DEFAULT。
公共静态最后 的DateFormat getDateTimeInstance （INT DATESTYLE，诠释timeStyle）

日期：API等级1
返回一个用于格式化和解析日期和时间值的方式为用户的默认语言环境的适当的DateFormat实例。参见“ 警惕的默认语言环境 “。
参数

DATESTYLE 一个短期，中期，长期，全面，或DEFAULT。
timeStyle 一个短期，中期，长期，全面，或DEFAULT。
返回

DateFormat中的的实例DATESTYLE， timeStyle和默认语言环境。
抛出

IllegalArgumentException 如果DATESTYLE，或timeStyle是不是一个短期，中期，长期，全面，或DEFAULT。
公共静态最后 的DateFormat getDateTimeInstance （）

日期：API等级1
返回一个用于格式化和解析日期和时间值中的默认样式为默认语言环境的DateFormat实例。
返回

DateFormat中的默认样式和区域的实例。
公共静态最后 的DateFormat 的getInstance （）

日期：API等级1
返回一个用于格式化和解析日期和时间在短期风格默认语言环境的DateFormat实例。
返回

DateFormat中的短的风格和默认语言环境的实例。
公众 的NumberFormat getNumberFormat （）

日期：API等级1
返回的NumberFormat使用的DateFormat。
返回

此日期格式NumberFormat的使用。
公共静态最后 的DateFormat getTimeInstance （INT风格）

日期：API等级1
返回一个用于格式化和解析用户的默认语言环境的时间在指定的样式值的DateFormat实例。参见“ 警惕的默认语言环境 “。
参数

风格 一个短期，中期，长期，全面，或DEFAULT。
返回

DateFormat中的实例样式和默认语言环境。
抛出

IllegalArgumentException 如果风格是不是一个短期，中期，长期，全面，或DEFAULT。
公共静态最后 的DateFormat getTimeInstance （）

日期：API等级1
返回一个DateFormat中的默认样式为默认的语言环境中的时间值的格式化和解析实例。
返回

DateFormat中的默认样式和区域的实例。
公共静态最后 的DateFormat getTimeInstance （INT风格，语言环境的语言环境）

日期：API等级1
返回一个用于格式化和解析指定的区域设置中指定的样式的时间值的DateFormat实例。
参数

风格 一个短期，中期，长期，全面，或DEFAULT。
语言环境 语言环境。
返回

DateFormat中的实例的风格和 语言环境。
抛出

IllegalArgumentException 如果风格是不是一个短期，中期，长期，全面，或DEFAULT。
公众 的TimeZone getTimeZone （）

日期：API等级1
返回此日期格式的日历的时区。
返回

此日期格式所使用的日历的时区。
公众诠释 的hashCode （）

日期：API等级1
返回此对象的整数哈希代码。合同，任何两个物体为等于（对象）返回真，必须返回相同的哈希码值。这意味着子类的对象， 通常覆盖两种方法既不方法。
请注意，哈希值必须不随时间而改变，除非所用的信息equals比较中也发生了变化。
看到写一个正确的 hashCode方法， 如果你打算实现自己的hashCode方法。
返回

此对象的哈希代码。
公共布尔 isLenient （）

日期：API等级1
表示此日期格式所使用的日历是否是宽松的。
返回

如果日历是真正的宽松; ，否则返回false。
公开 日期 解析 （字符串字符串）

日期：API等级1
解析一个使用此日期格式的规则，从指定的字符串的日期。
参数

串 字符串解析。
返回

解析日期。
抛出

ParseException 如果出现错误，在解析过程中。
公共抽象的 日期 解析 （字符串字符串的ParsePosition位置）

日期：API等级1
解析一个从指定的字符串所指定的索引开始日期的位置。如果该字符串成功解析，那么该指数的ParsePosition更新的指数解析文本。出现错误时，该指数保持不变，指数的ParsePosition的错误设置发生错误的位置的索引。
默认情况下，解析是宽松：如果输入的是不是在此对象的格式化方法使用的形式，但仍然可以解析为一个日期，然后解析成功。客户可能坚持严格遵守格式致电setLenient（假）。
参数

串 字符串解析。
位置 输入/输出参数，指定的起始索引字符串从哪里开始解析。如果解析成功，解析文本的索引更新错误，该指数是不变的错误索引设置为发生错误的位置的索引。
返回

日期从解析，或空，如果有一个错误。
公共 对象 的parseObject （字符串字符串的ParsePosition位置）

日期：API等级1
解析一个从指定的字符串所指定的索引开始日期的位置。如果该字符串成功解析，那么该指数的ParsePosition更新的指数解析文本。出现错误时，该指数保持不变，指数的ParsePosition的错误 设置发生错误的位置的索引。
默认情况下，解析是宽松：如果输入的是不是在此对象的格式化方法使用的形式，但仍然可以解析为一个日期，然后解析成功。客户可能坚持严格遵守格式致电setLenient（假）。
参数

串 字符串解析。
位置 输入/输出参数，指定的起始索引 字符串从哪里开始解析。如果解析成功，解析文本的索引更新错误，该指数是不变的错误索引设置为发生错误的位置的索引。
返回

日期从解析，或空，如果有一个错误。
公共的无效 setCalendar （日历 CAL）

日期：API等级1
设置此日期格式所使用的日历。
参数

CAL 新的日历。
公共无效 setLenient （布尔值）

日期：API等级1
指定解析日期/时间是否应宽松。与宽松的解析，解析器可能会使用启发式解释，不正是此对象的格式相匹配的输入。输入必须符合严格的解析，这个对象的格式。
参数

值 真正设置日历是宽松的，虚假的 ，否则。
公共的无效 setNumberFormat （NumberFormat的格式）

日期：API等级1
设置此日期格式所使用的NumberFormat。
参数

格式 新的数字格式。
公共的无效 setTimeZone （TimeZone的时区）

日期：API等级1
此日期格式所使用的日历设置时区。
参数

时区 新的时区。
日期和时间格式