public abstract class DateFormat
extends UFormat
java.lang.Object | |||
↳ | java.text.Format | ||
↳ | android.icu.text.UFormat | ||
↳ | android.icu.text.DateFormat |
Known Direct Subclasses |
[icu增强] ICU的替代DateFormat
。 ICU特有的方法,字段和其他功能标记为“ [icu] ”。
DateFormat是日期/时间格式化子类的抽象类,它以独立于语言的方式格式化和解析日期或时间。 日期/时间格式化子类,如SimpleDateFormat允许格式化(即日期 - >文本),解析(文本 - >日期)和规范化。 日期表示为Date
对象或自1970年1月1日00:00:00 GMT以来的毫秒。
DateFormat可帮助您为任何区域设置格式化和解析日期。 您的代码可以完全独立于语言环境约定数月,一周中的几天甚至日历格式:月球与太阳能。 它提供了许多用于获取默认日期/时间格式化器的类方法,这些方法基于给定语言环境和一些格式化样式或任意“骨架”的默认值。
MINUTE_SECOND
for something like "13:45" or YEAR_ABBR_MONTH
for something like "Sept 2012". 要格式化当前语言环境的日期,请使用以下静态工厂方法之一:
myString = DateFormat.getDateInstance().format(myDate); myString = DateFormat.getPatternInstance(DateFormat.YEAR_ABBR_MONTH).format(myDate);
如果您要格式化多个数字,则获取格式并多次使用格式会更有效,以便系统不必多次获取有关本地语言和国家/地区惯例的信息。
DateFormat df = DateFormat.getDateInstance(); for (int i = 0; i < a.length; ++i) { output.println(df.format(myDate[i]) + "; "); }
要格式化不同语言环境的日期,请在对getDateInstance()的调用中指定它。
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
你也可以使用DateFormat解析。
myDate = df.parse(myString);
有许多静态工厂方法可用。 使用getDateInstance获取该国家的正常日期格式。 使用getTimeInstance获取该国家的时间格式。 使用getDateTimeInstance获取日期和时间格式。 您可以将不同选项传递给这些工厂方法以控制结果的长度; 从短到中,从长到满。 确切的结果取决于语言环境,但通常:
使用getPatternInstance以骨架进行格式化。 通常情况下,这是与预定义的框架,如“2012年9月” YEAR_ABBR_MONTH
。 如果你不想使用预定义的骨架之一,你可以提供自己的骨架。 骨架就像SimpleDateFormat中的模式,除了它们:
如果您愿意,您还可以根据格式设置时区。 如果你想更多地控制格式或解析(或者想让用户更好控制),你可以尝试将你从工厂方法获得的DateFormat转换为SimpleDateFormat。 这对大多数国家都有效; 只要记得把它放在试块中,以防遇到不寻常的问题。
你也可以使用ParsePosition和FieldPosition的解析和格式化方法来让你
Nested classes |
|
---|---|
枚举 |
DateFormat.BooleanAttribute 布尔属性 |
class |
DateFormat.Field 此内部类的实例用作DateFormat.formatToCharacterIterator()方法返回的AttributedCharacterIterator中的属性键和值。 |
Constants |
|
---|---|
String |
ABBR_GENERIC_TZ [icu] 通用非地址格式的常量,如果可能的话缩写,例如PT; 用于组合日期+时间+区域或时间+区域。 |
String |
ABBR_MONTH [icu]带缩写月份的日期骨架的常量。 |
String |
ABBR_MONTH_DAY [icu]日期骨架的缩写月份和日期的常量。 |
String |
ABBR_MONTH_WEEKDAY_DAY [icu]具有缩写月份,工作日和日期的日期骨架的常量。 |
String |
ABBR_QUARTER [icu]日期缩写为quarter的常量。 |
String |
ABBR_SPECIFIC_TZ [icu]用于特定非位置格式的常量,如果可能的话缩写,例如PDT; 用于组合日期+时间+区域或时间+区域。 |
String |
ABBR_UTC_TZ [icu] 本地GMT / UTC格式的常量,例如GMT + 8:00或HPG-8:00; 用于组合日期+时间+区域或时间+区域。 |
String |
ABBR_WEEKDAY [icu]日期缩写为星期 几的骨架常量。 |
int |
AM_PM_FIELD 用于'a'字段对齐的FieldPosition选择器,对应于 |
int |
DATE_FIELD 用于'd'字段对齐的FieldPosition选择器,对应于 |
String |
DAY [icu]日期骨架的常量。 |
int |
DAY_OF_WEEK_FIELD 用于'E'字段对齐的FieldPosition选择器,对应于 |
int |
DAY_OF_WEEK_IN_MONTH_FIELD 用于'F'字段对齐的FieldPosition选择器,对应于 |
int |
DAY_OF_YEAR_FIELD 用于'D'字段对齐的FieldPosition选择器,对应于 |
int |
DEFAULT 常量默认样式模式。 |
int |
DOW_LOCAL_FIELD [icu] FieldPosition用于'e'字段对齐的选择器,对应于 |
int |
ERA_FIELD 用于'G'字段对齐的FieldPosition选择器,对应于 |
int |
EXTENDED_YEAR_FIELD [icu] FieldPosition选择器用于'u'字段对齐,对应于 |
int |
FRACTIONAL_SECOND_FIELD [icu]用于'S'字段对齐的FieldPosition选择器,对应于 |
int |
FULL 不变的全样式模式。 |
String |
GENERIC_TZ [icu]用于通用非地址格式的常量,例如太平洋时间; 用于组合日期+时间+区域或时间+区域。 |
String |
HOUR [icu]具有小时的日期骨架常数,区域设置的首选小时格式(12或24)。 |
int |
HOUR0_FIELD 用于'K'字段对齐的FieldPosition选择器,对应于 |
int |
HOUR1_FIELD 用于'h'字段对齐的FieldPosition选择器,对应于 |
String |
HOUR24 [icu] 24小时演示中带有小时的日期骨架的常量。 |
String |
HOUR24_MINUTE [icu] 24小时演示文稿中带小时和分钟的日期骨架的常量。 |
String |
HOUR24_MINUTE_SECOND [icu] 24小时演示文稿中带有小时,分钟和秒的日期骨架的常量。 |
String |
HOUR_MINUTE [icu]具有小时和分钟的日期骨架的常量,以及语言环境的首选小时格式(12或24)。 |
String |
HOUR_MINUTE_SECOND [icu]具有小时,分钟和秒的日期骨架的常量,以及区域设置的首选小时格式(12或24)。 |
int |
HOUR_OF_DAY0_FIELD 用于'H'字段对齐的FieldPosition选择器,对应于 |
int |
HOUR_OF_DAY1_FIELD 用于'k'字段对齐的FieldPosition选择器,对应于 |
int |
JULIAN_DAY_FIELD [icu]用于'g'字段对齐的FieldPosition选择器,对应于 |
String |
LOCATION_TZ [icu]用于通用位置格式的常量,例如洛杉矶时间; 用于组合日期+时间+区域或时间+区域。 |
int |
LONG 用于长型图案的常量。 |
int |
MEDIUM 中等风格模式的常量。 |
int |
MILLISECONDS_IN_DAY_FIELD [icu]用于'A'字段对齐的FieldPosition选择器,对应于 |
int |
MILLISECOND_FIELD FRACTIONAL_SECOND_FIELD的别名。 |
String |
MINUTE [icu]带分钟的日期骨架的常量。 |
int |
MINUTE_FIELD 用于'm'字段对齐的FieldPosition选择器,对应于 |
String |
MINUTE_SECOND [icu]带分秒的日期骨架的常量。 |
String |
MONTH [icu]带月份的日期骨架的常量。 |
String |
MONTH_DAY [icu]日月长日期骨架的常量。 |
int |
MONTH_FIELD 用于'M'字段对齐的FieldPosition选择器,对应于 |
String |
MONTH_WEEKDAY_DAY [icu]月份,周日和日期的日期骨架的常量。 |
int |
NONE [icu]空样式的常量。 |
String |
NUM_MONTH [icu]具有数字月份的日期骨架的常量。 |
String |
NUM_MONTH_DAY [icu]具有数字月和日的日期骨架的常量。 |
String |
NUM_MONTH_WEEKDAY_DAY [icu]具有数字月份,星期 几和日期的日期骨架的常量。 |
String |
QUARTER [icu]带有季度的日期骨架的常量。 |
int |
QUARTER_FIELD [icu]用于'Q'字段对齐的FieldPosition选择器,对应于 |
int |
RELATIVE [icu]相对风格掩码的常量。 |
int |
RELATIVE_DEFAULT [icu]相对默认样式模式的常量。 |
int |
RELATIVE_FULL [icu]相对全格式模式的常量。 |
int |
RELATIVE_LONG [icu]相对风格样式的常量。 |
int |
RELATIVE_MEDIUM [icu]相对风格样式的常量。 |
int |
RELATIVE_SHORT [icu]相对风格样式的常量。 |
String |
SECOND [icu]第二个日期骨架的常量。 |
int |
SECOND_FIELD FieldPosition选择器的's'字段对齐,对应于 |
int |
SHORT 用于短样式的常量。 |
String |
SPECIFIC_TZ [icu]用于特定非位置格式的常量,例如太平洋夏令时; 用于组合日期+时间+区域或时间+区域。 |
int |
STANDALONE_DAY_FIELD [icu]用于'c'字段对齐的FieldPosition选择器,对应于 |
int |
STANDALONE_MONTH_FIELD [icu]用于'L'字段对齐的FieldPosition选择器,对应于 |
int |
STANDALONE_QUARTER_FIELD [icu]用于'q'字段对齐的FieldPosition选择器,对应于 |
int |
TIMEZONE_FIELD FieldPosition选择器用于'z'字段对齐,对应于 |
int |
TIMEZONE_GENERIC_FIELD [icu]用于'v'字段对齐的FieldPosition选择器,对应于 |
int |
TIMEZONE_ISO_FIELD [icu]用于'X'字段对齐的FieldPosition选择器,对应于 |
int |
TIMEZONE_ISO_LOCAL_FIELD [icu]用于'x'字段对齐的FieldPosition选择器,对应于 |
int |
TIMEZONE_LOCALIZED_GMT_OFFSET_FIELD [icu]用于'O'字段对齐的FieldPosition选择器,对应于 |
int |
TIMEZONE_RFC_FIELD [icu]用于'Z'字段对齐的FieldPosition选择器,对应于 |
int |
TIMEZONE_SPECIAL_FIELD [icu]用于'V'字段对齐的FieldPosition选择器,对应于 |
String |
WEEKDAY [icu]星期 几的日期骨架的常量。 |
int |
WEEK_OF_MONTH_FIELD 用于'W'字段对齐的FieldPosition选择器,对应于 |
int |
WEEK_OF_YEAR_FIELD 用于'w'字段对齐的FieldPosition选择器,对应于 |
String |
YEAR [icu]与年份的日期骨架不变。 |
String |
YEAR_ABBR_MONTH [icu]具有年份和缩写月份的日期骨架的常量。 |
String |
YEAR_ABBR_MONTH_DAY [icu]日期骨架与年份,缩写月份和日期的常量。 |
String |
YEAR_ABBR_MONTH_WEEKDAY_DAY [icu]日期骨架与年份,缩写月份,工作日和日期的常量。 |
String |
YEAR_ABBR_QUARTER [icu]与年份和缩写季度的日期骨架不变。 |
int |
YEAR_FIELD FieldPosition选择'y'字段对齐,对应于 |
String |
YEAR_MONTH [icu]日期骨架与年份和月份不变。 |
String |
YEAR_MONTH_DAY [icu]日期骨架与年,月和日的常量。 |
String |
YEAR_MONTH_WEEKDAY_DAY [icu]日期骨架与年,月,周,日不变的常量。 |
int |
YEAR_NAME_FIELD [icu]用于'U'字段对齐的FieldPosition选择器,对应于 |
String |
YEAR_NUM_MONTH [icu]具有年份和数字月份的日期骨架的常量。 |
String |
YEAR_NUM_MONTH_DAY [icu]包含年份,数字月份和日期的日期骨架的常量。 |
String |
YEAR_NUM_MONTH_WEEKDAY_DAY [icu]包含年份,数字月份,周日和日期的日期骨架的常量。 |
String |
YEAR_QUARTER [icu]与年和季度的日期骨架不变。 |
int |
YEAR_WOY_FIELD [icu] FieldPosition选择'Y'字段对齐,对应于 |
Fields |
|
---|---|
protected Calendar |
calendar
|
protected NumberFormat |
numberFormat 数字格式化程序 |
Protected constructors |
|
---|---|
DateFormat() 创建一个新的日期格式。 |
Public methods |
|
---|---|
Object |
clone() 覆盖克隆。 |
boolean |
equals(Object obj) 覆盖等于。 |
final StringBuffer |
format(Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition) 将时间对象格式化为时间字符串。 |
StringBuffer |
format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition) 将日期格式化为日期/时间字符串。 |
final String |
format(Date date) 将日期格式化为日期/时间字符串。 |
abstract StringBuffer |
format(Calendar cal, StringBuffer toAppendTo, FieldPosition fieldPosition) 将日期格式化为日期/时间字符串。 |
static Locale[] |
getAvailableLocales() 返回安装了DateFormats的语言环境的集合。 |
boolean |
getBooleanAttribute(DateFormat.BooleanAttribute key) 如果返回false,则返回此实例的指定BooleanAttribute的当前值。 |
Calendar |
getCalendar() 返回与此日期/时间格式化程序关联的日历。 |
DisplayContext |
getContext(DisplayContext.Type type) [icu]获取指定DisplayContext.Type的格式化程序的DisplayContext值,例如CAPITALIZATION。 |
static final DateFormat |
getDateInstance(int style, Locale aLocale) 使用给定语言环境的给定格式样式返回日期格式程序。 |
static final DateFormat |
getDateInstance(Calendar cal, int dateStyle) 为默认语言环境创建一个 |
static final DateFormat |
getDateInstance(Calendar cal, int dateStyle, ULocale locale) 创建一个 |
static final DateFormat |
getDateInstance() 使用默认的 |
static final DateFormat |
getDateInstance(int style, ULocale locale) 使用给定语言环境的给定格式样式返回日期格式程序。 |
static final DateFormat |
getDateInstance(Calendar cal, int dateStyle, Locale locale) 创建一个 |
static final DateFormat |
getDateInstance(int style) 以默认的 |
static final DateFormat |
getDateTimeInstance(int dateStyle, int timeStyle) 使用默认的 |
static final DateFormat |
getDateTimeInstance() 使用默认的 |
static final DateFormat |
getDateTimeInstance(Calendar cal, int dateStyle, int timeStyle, ULocale locale) 创建一个 |
static final DateFormat |
getDateTimeInstance(Calendar cal, int dateStyle, int timeStyle, Locale locale) 创建一个 |
static final DateFormat |
getDateTimeInstance(int dateStyle, int timeStyle, ULocale locale) 使用给定语言环境的给定格式样式返回日期/时间格式程序。 |
static final DateFormat |
getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale) 使用给定语言环境的给定格式样式返回日期/时间格式程序。 |
static final DateFormat |
getDateTimeInstance(Calendar cal, int dateStyle, int timeStyle) 为默认语言环境创建一个 |
static final DateFormat |
getInstance(Calendar cal) 返回使用日期和时间的SHORT样式的默认日期/时间格式器。 |
static final DateFormat |
getInstance(Calendar cal, Locale locale) 返回日期/时间格式化程序,该日期/时间格式程序在日期和时间中都使用SHORT样式。 |
static final DateFormat |
getInstance() 返回使用日期和时间的SHORT样式的默认日期/时间格式器。 |
static final DateFormat |
getInstanceForSkeleton(Calendar cal, String skeleton, Locale locale) [icu]创建一个 |
static final DateFormat |
getInstanceForSkeleton(Calendar cal, String skeleton, ULocale locale) [icu]创建一个 |
static final DateFormat |
getInstanceForSkeleton(String skeleton, ULocale locale) [icu]返回一个 |
static final DateFormat |
getInstanceForSkeleton(String skeleton, Locale locale) [icu]返回一个 |
static final DateFormat |
getInstanceForSkeleton(String skeleton) [icu]返回可用于在默认语言环境中格式化日期和时间的 |
NumberFormat |
getNumberFormat() 返回此日期/时间格式化程序用于格式化和解析时间的数字格式器。 |
static final DateFormat |
getPatternInstance(String skeleton, Locale locale) [icu]返回一个 |
static final DateFormat |
getPatternInstance(String skeleton, ULocale locale) [icu]返回可用于在给定语言环境中格式化日期和时间的 |
static final DateFormat |
getPatternInstance(String skeleton) [icu]返回可用于在默认语言环境中格式化日期和时间的 |
static final DateFormat |
getPatternInstance(Calendar cal, String skeleton, Locale locale) [icu]创建一个 |
static final DateFormat |
getPatternInstance(Calendar cal, String skeleton, ULocale locale) [icu]创建一个 |
static final DateFormat |
getTimeInstance(Calendar cal, int timeStyle) 创建一个 |
static final DateFormat |
getTimeInstance() 使用默认的 |
static final DateFormat |
getTimeInstance(int style, ULocale locale) 使用给定语言环境的给定格式样式返回时间格式化程序。 |
static final DateFormat |
getTimeInstance(Calendar cal, int timeStyle, ULocale locale) 创建一个 |
static final DateFormat |
getTimeInstance(Calendar cal, int timeStyle, Locale locale) 创建一个 |
static final DateFormat |
getTimeInstance(int style) 以默认的 |
static final DateFormat |
getTimeInstance(int style, Locale aLocale) 使用给定语言环境的给定格式样式返回时间格式化程序。 |
TimeZone |
getTimeZone() 返回时区。 |
int |
hashCode() 重写hashCode。 |
boolean |
isCalendarLenient() 返回封装的Calendar对象中的日期/时间解析是否宽松。 |
boolean |
isLenient() 返回封装的Calendar对象和DateFormat空格和数值处理中的日期/时间解析是否宽松。 |
Date |
parse(String text) 分析日期/时间字符串。 |
Date |
parse(String text, ParsePosition pos) 根据给定的解析位置解析日期/时间字符串。 |
abstract void |
parse(String text, Calendar cal, ParsePosition pos) 根据给定的解析位置解析日期/时间字符串。 |
Object |
parseObject(String source, ParsePosition pos) 将日期/时间字符串分析到对象中。 |
DateFormat |
setBooleanAttribute(DateFormat.BooleanAttribute key, boolean value) 为此实例设置布尔属性。 |
void |
setCalendar(Calendar newCalendar) 设置此日期格式使用的日历。 |
void |
setCalendarLenient(boolean lenient) 指定封装的Calendar对象中的日期/时间解析是否应该是宽松的。 |
void |
setContext(DisplayContext context) [icu]在格式化程序中设置特定的DisplayContext值,例如CAPITALIZATION_FOR_STANDALONE。 |
void |
setLenient(boolean lenient) 指定日期/时间解析是否是宽松的。 |
void |
setNumberFormat(NumberFormat newNumberFormat) 设置数字格式器。 |
void |
setTimeZone(TimeZone zone) 设置此DateFormat对象日历的时区。 |
Inherited methods |
|
---|---|
From class java.text.Format
|
|
From class java.lang.Object
|
String ABBR_GENERIC_TZ
[icu] 通用非地址格式的常量,如果可能的话缩写,例如PT; 用于组合日期+时间+区域或时间+区域。
常数值:“v”
String ABBR_MONTH_DAY
[icu]日期骨架的缩写月份和日期的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“MMMd”
String ABBR_MONTH_WEEKDAY_DAY
[icu]具有缩写月份,工作日和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“MMMEd”
String ABBR_SPECIFIC_TZ
[icu]用于特定非位置格式的常量,如果可能的话缩写,例如PDT; 用于组合日期+时间+区域或时间+区域。
常量值:“z”
String ABBR_UTC_TZ
[icu] 本地GMT / UTC格式的常量,例如GMT + 8:00或HPG-8:00; 用于组合日期+时间+区域或时间+区域。
常数值:“ZZZZ”
int AM_PM_FIELD
用于'a'字段对齐的FieldPosition选择器,对应于 AM_PM
字段。
常量值:14(0x0000000e)
int DATE_FIELD
用于'd'字段对齐的FieldPosition选择器,对应于 DATE
字段。
常量值:3(0x00000003)
int DAY_OF_WEEK_FIELD
用于'E'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK
字段。
常量值:9(0x00000009)
int DAY_OF_WEEK_IN_MONTH_FIELD
用于'F'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK_IN_MONTH
字段。
常量值:11(0x0000000b)
int DAY_OF_YEAR_FIELD
用于'D'字段对齐的FieldPosition选择器,对应于 DAY_OF_YEAR
字段。
常量值:10(0x0000000a)
int DOW_LOCAL_FIELD
[icu]用于'e'字段对齐的FieldPosition选择器,对应于 DOW_LOCAL
字段。
常量值:19(0x00000013)
int ERA_FIELD
用于'G'字段对齐的FieldPosition选择器,对应于 ERA
字段。
常量值:0(0x00000000)
int EXTENDED_YEAR_FIELD
[icu] FieldPosition用于'u'字段对齐的选择器,对应于 EXTENDED_YEAR
字段。
常量值:20(0x00000014)
int FRACTIONAL_SECOND_FIELD
[icu]用于'S'字段对齐的FieldPosition选择器,对应于MILLISECOND
字段。 注意:使用'S'的时间格式最多可以显示小数秒的三位有效数字,对应于毫秒分辨率和SSS的小数秒子图。 如果子图案是S或SS,则小数秒值将被截断(不是四舍五入)为指定显示位置的数量。 如果小数秒子模式长于SSS,则附加显示位置将填充零。
常量值:8(0x00000008)
String GENERIC_TZ
[icu]用于通用非地址格式的常量,例如太平洋时间; 用于组合日期+时间+区域或时间+区域。
常数值:“vvvv”
int HOUR0_FIELD
用于'K'字段对齐的FieldPosition选择器,对应于HOUR
字段。 HOUR0_FIELD用于基于零的12小时时钟。 例如,下午11:30 + 1小时产生00:30 AM。
常量值:16(0x00000010)
int HOUR1_FIELD
用于'h'字段对齐的FieldPosition选择器,对应于HOUR
字段。 HOUR1_FIELD用于一个基于12小时制的时钟。 例如,上午12:30下午11:30 PM + 1小时。
常量值:15(0x0000000f)
String HOUR24_MINUTE
[icu] 24小时演示文稿中带小时和分钟的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常数值:“Hm”
String HOUR24_MINUTE_SECOND
[icu] 24小时演示文稿中带有小时,分钟和秒的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常数值:“Hms”
String HOUR_MINUTE
[icu]具有小时和分钟的日期骨架的常量,以及语言环境的首选小时格式(12或24)。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“jm”
String HOUR_MINUTE_SECOND
[icu]具有小时,分钟和秒的日期骨架的常量,以及区域设置的首选小时格式(12或24)。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“jms”
int HOUR_OF_DAY0_FIELD
用于'H'字段对齐的FieldPosition选择器,对应于HOUR_OF_DAY
字段。 HOUR_OF_DAY0_FIELD用于基于零的24小时时钟。 例如,23:59 + 01:00的结果是00:59。
常量值:5(0x00000005)
int HOUR_OF_DAY1_FIELD
用于'k'字段对齐的FieldPosition选择器,对应于HOUR_OF_DAY
字段。 HOUR_OF_DAY1_FIELD用于基于一个24小时制的时钟。 例如,23:59 + 01:00在24:59结果。
常量值:4(0x00000004)
int JULIAN_DAY_FIELD
[icu]用于'g'字段对齐的FieldPosition选择器,对应于 JULIAN_DAY
字段。
常量值:21(0x00000015)
String LOCATION_TZ
[icu]用于通用位置格式的常量,例如洛杉矶时间; 用于组合日期+时间+区域或时间+区域。
常数值:“VVVV”
int MILLISECONDS_IN_DAY_FIELD
[icu]用于'A'字段对齐的FieldPosition选择器,对应于 MILLISECONDS_IN_DAY
字段。
常量值:22(0x00000016)
int MILLISECOND_FIELD
FRACTIONAL_SECOND_FIELD的别名。
常量值:8(0x00000008)
int MINUTE_FIELD
FieldPosition选择'm'字段对齐,对应于 MINUTE
字段。
常数值:6(0x00000006)
String MINUTE_SECOND
[icu]带分秒的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“ms”
String MONTH_DAY
[icu]日月长日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“MMMMd”
int MONTH_FIELD
用于'M'字段对齐的FieldPosition选择器,对应于 MONTH
字段。
常量值:2(0x00000002)
String MONTH_WEEKDAY_DAY
[icu]月份,周日和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“MMMMEEEEd”
String NUM_MONTH_DAY
[icu]具有数字月和日的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常数值:“Md”
String NUM_MONTH_WEEKDAY_DAY
[icu]具有数字月份,星期几和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常数值:“MEd”
int QUARTER_FIELD
[icu]用于'Q'字段对齐的FieldPosition选择器,对应于MONTH
字段。 这显示了季度。
常量值:27(0x0000001b)
int SECOND_FIELD
FieldPosition选择器的's'字段对齐,对应于 SECOND
字段。
常量值:7(0x00000007)
String SPECIFIC_TZ
[icu]用于特定非位置格式的常量,例如太平洋夏令时; 用于组合日期+时间+区域或时间+区域。
常量值:“zzzz”
int STANDALONE_DAY_FIELD
[icu]用于'c'字段对齐的FieldPosition选择器,对应于DAY_OF_WEEK
字段。 这将显示独立的日期名称(如果可用)。
常量值:25(0x00000019)
int STANDALONE_MONTH_FIELD
[icu]用于'L'字段对齐的FieldPosition选择器,对应于MONTH
字段。 这将显示独立的月份名称(如果可用)。
常量值:26(0x0000001a)
int STANDALONE_QUARTER_FIELD
[icu]用于'q'字段对齐的FieldPosition选择器,对应于MONTH
字段。 如果可用,这将显示独立季度。
常量值:28(0x0000001c)
int TIMEZONE_FIELD
FieldPosition选择器用于'z'字段对齐,对应于 ZONE_OFFSET
和 DST_OFFSET
字段。
常量值:17(0x00000011)
int TIMEZONE_GENERIC_FIELD
[icu]用于'v'字段对齐的FieldPosition选择器,对应于ZONE_OFFSET
和DST_OFFSET
字段。 这将显示通用区域名称(如果可用)。
常量值:24(0x00000018)
int TIMEZONE_ISO_FIELD
[icu]用于'X'字段对齐的FieldPosition选择器,对应于ZONE_OFFSET
和DST_OFFSET
字段。 这显示ISO 8601本地时间偏移格式或UTC指示符(“Z”)。
常量值:32(0x00000020)
int TIMEZONE_ISO_LOCAL_FIELD
[icu]用于'x'字段对齐的FieldPosition选择器,对应于ZONE_OFFSET
和DST_OFFSET
字段。 这显示ISO 8601本地时间偏移格式。
常量值:33(0x00000021)
int TIMEZONE_LOCALIZED_GMT_OFFSET_FIELD
[icu]用于'O'字段对齐的FieldPosition选择器,对应于ZONE_OFFSET
和DST_OFFSET
字段。 这显示了本地化的GMT格式。
常量值:31(0x0000001f)
int TIMEZONE_RFC_FIELD
[icu]用于'Z'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSET
和 DST_OFFSET
字段。
常量值:23(0x00000017)
int TIMEZONE_SPECIAL_FIELD
[icu] FieldPosition选择器用于'V'字段对齐,对应于ZONE_OFFSET
和DST_OFFSET
字段。 这将显示指定VVVV时的回退时区名称,以及指定单个V时通常忽略的短标准或日光时区名称。
常量值:29(0x0000001d)
int WEEK_OF_MONTH_FIELD
用于'W'字段对齐的FieldPosition选择器,对应于 WEEK_OF_MONTH
字段。
常量值:13(0x0000000d)
int WEEK_OF_YEAR_FIELD
用于'w'字段对齐的FieldPosition选择器,对应于 WEEK_OF_YEAR
字段。
常量值:12(0x0000000c)
String YEAR_ABBR_MONTH_DAY
[icu]日期骨架与年份,缩写月份和日期的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“yMMMd”
String YEAR_ABBR_MONTH_WEEKDAY_DAY
[icu]日期骨架与年份,缩写月份,工作日和日期的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“yMMMEd”
int YEAR_FIELD
FieldPosition选择'y'字段对齐,对应于 YEAR
字段。
常数值:1(0x00000001)
String YEAR_MONTH_DAY
[icu]日期骨架与年,月和日的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“yMMMMd”
String YEAR_MONTH_WEEKDAY_DAY
[icu]日期骨架与年,月,周,日不变的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“yMMMMEEEEd”
int YEAR_NAME_FIELD
[icu]用于'U'字段对齐的FieldPosition选择器,对应于YEAR
字段。 这将显示循环年份名称(如果可用)。
常量值:30(0x0000001e)
String YEAR_NUM_MONTH_DAY
[icu]包含年份,数字月份和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“yMd”
String YEAR_NUM_MONTH_WEEKDAY_DAY
[icu]包含年份,数字月份,周日和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。
常量值:“yMEd”
int YEAR_WOY_FIELD
[icu] FieldPosition选择'Y'字段对齐,对应于 YEAR_WOY
字段。
常量值:18(0x00000012)
Calendar calendar
DateFormat
用于生成实现日期和时间格式所需的时间字段值的日历。 子类应将其初始化为适合与此DateFormat
关联的语言环境的日历。
NumberFormat numberFormat
数字格式程序DateFormat
用于在日期和时间格式化数字。 子类应将其初始化为适合与此DateFormat
相关联的语言环境的数字格式。
boolean equals (Object obj)
覆盖等于。
Parameters | |
---|---|
obj |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj argument; false otherwise. |
StringBuffer format (Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition)
将时间对象格式化为时间字符串。 时间对象的例子是以毫秒表示的时间值和Date对象。
Parameters | |
---|---|
obj |
Object : must be a Number or a Date or a Calendar. |
toAppendTo |
StringBuffer : the string buffer for the returning time string. |
fieldPosition |
FieldPosition : keeps track of the position of the field within the returned string. On input: an alignment field, if desired. On output: the offsets of the alignment field. For example, given a time text "1996.07.10 AD at 15:08:56 PDT", if the given fieldPosition is DateFormat.YEAR_FIELD, the begin index and end index of fieldPosition will be set to 0 and 4, respectively. Notice that if the same time field appears more than once in a pattern, the fieldPosition will be set for the first occurrence of that time field. For instance, formatting a Date to the time string "1 PM PDT (Pacific Daylight Time)" using the pattern "h a z (zzzz)" and the alignment field DateFormat.TIMEZONE_FIELD, the begin index and end index of fieldPosition will be set to 5 and 8, respectively, for the first occurrence of the timezone pattern character 'z'. |
Returns | |
---|---|
StringBuffer |
the formatted time string. |
也可以看看:
StringBuffer format (Date date, StringBuffer toAppendTo, FieldPosition fieldPosition)
将日期格式化为日期/时间字符串。
Parameters | |
---|---|
date |
Date : a Date to be formatted into a date/time string. |
toAppendTo |
StringBuffer : the string buffer for the returning date/time string. |
fieldPosition |
FieldPosition : keeps track of the position of the field within the returned string. On input: an alignment field, if desired. On output: the offsets of the alignment field. For example, given a time text "1996.07.10 AD at 15:08:56 PDT", if the given fieldPosition is DateFormat.YEAR_FIELD, the begin index and end index of fieldPosition will be set to 0 and 4, respectively. Notice that if the same time field appears more than once in a pattern, the fieldPosition will be set for the first occurrence of that time field. For instance, formatting a Date to the time string "1 PM PDT (Pacific Daylight Time)" using the pattern "h a z (zzzz)" and the alignment field DateFormat.TIMEZONE_FIELD, the begin index and end index of fieldPosition will be set to 5 and 8, respectively, for the first occurrence of the timezone pattern character 'z'. |
Returns | |
---|---|
StringBuffer |
the formatted date/time string. |
String format (Date date)
将日期格式化为日期/时间字符串。
Parameters | |
---|---|
date |
Date : the time value to be formatted into a time string. |
Returns | |
---|---|
String |
the formatted time string. |
StringBuffer format (Calendar cal, StringBuffer toAppendTo, FieldPosition fieldPosition)
将日期格式化为日期/时间字符串。
Parameters | |
---|---|
cal |
Calendar : a Calendar set to the date and time to be formatted into a date/time string. When the calendar type is different from the internal calendar held by this DateFormat instance, the date and the time zone will be inherited from the input calendar, but other calendar field values will be calculated by the internal calendar. |
toAppendTo |
StringBuffer : the string buffer for the returning date/time string. |
fieldPosition |
FieldPosition : keeps track of the position of the field within the returned string. On input: an alignment field, if desired. On output: the offsets of the alignment field. For example, given a time text "1996.07.10 AD at 15:08:56 PDT", if the given fieldPosition is DateFormat.YEAR_FIELD, the begin index and end index of fieldPosition will be set to 0 and 4, respectively. Notice that if the same time field appears more than once in a pattern, the fieldPosition will be set for the first occurrence of that time field. For instance, formatting a Date to the time string "1 PM PDT (Pacific Daylight Time)" using the pattern "h a z (zzzz)" and the alignment field DateFormat.TIMEZONE_FIELD, the begin index and end index of fieldPosition will be set to 5 and 8, respectively, for the first occurrence of the timezone pattern character 'z'. |
Returns | |
---|---|
StringBuffer |
the formatted date/time string. |
Locale[] getAvailableLocales ()
返回安装了DateFormats的语言环境的集合。
Returns | |
---|---|
Locale[] |
the set of locales for which DateFormats are installed. |
boolean getBooleanAttribute (DateFormat.BooleanAttribute key)
如果返回false,则返回此实例的指定BooleanAttribute的当前值。
Parameters | |
---|---|
key |
DateFormat.BooleanAttribute
|
Returns | |
---|---|
boolean |
也可以看看:
Calendar getCalendar ()
返回与此日期/时间格式化程序关联的日历。
Returns | |
---|---|
Calendar |
the calendar associated with this date/time formatter. |
DisplayContext getContext (DisplayContext.Type type)
[icu]获取指定DisplayContext.Type的格式化程序的DisplayContext值,例如CAPITALIZATION。
Parameters | |
---|---|
type |
DisplayContext.Type : the DisplayContext.Type whose value to return |
Returns | |
---|---|
DisplayContext |
the current DisplayContext setting for the specified type |
DateFormat getDateInstance (int style, Locale aLocale)
使用给定语言环境的给定格式样式返回日期格式程序。
Parameters | |
---|---|
style |
int : the given formatting style. For example, SHORT for "M/d/yy" in the US locale. As currently implemented, relative date formatting only affects a limited range of calendar days before or after the current date, based on the CLDR <field type="day">/<relative> data: For example, in English, "Yesterday", "Today", and "Tomorrow". Outside of this range, relative dates are formatted using the corresponding non-relative style. |
aLocale |
Locale : the given locale. |
Returns | |
---|---|
DateFormat |
a date formatter. |
DateFormat getDateInstance (Calendar cal, int dateStyle)
为默认语言环境创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的 cal
。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date format is desired. |
dateStyle |
int : The type of date format desired. This can be SHORT , MEDIUM , etc. |
Returns | |
---|---|
DateFormat |
DateFormat getDateInstance (Calendar cal, int dateStyle, ULocale locale)
创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的 cal
。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date format is desired. |
dateStyle |
int : The type of date format desired. This can be SHORT , MEDIUM , etc. |
locale |
ULocale : The locale for which the date format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getDateInstance ()
使用默认的 FORMAT
语言环境的默认格式化样式返回日期格式化程序。
Returns | |
---|---|
DateFormat |
a date formatter. |
也可以看看:
DateFormat getDateInstance (int style, ULocale locale)
使用给定语言环境的给定格式样式返回日期格式程序。
Parameters | |
---|---|
style |
int : the given formatting style. For example, SHORT for "M/d/yy" in the US locale. As currently implemented, relative date formatting only affects a limited range of calendar days before or after the current date, based on the CLDR <field type="day">/<relative> data: For example, in English, "Yesterday", "Today", and "Tomorrow". Outside of this range, relative dates are formatted using the corresponding non-relative style. |
locale |
ULocale : the given ulocale. |
Returns | |
---|---|
DateFormat |
a date formatter. |
DateFormat getDateInstance (Calendar cal, int dateStyle, Locale locale)
创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的 cal
。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date format is desired. |
dateStyle |
int : The type of date format desired. This can be SHORT , MEDIUM , etc. |
locale |
Locale : The locale for which the date format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getDateInstance (int style)
使用默认的 FORMAT
语言环境的给定格式样式返回日期格式程序。
Parameters | |
---|---|
style |
int : the given formatting style. For example, SHORT for "M/d/yy" in the US locale. As currently implemented, relative date formatting only affects a limited range of calendar days before or after the current date, based on the CLDR <field type="day">/<relative> data: For example, in English, "Yesterday", "Today", and "Tomorrow". Outside of this range, relative dates are formatted using the corresponding non-relative style. |
Returns | |
---|---|
DateFormat |
a date formatter. |
也可以看看:
DateFormat getDateTimeInstance (int dateStyle, int timeStyle)
使用默认的 FORMAT
语言环境的给定日期和时间格式化样式返回日期/时间格式化程序。
Parameters | |
---|---|
dateStyle |
int : the given date formatting style. For example, SHORT for "M/d/yy" in the US locale. As currently implemented, relative date formatting only affects a limited range of calendar days before or after the current date, based on the CLDR <field type="day">/<relative> data: For example, in English, "Yesterday", "Today", and "Tomorrow". Outside of this range, relative dates are formatted using the corresponding non-relative style. |
timeStyle |
int : the given time formatting style. For example, SHORT for "h:mm a" in the US locale. Relative time styles are not currently supported, and behave just like the corresponding non-relative style. |
Returns | |
---|---|
DateFormat |
a date/time formatter. |
也可以看看:
DateFormat getDateTimeInstance ()
使用默认的 FORMAT
语言环境的默认格式化样式返回日期/时间格式化程序。
Returns | |
---|---|
DateFormat |
a date/time formatter. |
也可以看看:
DateFormat getDateTimeInstance (Calendar cal, int dateStyle, int timeStyle, ULocale locale)
创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的日期和时间。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
dateStyle |
int : The type of date format desired. This can be SHORT , MEDIUM , etc. |
timeStyle |
int : The type of time format desired. This can be SHORT , MEDIUM , etc. |
locale |
ULocale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
也可以看看:
DateFormat getDateTimeInstance (Calendar cal, int dateStyle, int timeStyle, Locale locale)
创建一个 DateFormat
对象,该对象可用于在由 cal
指定的日历系统中格式化日期和时间。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
dateStyle |
int : The type of date format desired. This can be SHORT , MEDIUM , etc. |
timeStyle |
int : The type of time format desired. This can be SHORT , MEDIUM , etc. |
locale |
Locale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
也可以看看:
DateFormat getDateTimeInstance (int dateStyle, int timeStyle, ULocale locale)
使用给定语言环境的给定格式样式返回日期/时间格式程序。
Parameters | |
---|---|
dateStyle |
int : the given date formatting style. As currently implemented, relative date formatting only affects a limited range of calendar days before or after the current date, based on the CLDR <field type="day">/<relative> data: For example, in English, "Yesterday", "Today", and "Tomorrow". Outside of this range, relative dates are formatted using the corresponding non-relative style. |
timeStyle |
int : the given time formatting style. Relative time styles are not currently supported, and behave just like the corresponding non-relative style. |
locale |
ULocale : the given ulocale. |
Returns | |
---|---|
DateFormat |
a date/time formatter. |
DateFormat getDateTimeInstance (int dateStyle, int timeStyle, Locale aLocale)
使用给定语言环境的给定格式样式返回日期/时间格式程序。
Parameters | |
---|---|
dateStyle |
int : the given date formatting style. As currently implemented, relative date formatting only affects a limited range of calendar days before or after the current date, based on the CLDR <field type="day">/<relative> data: For example, in English, "Yesterday", "Today", and "Tomorrow". Outside of this range, relative dates are formatted using the corresponding non-relative style. |
timeStyle |
int : the given time formatting style. Relative time styles are not currently supported, and behave just like the corresponding non-relative style. |
aLocale |
Locale : the given locale. |
Returns | |
---|---|
DateFormat |
a date/time formatter. |
DateFormat getDateTimeInstance (Calendar cal, int dateStyle, int timeStyle)
为默认语言环境创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的日期和时间。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
dateStyle |
int : The type of date format desired. This can be SHORT , MEDIUM , etc. |
timeStyle |
int : The type of time format desired. This can be SHORT , MEDIUM , etc. |
Returns | |
---|---|
DateFormat |
也可以看看:
DateFormat getInstance (Calendar cal)
返回使用日期和时间的SHORT样式的默认日期/时间格式器。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getInstance (Calendar cal, Locale locale)
返回日期/时间格式化程序,该日期/时间格式程序在日期和时间中都使用SHORT样式。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
locale |
Locale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getInstance ()
返回使用日期和时间的SHORT样式的默认日期/时间格式器。
Returns | |
---|---|
DateFormat |
DateFormat getInstanceForSkeleton (Calendar cal, String skeleton, Locale locale)
[icu]创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的日期和时间。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
Locale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getInstanceForSkeleton (Calendar cal, String skeleton, ULocale locale)
[icu]创建一个 DateFormat
对象,该对象可用于在由 cal
指定的日历系统中格式化日期和时间。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
ULocale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getInstanceForSkeleton (String skeleton, ULocale locale)
[icu]返回可用于在给定语言环境中格式化日期和时间的 DateFormat
对象。
Parameters | |
---|---|
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
ULocale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getInstanceForSkeleton (String skeleton, Locale locale)
[icu]返回一个 DateFormat
对象,该对象可用于格式化给定语言环境中的日期和时间。
Parameters | |
---|---|
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
Locale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getInstanceForSkeleton (String skeleton)
[icu]返回一个可用于在默认语言环境中设置日期和时间格式的 DateFormat
对象。
Parameters | |
---|---|
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
Returns | |
---|---|
DateFormat |
NumberFormat getNumberFormat ()
返回此日期/时间格式化程序用于格式化和解析时间的数字格式器。
Returns | |
---|---|
NumberFormat |
the number formatter which this date/time formatter uses. |
DateFormat getPatternInstance (String skeleton, Locale locale)
[icu]返回可用于在给定语言环境中格式化日期和时间的DateFormat
对象。 getInstanceForSkeleton方法优于getPatternInstance方法。
Parameters | |
---|---|
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
Locale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getPatternInstance (String skeleton, ULocale locale)
[ICU]返回DateFormat
可以用于格式日期和时间在给定语言环境的对象。 getInstanceForSkeleton方法优于getPatternInstance方法。
Parameters | |
---|---|
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
ULocale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getPatternInstance (String skeleton)
[icu]返回可用于在默认语言环境中格式化日期和时间的DateFormat
对象。 getInstanceForSkeleton方法优于getPatternInstance方法。
Parameters | |
---|---|
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
Returns | |
---|---|
DateFormat |
DateFormat getPatternInstance (Calendar cal, String skeleton, Locale locale)
[icu]创建一个DateFormat
对象,该对象可用于格式化由cal
指定的日历系统中的日期和时间。 getInstanceForSkeleton方法优于getPatternInstance方法。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
Locale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getPatternInstance (Calendar cal, String skeleton, ULocale locale)
[icu]创建一个DateFormat
对象,该对象可用于格式化由cal
指定的日历系统中的日期和时间。 getInstanceForSkeleton方法优于getPatternInstance方法。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a date/time format is desired. |
skeleton |
String : The skeleton that selects the fields to be formatted. (Uses the DateTimePatternGenerator .) This can be ABBR_MONTH , MONTH_WEEKDAY_DAY , etc. |
locale |
ULocale : The locale for which the date/time format is desired. |
Returns | |
---|---|
DateFormat |
DateFormat getTimeInstance (Calendar cal, int timeStyle)
创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的 cal
。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a time format is desired. |
timeStyle |
int : The type of time format desired. This can be SHORT , MEDIUM , etc. |
Returns | |
---|---|
DateFormat |
也可以看看:
DateFormat getTimeInstance ()
使用默认的 FORMAT
语言环境的默认格式样式获取时间格式器。
Returns | |
---|---|
DateFormat |
a time formatter. |
也可以看看:
DateFormat getTimeInstance (int style, ULocale locale)
使用给定语言环境的给定格式样式返回时间格式化程序。
Parameters | |
---|---|
style |
int : the given formatting style. For example, SHORT for "h:mm a" in the US locale. Relative time styles are not currently supported, and behave just like the corresponding non-relative style. |
locale |
ULocale : the given ulocale. |
Returns | |
---|---|
DateFormat |
a time formatter. |
DateFormat getTimeInstance (Calendar cal, int timeStyle, ULocale locale)
创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的 cal
。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a time format is desired. |
timeStyle |
int : The type of time format desired. This can be SHORT , MEDIUM , etc. |
locale |
ULocale : The locale for which the time format is desired. |
Returns | |
---|---|
DateFormat |
也可以看看:
DateFormat getTimeInstance (Calendar cal, int timeStyle, Locale locale)
创建一个 DateFormat
对象,该对象可用于格式化由 cal
指定的日历系统中的 cal
。
Parameters | |
---|---|
cal |
Calendar : The calendar system for which a time format is desired. |
timeStyle |
int : The type of time format desired. This can be SHORT , MEDIUM , etc. |
locale |
Locale : The locale for which the time format is desired. |
Returns | |
---|---|
DateFormat |
也可以看看:
DateFormat getTimeInstance (int style)
使用默认的 FORMAT
语言环境的给定格式样式返回时间格式化程序。
Parameters | |
---|---|
style |
int : the given formatting style. For example, SHORT for "h:mm a" in the US locale. Relative time styles are not currently supported, and behave just like the corresponding non-relative style. |
Returns | |
---|---|
DateFormat |
a time formatter. |
也可以看看:
DateFormat getTimeInstance (int style, Locale aLocale)
使用给定语言环境的给定格式样式返回时间格式化程序。
Parameters | |
---|---|
style |
int : the given formatting style. For example, SHORT for "h:mm a" in the US locale. Relative time styles are not currently supported, and behave just like the corresponding non-relative style. |
aLocale |
Locale : the given locale. |
Returns | |
---|---|
DateFormat |
a time formatter. |
TimeZone getTimeZone ()
返回时区。
Returns | |
---|---|
TimeZone |
the time zone associated with the calendar of DateFormat. |
int hashCode ()
重写hashCode。
Returns | |
---|---|
int |
a hash code value for this object. |
boolean isCalendarLenient ()
返回封装的Calendar对象中的日期/时间解析是否宽松。
Returns | |
---|---|
boolean |
boolean isLenient ()
返回封装的Calendar对象和DateFormat空格和数值处理中的日期/时间解析是否宽松。
Returns | |
---|---|
boolean |
Date parse (String text)
分析日期/时间字符串。 例如,时间文本“07/10/96 4:5 PM,PDT”将被解析为相当于日期(837039928046)的日期。 解析从字符串的开始处开始并尽可能地进行。 假设没有遇到解析错误,该函数不会返回有关解析消耗了多少字符串的任何信息。 如果您需要这些信息,请使用带有ParsePosition的parse()版本。
默认情况下,解析是宽松的:如果输入不在此对象格式方法使用的表单中,但仍然可以解析为日期,则解析成功。 客户可以通过调用setLenient(false)来坚持严格遵守格式。
请注意,与某些日历相关的正常日期格式(例如中国农历)未指定足够的字段,以便明确解析日期。 在中国农历的情况下,虽然规定了当前60年周期内的年份,但自日历开始日期(在日历对象的ERA字段中)以来的这种周期数通常不是格式和解析可能会承担错误的时代。 对于这种情况,建议客户端使用解析方法进行解析,该解析方法采用将日历传入的日历设置为当前日期,或者将时间/周期内的日期设置为缺少格式时应该假设的日期。
Parameters | |
---|---|
text |
String : The date/time string to be parsed |
Returns | |
---|---|
Date |
A Date, or null if the input could not be parsed |
Throws | |
---|---|
ParseException |
If the given string cannot be parsed as a date. |
也可以看看:
Date parse (String text, ParsePosition pos)
根据给定的解析位置解析日期/时间字符串。 例如,时间文本“07/10/96 4:5 PM,PDT”将被解析为相当于日期(837039928046)的日期。
默认情况下,解析是宽松的:如果输入不在此对象格式方法使用的表单中,但仍然可以解析为日期,则解析成功。 客户可以通过调用setLenient(false)来坚持严格遵守格式。
请注意,与某些日历相关的正常日期格式(例如中国农历)未指定足够的字段,以便明确解析日期。 在中国农历的情况下,虽然规定了当前60年周期内的年份,但自日历开始日期(在日历对象的ERA字段中)以来的这种周期数通常不是格式和解析可能会承担错误的时代。 对于这种情况,建议客户端使用解析方法进行解析,该解析方法采用将日历传入的日历设置为当前日期,或者将时间/周期内的日期设置为缺少格式时应该假设的日期。
Parameters | |
---|---|
text |
String : The date/time string to be parsed |
pos |
ParsePosition : On input, the position at which to start parsing; on output, the position at which parsing terminated, or the start position if the parse failed. |
Returns | |
---|---|
Date |
A Date, or null if the input could not be parsed |
也可以看看:
void parse (String text, Calendar cal, ParsePosition pos)
根据给定的解析位置解析日期/时间字符串。 例如,时间文本“07/10/96 4:5 PM,PDT”将被解析为相当于日期(837039928046)的日历。 在调用此方法之前,调用者应以两种方式之一初始化日历(除非保留现有字段信息):(1)清除日历,或(2)将日历设置为当前日期(或日期字段应该用于提供解析日期中缺失的值)。 例如,中国的日历日期通常不提供时代/周期; 在这种情况下,传入的日历应设置为应该假定的时代内的日期,通常是当前时代。
默认情况下,解析是宽松的:如果输入不在此对象格式方法使用的表单中,但仍然可以解析为日期,则解析成功。 客户可以通过调用setLenient(false)来坚持严格遵守格式。
Parameters | |
---|---|
text |
String : The date/time string to be parsed |
cal |
Calendar : The calendar set on input to the date and time to be used for missing values in the date/time string being parsed, and set on output to the parsed date/time. In general, this should be initialized before calling this method - either cleared or set to the current date, depending on desired behavior. If this parse fails, the calendar may still have been modified. When the calendar type is different from the internal calendar held by this DateFormat instance, calendar field values will be parsed based on the internal calendar initialized with the time and the time zone taken from this calendar, then the parse result (time in milliseconds and time zone) will be set back to this calendar. |
pos |
ParsePosition : On input, the position at which to start parsing; on output, the position at which parsing terminated, or the start position if the parse failed. |
也可以看看:
Object parseObject (String source, ParsePosition pos)
将日期/时间字符串分析到对象中。 这个便捷方法只需调用parse(String,ParsePosition)。
Parameters | |
---|---|
source |
String : A String , part of which should be parsed. |
pos |
ParsePosition : A ParsePosition object with index and error index information as described above. |
Returns | |
---|---|
Object |
An Object parsed from the string. In case of error, returns null. |
也可以看看:
DateFormat setBooleanAttribute (DateFormat.BooleanAttribute key, boolean value)
为此实例设置布尔属性。 DateFormat宽大的方面由布尔属性控制。
Parameters | |
---|---|
key |
DateFormat.BooleanAttribute
|
value |
boolean
|
Returns | |
---|---|
DateFormat |
也可以看看:
void setCalendar (Calendar newCalendar)
设置此日期格式使用的日历。 最初,使用指定或默认区域设置的默认日历。
Parameters | |
---|---|
newCalendar |
Calendar : the new Calendar to be used by the date format |
void setCalendarLenient (boolean lenient)
指定封装的Calendar对象中的日期/时间解析是否应该是宽松的。 通过宽松的解析,解析器可以使用启发式来解释不精确匹配此对象格式的输入。 没有宽松的解析,输入必须更紧密地匹配这个对象的格式。
Parameters | |
---|---|
lenient |
boolean : when true, Calendar parsing is lenient |
也可以看看:
void setContext (DisplayContext context)
[icu]在格式化程序中设置特定的DisplayContext值,例如CAPITALIZATION_FOR_STANDALONE。
Parameters | |
---|---|
context |
DisplayContext : The DisplayContext value to set. |
void setLenient (boolean lenient)
指定日期/时间解析是否是宽松的。 通过宽松的解析,解析器可以使用启发式来解释不精确匹配此对象格式的输入。 没有宽松的解析,输入必须更紧密地匹配这个对象的格式。
注意: ICU 53引入了更细粒度的宽松控制(并添加了新的控制点),使得首选方法成为setCalendarLenient()和setBooleanAttribute()调用的组合。 此方法支持先前的功能,但可能不支持将来的宽大控制和DateFormat行为。 为了控制宽恕,Calendar和DateFormat空白和数字公差,该方法可以安全使用。 但是,通过此方法混合宽大控制和通过setBooleanAttribute()修改较新属性可能会产生不良结果。
Parameters | |
---|---|
lenient |
boolean : True specifies date/time interpretation to be lenient. |
void setNumberFormat (NumberFormat newNumberFormat)
设置数字格式器。
Parameters | |
---|---|
newNumberFormat |
NumberFormat : the given new NumberFormat. |
void setTimeZone (TimeZone zone)
设置此DateFormat对象日历的时区。
Parameters | |
---|---|
zone |
TimeZone : the given new time zone. |