Most visited

Recently visited

Added in API level 24

DateFormat

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可帮助您为任何区域设置格式化和解析日期。 您的代码可以完全独立于语言环境约定数月,一周中的几天甚至日历格式:月球与太阳能。 它提供了许多用于获取默认日期/时间格式化器的类方法,这些方法基于给定语言环境和一些格式化样式或任意“骨架”的默认值。

  1. The formatting styles include FULL, LONG, MEDIUM, and SHORT. More detail and examples of using these styles are provided in the method descriptions.
  2. The formatting styles only cover a fraction of the necessary usage. You often need to have just certain combinations of fields, like Month and Year, but have it to be formatted appropriate to a given locale. This is done using the (misnamed) getPatternInstance() method, supplying a skeleton. There are a number of constants that have common pre-defined skeletons, such as 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中的模式,除了它们:

  1. only keep the field pattern letter and ignore all other parts in a pattern, such as space, punctuation, and string literals.
  2. are independent of the order of fields.
  3. ignore certain differences in the field's pattern letter length:
    1. For those non-digit calendar fields, the pattern letter length is important, such as MMM, MMMM, and MMMMM; E and EEEE, and the field's pattern letter length is honored.
    2. For the digit calendar fields, such as M or MM, d or dd, yy or yyyy, the field pattern length is ignored and the best match, which is defined in date time patterns, will be returned without honor the field pattern letter length in skeleton.

如果您愿意,您还可以根据格式设置时区。 如果你想更多地控制格式或解析(或者想让用户更好控制),你可以尝试将你从工厂方法获得的DateFormat转换为SimpleDateFormat。 这对大多数国家都有效; 只要记得把它放在试块中,以防遇到不寻常的问题。

你也可以使用ParsePosition和FieldPosition的解析和格式化方法来让你

Synchronization

Date formats are not synchronized. It is recommended to create separate format instances for each thread. If multiple threads access a format concurrently, it must be synchronized externally.

也可以看看:

Summary

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选择器,对应于 AM_PM字段。

int DATE_FIELD

用于'd'字段对齐的FieldPosition选择器,对应于 DATE字段。

String DAY

[icu]日期骨架的常量。

int DAY_OF_WEEK_FIELD

用于'E'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK字段。

int DAY_OF_WEEK_IN_MONTH_FIELD

用于'F'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK_IN_MONTH字段。

int DAY_OF_YEAR_FIELD

用于'D'字段对齐的FieldPosition选择器,对应于 DAY_OF_YEAR字段。

int DEFAULT

常量默认样式模式。

int DOW_LOCAL_FIELD

[icu] FieldPosition用于'e'字段对齐的选择器,对应于 DOW_LOCAL字段。

int ERA_FIELD

用于'G'字段对齐的FieldPosition选择器,对应于 ERA字段。

int EXTENDED_YEAR_FIELD

[icu] FieldPosition选择器用于'u'字段对齐,对应于 EXTENDED_YEAR字段。

int FRACTIONAL_SECOND_FIELD

[icu]用于'S'字段对齐的FieldPosition选择器,对应于 MILLISECOND字段。

int FULL

不变的全样式模式。

String GENERIC_TZ

[icu]用于通用非地址格式的常量,例如太平洋时间; 用于组合日期+时间+区域或时间+区域。

String HOUR

[icu]具有小时的日期骨架常数,区域设置的首选小时格式(12或24)。

int HOUR0_FIELD

用于'K'字段对齐的FieldPosition选择器,对应于 HOUR字段。

int HOUR1_FIELD

用于'h'字段对齐的FieldPosition选择器,对应于 HOUR字段。

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选择器,对应于 HOUR_OF_DAY字段。

int HOUR_OF_DAY1_FIELD

用于'k'字段对齐的FieldPosition选择器,对应于 HOUR_OF_DAY字段。

int JULIAN_DAY_FIELD

[icu]用于'g'字段对齐的FieldPosition选择器,对应于 JULIAN_DAY字段。

String LOCATION_TZ

[icu]用于通用位置格式的常量,例如洛杉矶时间; 用于组合日期+时间+区域或时间+区域。

int LONG

用于长型图案的常量。

int MEDIUM

中等风格模式的常量。

int MILLISECONDS_IN_DAY_FIELD

[icu]用于'A'字段对齐的FieldPosition选择器,对应于 MILLISECONDS_IN_DAY字段。

int MILLISECOND_FIELD

FRACTIONAL_SECOND_FIELD的别名。

String MINUTE

[icu]带分钟的日期骨架的常量。

int MINUTE_FIELD

用于'm'字段对齐的FieldPosition选择器,对应于 MINUTE字段。

String MINUTE_SECOND

[icu]带分秒的日期骨架的常量。

String MONTH

[icu]带月份的日期骨架的常量。

String MONTH_DAY

[icu]日月长日期骨架的常量。

int MONTH_FIELD

用于'M'字段对齐的FieldPosition选择器,对应于 MONTH字段。

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选择器,对应于 MONTH字段。

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'字段对齐,对应于 SECOND字段。

int SHORT

用于短样式的常量。

String SPECIFIC_TZ

[icu]用于特定非位置格式的常量,例如太平洋夏令时; 用于组合日期+时间+区域或时间+区域。

int STANDALONE_DAY_FIELD

[icu]用于'c'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK字段。

int STANDALONE_MONTH_FIELD

[icu]用于'L'字段对齐的FieldPosition选择器,对应于 MONTH字段。

int STANDALONE_QUARTER_FIELD

[icu]用于'q'字段对齐的FieldPosition选择器,对应于 MONTH字段。

int TIMEZONE_FIELD

FieldPosition选择器用于'z'字段对齐,对应于 ZONE_OFFSETDST_OFFSET字段。

int TIMEZONE_GENERIC_FIELD

[icu]用于'v'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

int TIMEZONE_ISO_FIELD

[icu]用于'X'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

int TIMEZONE_ISO_LOCAL_FIELD

[icu]用于'x'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

int TIMEZONE_LOCALIZED_GMT_OFFSET_FIELD

[icu]用于'O'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

int TIMEZONE_RFC_FIELD

[icu]用于'Z'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

int TIMEZONE_SPECIAL_FIELD

[icu]用于'V'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

String WEEKDAY

[icu]星期 的日期骨架的常量。

int WEEK_OF_MONTH_FIELD

用于'W'字段对齐的FieldPosition选择器,对应于 WEEK_OF_MONTH字段。

int WEEK_OF_YEAR_FIELD

用于'w'字段对齐的FieldPosition选择器,对应于 WEEK_OF_YEAR字段。

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'字段对齐,对应于 YEAR字段。

String YEAR_MONTH

[icu]日期骨架与年份和月份不变。

String YEAR_MONTH_DAY

[icu]日期骨架与年,月和日的常量。

String YEAR_MONTH_WEEKDAY_DAY

[icu]日期骨架与年,月,周,日不变的常量。

int YEAR_NAME_FIELD

[icu]用于'U'字段对齐的FieldPosition选择器,对应于 YEAR字段。

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'字段对齐,对应于 YEAR_WOY字段。

Fields

protected Calendar calendar

DateFormat用于生成实现日期和时间格式所需的时间字段值的日历。

protected NumberFormat numberFormat

数字格式化程序 DateFormat用于在日期和时间格式化数字。

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)

为默认语言环境创建一个 DateFormat对象,该对象可用于格式化由 cal指定的日历系统中的 cal

static final DateFormat getDateInstance(Calendar cal, int dateStyle, ULocale locale)

创建一个 DateFormat对象,该对象可用于格式化由 cal指定的日历系统中的 cal

static final DateFormat getDateInstance()

使用默认的 FORMAT区域设置的默认格式样式返回日期格式程序。

static final DateFormat getDateInstance(int style, ULocale locale)

使用给定语言环境的给定格式样式返回日期格式程序。

static final DateFormat getDateInstance(Calendar cal, int dateStyle, Locale locale)

创建一个 DateFormat对象,该对象可用于格式化由 cal指定的日历系统中的 cal

static final DateFormat getDateInstance(int style)

以默认的 FORMAT语言环境的给定格式样式返回日期格式程序。

static final DateFormat getDateTimeInstance(int dateStyle, int timeStyle)

使用默认的 FORMAT区域设置的给定日期和时间格式化样式返回日期/时间格式化程序。

static final DateFormat getDateTimeInstance()

使用默认的 FORMAT语言环境的默认格式样式返回日期/时间格式化程序。

static final DateFormat getDateTimeInstance(Calendar cal, int dateStyle, int timeStyle, ULocale locale)

创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

static final DateFormat getDateTimeInstance(Calendar cal, int dateStyle, int timeStyle, Locale locale)

创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

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)

为默认语言环境创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

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]创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

static final DateFormat getInstanceForSkeleton(Calendar cal, String skeleton, ULocale locale)

[icu]创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

static final DateFormat getInstanceForSkeleton(String skeleton, ULocale locale)

[icu]返回一个 DateFormat对象,该对象可用于格式化给定语言环境中的日期和时间。

static final DateFormat getInstanceForSkeleton(String skeleton, Locale locale)

[icu]返回一个 DateFormat对象,该对象可用于格式化给定语言环境中的日期和时间。

static final DateFormat getInstanceForSkeleton(String skeleton)

[icu]返回可用于在默认语言环境中格式化日期和时间的 DateFormat对象。

NumberFormat getNumberFormat()

返回此日期/时间格式化程序用于格式化和解析时间的数字格式器。

static final DateFormat getPatternInstance(String skeleton, Locale locale)

[icu]返回一个 DateFormat对象,该对象可用于格式化给定语言环境中的日期和时间。

static final DateFormat getPatternInstance(String skeleton, ULocale locale)

[icu]返回可用于在给定语言环境中格式化日期和时间的 DateFormat对象。

static final DateFormat getPatternInstance(String skeleton)

[icu]返回可用于在默认语言环境中格式化日期和时间的 DateFormat对象。

static final DateFormat getPatternInstance(Calendar cal, String skeleton, Locale locale)

[icu]创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

static final DateFormat getPatternInstance(Calendar cal, String skeleton, ULocale locale)

[icu]创建一个 DateFormat对象,该对象可用于在由 cal指定的日历系统中格式化日期和时间。

static final DateFormat getTimeInstance(Calendar cal, int timeStyle)

创建一个 DateFormat对象,该对象可用于格式化由 cal指定的日历系统中的 cal

static final DateFormat getTimeInstance()

使用默认的 FORMAT语言环境的默认格式样式获取时间格式器。

static final DateFormat getTimeInstance(int style, ULocale locale)

使用给定语言环境的给定格式样式返回时间格式化程序。

static final DateFormat getTimeInstance(Calendar cal, int timeStyle, ULocale locale)

创建一个 DateFormat对象,该对象可用于格式化由 cal指定的日历系统中的 cal

static final DateFormat getTimeInstance(Calendar cal, int timeStyle, Locale locale)

创建一个 DateFormat对象,该对象可用于格式化由 cal指定的日历系统中的 cal

static final DateFormat getTimeInstance(int style)

以默认的 FORMAT语言环境的给定格式样式返回时间格式化程序。

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

Constants

ABBR_GENERIC_TZ

Added in API level 24
String ABBR_GENERIC_TZ

[icu] 通用非地址格式的常量,如果可能的话缩写,例如PT; 用于组合日期+时间+区域或时间+区域。

也可以看看:

常数值:“v”

ABBR_MONTH

Added in API level 24
String ABBR_MONTH

[icu]带缩写月份的日期骨架的常量。

常数值:“MMM”

ABBR_MONTH_DAY

Added in API level 24
String ABBR_MONTH_DAY

[icu]日期骨架的缩写月份和日期的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“MMMd”

ABBR_MONTH_WEEKDAY_DAY

Added in API level 24
String ABBR_MONTH_WEEKDAY_DAY

[icu]具有缩写月份,工作日和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“MMMEd”

ABBR_QUARTER

Added in API level 24
String ABBR_QUARTER

[icu]日期缩写为quarter的常量。

常数值:“QQQ”

ABBR_SPECIFIC_TZ

Added in API level 24
String ABBR_SPECIFIC_TZ

[icu]用于特定非位置格式的常量,如果可能的话缩写,例如PDT; 用于组合日期+时间+区域或时间+区域。

也可以看看:

常量值:“z”

ABBR_UTC_TZ

Added in API level 24
String ABBR_UTC_TZ

[icu] 本地GMT / UTC格式的常量,例如GMT + 8:00或HPG-8:00; 用于组合日期+时间+区域或时间+区域。

也可以看看:

常数值:“ZZZZ”

ABBR_WEEKDAY

Added in API level 24
String ABBR_WEEKDAY

[icu]日期缩写为星期 几的骨架常量。

常数值:“E”

AM_PM_FIELD

Added in API level 24
int AM_PM_FIELD

用于'a'字段对齐的FieldPosition选择器,对应于 AM_PM字段。

常量值:14(0x0000000e)

DATE_FIELD

Added in API level 24
int DATE_FIELD

用于'd'字段对齐的FieldPosition选择器,对应于 DATE字段。

常量值:3(0x00000003)

DAY

Added in API level 24
String DAY

[icu]日期骨架的常量。

常数值:“d”

DAY_OF_WEEK_FIELD

Added in API level 24
int DAY_OF_WEEK_FIELD

用于'E'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK字段。

常量值:9(0x00000009)

DAY_OF_WEEK_IN_MONTH_FIELD

Added in API level 24
int DAY_OF_WEEK_IN_MONTH_FIELD

用于'F'字段对齐的FieldPosition选择器,对应于 DAY_OF_WEEK_IN_MONTH字段。

常量值:11(0x0000000b)

DAY_OF_YEAR_FIELD

Added in API level 24
int DAY_OF_YEAR_FIELD

用于'D'字段对齐的FieldPosition选择器,对应于 DAY_OF_YEAR字段。

常量值:10(0x0000000a)

DEFAULT

Added in API level 24
int DEFAULT

常量默认样式模式。 它的值是MEDIUM。

常量值:2(0x00000002)

DOW_LOCAL_FIELD

Added in API level 24
int DOW_LOCAL_FIELD

[icu]用于'e'字段对齐的FieldPosition选择器,对应于 DOW_LOCAL字段。

常量值:19(0x00000013)

ERA_FIELD

Added in API level 24
int ERA_FIELD

用于'G'字段对齐的FieldPosition选择器,对应于 ERA字段。

常量值:0(0x00000000)

EXTENDED_YEAR_FIELD

Added in API level 24
int EXTENDED_YEAR_FIELD

[icu] FieldPosition用于'u'字段对齐的选择器,对应于 EXTENDED_YEAR字段。

常量值:20(0x00000014)

FRACTIONAL_SECOND_FIELD

Added in API level 24
int FRACTIONAL_SECOND_FIELD

[icu]用于'S'字段对齐的FieldPosition选择器,对应于MILLISECOND字段。 注意:使用'S'的时间格式最多可以显示小数秒的三位有效数字,对应于毫秒分辨率和SSS的小数秒子图。 如果子图案是S或SS,则小数秒值将被截断(不是四舍五入)为指定显示位置的数量。 如果小数秒子模式长于SSS,则附加显示位置将填充零。

常量值:8(0x00000008)

FULL

Added in API level 24
int FULL

不变的全样式模式。

常量值:0(0x00000000)

GENERIC_TZ

Added in API level 24
String GENERIC_TZ

[icu]用于通用非地址格式的常量,例如太平洋时间; 用于组合日期+时间+区域或时间+区域。

也可以看看:

常数值:“vvvv”

HOUR

Added in API level 24
String HOUR

[icu]具有小时的日期骨架常数,区域设置的首选小时格式(12或24)。

常数值:“j”

HOUR0_FIELD

Added in API level 24
int HOUR0_FIELD

用于'K'字段对齐的FieldPosition选择器,对应于HOUR字段。 HOUR0_FIELD用于基于零的12小时时钟。 例如,下午11:30 + 1小时产生00:30 AM。

常量值:16(0x00000010)

HOUR1_FIELD

Added in API level 24
int HOUR1_FIELD

用于'h'字段对齐的FieldPosition选择器,对应于HOUR字段。 HOUR1_FIELD用于一个基于12小时制的时钟。 例如,上午12:30下午11:30 PM + 1小时。

常量值:15(0x0000000f)

HOUR24

Added in API level 24
String HOUR24

[icu] 24小时演示中带有小时的日期骨架的常量。

常数值:“H”

HOUR24_MINUTE

Added in API level 24
String HOUR24_MINUTE

[icu] 24小时演示文稿中带小时和分钟的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常数值:“Hm”

HOUR24_MINUTE_SECOND

Added in API level 24
String HOUR24_MINUTE_SECOND

[icu] 24小时演示文稿中带有小时,分钟和秒的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常数值:“Hms”

HOUR_MINUTE

Added in API level 24
String HOUR_MINUTE

[icu]具有小时和分钟的日期骨架的常量,以及语言环境的首选小时格式(12或24)。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“jm”

HOUR_MINUTE_SECOND

Added in API level 24
String HOUR_MINUTE_SECOND

[icu]具有小时,分钟和秒的日期骨架的常量,以及区域设置的首选小时格式(12或24)。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“jms”

HOUR_OF_DAY0_FIELD

Added in API level 24
int HOUR_OF_DAY0_FIELD

用于'H'字段对齐的FieldPosition选择器,对应于HOUR_OF_DAY字段。 HOUR_OF_DAY0_FIELD用于基于零的24小时时钟。 例如,23:59 + 01:00的结果是00:59。

常量值:5(0x00000005)

HOUR_OF_DAY1_FIELD

Added in API level 24
int HOUR_OF_DAY1_FIELD

用于'k'字段对齐的FieldPosition选择器,对应于HOUR_OF_DAY字段。 HOUR_OF_DAY1_FIELD用于基于一个24小时制的时钟。 例如,23:59 + 01:00在24:59结果。

常量值:4(0x00000004)

JULIAN_DAY_FIELD

Added in API level 24
int JULIAN_DAY_FIELD

[icu]用于'g'字段对齐的FieldPosition选择器,对应于 JULIAN_DAY字段。

常量值:21(0x00000015)

LOCATION_TZ

Added in API level 24
String LOCATION_TZ

[icu]用于通用位置格式的常量,例如洛杉矶时间; 用于组合日期+时间+区域或时间+区域。

也可以看看:

常数值:“VVVV”

LONG

Added in API level 24
int LONG

用于长型图案的常量。

常数值:1(0x00000001)

MEDIUM

Added in API level 24
int MEDIUM

中等风格模式的常量。

常量值:2(0x00000002)

MILLISECONDS_IN_DAY_FIELD

Added in API level 24
int MILLISECONDS_IN_DAY_FIELD

[icu]用于'A'字段对齐的FieldPosition选择器,对应于 MILLISECONDS_IN_DAY字段。

常量值:22(0x00000016)

MILLISECOND_FIELD

Added in API level 24
int MILLISECOND_FIELD

FRACTIONAL_SECOND_FIELD的别名。

常量值:8(0x00000008)

MINUTE

Added in API level 24
String MINUTE

[icu]带分钟的日期骨架的常量。

常数值:“m”

MINUTE_FIELD

Added in API level 24
int MINUTE_FIELD

FieldPosition选择'm'字段对齐,对应于 MINUTE字段。

常数值:6(0x00000006)

MINUTE_SECOND

Added in API level 24
String MINUTE_SECOND

[icu]带分秒的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“ms”

MONTH

Added in API level 24
String MONTH

[icu]带月份的日期骨架的常量。

常数值:“MMMM”

MONTH_DAY

Added in API level 24
String MONTH_DAY

[icu]日月长日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“MMMMd”

MONTH_FIELD

Added in API level 24
int MONTH_FIELD

用于'M'字段对齐的FieldPosition选择器,对应于 MONTH字段。

常量值:2(0x00000002)

MONTH_WEEKDAY_DAY

Added in API level 24
String MONTH_WEEKDAY_DAY

[icu]月份,周日和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“MMMMEEEEd”

NONE

Added in API level 24
int NONE

[icu]空样式的常量。

常量值:-1(0xffffffff)

NUM_MONTH

Added in API level 24
String NUM_MONTH

[icu]具有数字月份的日期骨架的常量。

常数值:“M”

NUM_MONTH_DAY

Added in API level 24
String NUM_MONTH_DAY

[icu]具有数字月和日的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常数值:“Md”

NUM_MONTH_WEEKDAY_DAY

Added in API level 24
String NUM_MONTH_WEEKDAY_DAY

[icu]具有数字月份,星期和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常数值:“MEd”

QUARTER

Added in API level 24
String QUARTER

[icu]带有季度的日期骨架的常量。

常数值:“QQQQ”

QUARTER_FIELD

Added in API level 24
int QUARTER_FIELD

[icu]用于'Q'字段对齐的FieldPosition选择器,对应于MONTH字段。 这显示了季度。

常量值:27(0x0000001b)

RELATIVE

Added in API level 24
int RELATIVE

[icu]相对风格掩码的常量。

常量值:128(0x00000080)

RELATIVE_DEFAULT

Added in API level 24
int RELATIVE_DEFAULT

[icu]相对默认样式模式的常量。

常量值:130(0x00000082)

RELATIVE_FULL

Added in API level 24
int RELATIVE_FULL

[icu]相对全格式模式的常量。

常量值:128(0x00000080)

RELATIVE_LONG

Added in API level 24
int RELATIVE_LONG

[icu]相对风格样式的常量。

常量值:129(0x00000081)

RELATIVE_MEDIUM

Added in API level 24
int RELATIVE_MEDIUM

[icu]相对风格样式的常量。

常量值:130(0x00000082)

RELATIVE_SHORT

Added in API level 24
int RELATIVE_SHORT

[icu]相对风格样式的常量。

常量值:131(0x00000083)

SECOND

Added in API level 24
String SECOND

[icu]第二个日期骨架的常量。

常数值:“s”

SECOND_FIELD

Added in API level 24
int SECOND_FIELD

FieldPosition选择器的's'字段对齐,对应于 SECOND字段。

常量值:7(0x00000007)

SHORT

Added in API level 24
int SHORT

用于短样式的常量。

常量值:3(0x00000003)

SPECIFIC_TZ

Added in API level 24
String SPECIFIC_TZ

[icu]用于特定非位置格式的常量,例如太平洋夏令时; 用于组合日期+时间+区域或时间+区域。

也可以看看:

常量值:“zzzz”

STANDALONE_DAY_FIELD

Added in API level 24
int STANDALONE_DAY_FIELD

[icu]用于'c'字段对齐的FieldPosition选择器,对应于DAY_OF_WEEK字段。 这将显示独立的日期名称(如果可用)。

常量值:25(0x00000019)

STANDALONE_MONTH_FIELD

Added in API level 24
int STANDALONE_MONTH_FIELD

[icu]用于'L'字段对齐的FieldPosition选择器,对应于MONTH字段。 这将显示独立的月份名称(如果可用)。

常量值:26(0x0000001a)

STANDALONE_QUARTER_FIELD

Added in API level 24
int STANDALONE_QUARTER_FIELD

[icu]用于'q'字段对齐的FieldPosition选择器,对应于MONTH字段。 如果可用,这将显示独立季度。

常量值:28(0x0000001c)

TIMEZONE_FIELD

Added in API level 24
int TIMEZONE_FIELD

FieldPosition选择器用于'z'字段对齐,对应于 ZONE_OFFSETDST_OFFSET字段。

常量值:17(0x00000011)

TIMEZONE_GENERIC_FIELD

Added in API level 24
int TIMEZONE_GENERIC_FIELD

[icu]用于'v'字段对齐的FieldPosition选择器,对应于ZONE_OFFSETDST_OFFSET字段。 这将显示通用区域名称(如果可用)。

常量值:24(0x00000018)

TIMEZONE_ISO_FIELD

Added in API level 24
int TIMEZONE_ISO_FIELD

[icu]用于'X'字段对齐的FieldPosition选择器,对应于ZONE_OFFSETDST_OFFSET字段。 这显示ISO 8601本地时间偏移格式或UTC指示符(“Z”)。

常量值:32(0x00000020)

TIMEZONE_ISO_LOCAL_FIELD

Added in API level 24
int TIMEZONE_ISO_LOCAL_FIELD

[icu]用于'x'字段对齐的FieldPosition选择器,对应于ZONE_OFFSETDST_OFFSET字段。 这显示ISO 8601本地时间偏移格式。

常量值:33(0x00000021)

TIMEZONE_LOCALIZED_GMT_OFFSET_FIELD

Added in API level 24
int TIMEZONE_LOCALIZED_GMT_OFFSET_FIELD

[icu]用于'O'字段对齐的FieldPosition选择器,对应于ZONE_OFFSETDST_OFFSET字段。 这显示了本地化的GMT格式。

常量值:31(0x0000001f)

TIMEZONE_RFC_FIELD

Added in API level 24
int TIMEZONE_RFC_FIELD

[icu]用于'Z'字段对齐的FieldPosition选择器,对应于 ZONE_OFFSETDST_OFFSET字段。

常量值:23(0x00000017)

TIMEZONE_SPECIAL_FIELD

Added in API level 24
int TIMEZONE_SPECIAL_FIELD

[icu] FieldPosition选择器用于'V'字段对齐,对应于ZONE_OFFSETDST_OFFSET字段。 这将显示指定VVVV时的回退时区名称,以及指定单个V时通常忽略的短标准或日光时区名称。

常量值:29(0x0000001d)

WEEKDAY

Added in API level 24
String WEEKDAY

[icu]星期 的日期骨架的常量。

常数值:“EEEE”

WEEK_OF_MONTH_FIELD

Added in API level 24
int WEEK_OF_MONTH_FIELD

用于'W'字段对齐的FieldPosition选择器,对应于 WEEK_OF_MONTH字段。

常量值:13(0x0000000d)

WEEK_OF_YEAR_FIELD

Added in API level 24
int WEEK_OF_YEAR_FIELD

用于'w'字段对齐的FieldPosition选择器,对应于 WEEK_OF_YEAR字段。

常量值:12(0x0000000c)

YEAR

Added in API level 24
String YEAR

[icu]与年份的日期骨架不变。

常量值:“y”

YEAR_ABBR_MONTH

Added in API level 24
String YEAR_ABBR_MONTH

[icu]具有年份和缩写月份的日期骨架的常量。

常数值:“yMMM”

YEAR_ABBR_MONTH_DAY

Added in API level 24
String YEAR_ABBR_MONTH_DAY

[icu]日期骨架与年份,缩写月份和日期的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“yMMMd”

YEAR_ABBR_MONTH_WEEKDAY_DAY

Added in API level 24
String YEAR_ABBR_MONTH_WEEKDAY_DAY

[icu]日期骨架与年份,缩写月份,工作日和日期的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“yMMMEd”

YEAR_ABBR_QUARTER

Added in API level 24
String YEAR_ABBR_QUARTER

[icu]与年份和缩写季度的日期骨架不变。

常量值:“yQQQ”

YEAR_FIELD

Added in API level 24
int YEAR_FIELD

FieldPosition选择'y'字段对齐,对应于 YEAR字段。

常数值:1(0x00000001)

YEAR_MONTH

Added in API level 24
String YEAR_MONTH

[icu]日期骨架与年份和月份不变。

常量值:“yMMMM”

YEAR_MONTH_DAY

Added in API level 24
String YEAR_MONTH_DAY

[icu]日期骨架与年,月和日的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“yMMMMd”

YEAR_MONTH_WEEKDAY_DAY

Added in API level 24
String YEAR_MONTH_WEEKDAY_DAY

[icu]日期骨架与年,月,周,日不变的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“yMMMMEEEEd”

YEAR_NAME_FIELD

Added in API level 24
int YEAR_NAME_FIELD

[icu]用于'U'字段对齐的FieldPosition选择器,对应于YEAR字段。 这将显示循环年份名称(如果可用)。

常量值:30(0x0000001e)

YEAR_NUM_MONTH

Added in API level 24
String YEAR_NUM_MONTH

[icu]具有年份和数字月份的日期骨架的常量。

常量值:“yM”

YEAR_NUM_MONTH_DAY

Added in API level 24
String YEAR_NUM_MONTH_DAY

[icu]包含年份,数字月份和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“yMd”

YEAR_NUM_MONTH_WEEKDAY_DAY

Added in API level 24
String YEAR_NUM_MONTH_WEEKDAY_DAY

[icu]包含年份,数字月份,周日和日期的日期骨架的常量。 用于组合日期+时间,日期+时间+区域或时间+区域。

常量值:“yMEd”

YEAR_QUARTER

Added in API level 24
String YEAR_QUARTER

[icu]与年和季度的日期骨架不变。

常量值:“yQQQQ”

YEAR_WOY_FIELD

Added in API level 24
int YEAR_WOY_FIELD

[icu] FieldPosition选择'Y'字段对齐,对应于 YEAR_WOY字段。

常量值:18(0x00000012)

Fields

calendar

Added in API level 24
Calendar calendar

DateFormat用于生成实现日期和时间格式所需的时间字段值的日历。 子类应将其初始化为适合与此DateFormat关联的语言环境的日历。

numberFormat

Added in API level 24
NumberFormat numberFormat

数字格式程序DateFormat用于在日期和时间格式化数字。 子类应将其初始化为适合与此DateFormat相关联的语言环境的数字格式。

Protected constructors

DateFormat

Added in API level 24
DateFormat ()

创建一个新的日期格式。

Public methods

clone

Added in API level 24
Object clone ()

覆盖克隆。

Returns
Object a clone of this instance.

equals

Added in API level 24
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.

format

Added in API level 24
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.

也可以看看:

format

Added in API level 24
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.

format

Added in API level 24
String format (Date date)

将日期格式化为日期/时间字符串。

Parameters
date Date: the time value to be formatted into a time string.
Returns
String the formatted time string.

format

Added in API level 24
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.

getAvailableLocales

Added in API level 24
Locale[] getAvailableLocales ()

返回安装了DateFormats的语言环境的集合。

Returns
Locale[] the set of locales for which DateFormats are installed.

getBooleanAttribute

Added in API level 24
boolean getBooleanAttribute (DateFormat.BooleanAttribute key)

如果返回false,则返回此实例的指定BooleanAttribute的当前值。

Parameters
key DateFormat.BooleanAttribute
Returns
boolean

也可以看看:

getCalendar

Added in API level 24
Calendar getCalendar ()

返回与此日期/时间格式化程序关联的日历。

Returns
Calendar the calendar associated with this date/time formatter.

getContext

Added in API level 24
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

getDateInstance

Added in API level 24
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.

getDateInstance

Added in API level 24
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

getDateInstance

Added in API level 24
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

getDateInstance

Added in API level 24
DateFormat getDateInstance ()

使用默认的 FORMAT语言环境的默认格式化样式返回日期格式化程序。

Returns
DateFormat a date formatter.

也可以看看:

getDateInstance

Added in API level 24
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.

getDateInstance

Added in API level 24
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

getDateInstance

Added in API level 24
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.

也可以看看:

getDateTimeInstance

Added in API level 24
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.

也可以看看:

getDateTimeInstance

Added in API level 24
DateFormat getDateTimeInstance ()

使用默认的 FORMAT语言环境的默认格式化样式返回日期/时间格式化程序。

Returns
DateFormat a date/time formatter.

也可以看看:

getDateTimeInstance

Added in API level 24
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

也可以看看:

getDateTimeInstance

Added in API level 24
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

也可以看看:

getDateTimeInstance

Added in API level 24
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.

getDateTimeInstance

Added in API level 24
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.

getDateTimeInstance

Added in API level 24
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

也可以看看:

getInstance

Added in API level 24
DateFormat getInstance (Calendar cal)

返回使用日期和时间的SHORT样式的默认日期/时间格式器。

Parameters
cal Calendar: The calendar system for which a date/time format is desired.
Returns
DateFormat

getInstance

Added in API level 24
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

getInstance

Added in API level 24
DateFormat getInstance ()

返回使用日期和时间的SHORT样式的默认日期/时间格式器。

Returns
DateFormat

getInstanceForSkeleton

Added in API level 24
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

getInstanceForSkeleton

Added in API level 24
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

getInstanceForSkeleton

Added in API level 24
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

getInstanceForSkeleton

Added in API level 24
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

getInstanceForSkeleton

Added in API level 24
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

getNumberFormat

Added in API level 24
NumberFormat getNumberFormat ()

返回此日期/时间格式化程序用于格式化和解析时间的数字格式器。

Returns
NumberFormat the number formatter which this date/time formatter uses.

getPatternInstance

Added in API level 24
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

getPatternInstance

Added in API level 24
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

getPatternInstance

Added in API level 24
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

getPatternInstance

Added in API level 24
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

getPatternInstance

Added in API level 24
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

getTimeInstance

Added in API level 24
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

也可以看看:

getTimeInstance

Added in API level 24
DateFormat getTimeInstance ()

使用默认的 FORMAT语言环境的默认格式样式获取时间格式器。

Returns
DateFormat a time formatter.

也可以看看:

getTimeInstance

Added in API level 24
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.

getTimeInstance

Added in API level 24
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

也可以看看:

getTimeInstance

Added in API level 24
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

也可以看看:

getTimeInstance

Added in API level 24
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.

也可以看看:

getTimeInstance

Added in API level 24
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.

getTimeZone

Added in API level 24
TimeZone getTimeZone ()

返回时区。

Returns
TimeZone the time zone associated with the calendar of DateFormat.

hashCode

Added in API level 24
int hashCode ()

重写hashCode。

Returns
int a hash code value for this object.

isCalendarLenient

Added in API level 24
boolean isCalendarLenient ()

返回封装的Calendar对象中的日期/时间解析是否宽松。

Returns
boolean

isLenient

Added in API level 24
boolean isLenient ()

返回封装的Calendar对象和DateFormat空格和数值处理中的日期/时间解析是否宽松。

Returns
boolean

parse

Added in API level 24
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.

也可以看看:

parse

Added in API level 24
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

也可以看看:

parse

Added in API level 24
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.

也可以看看:

parseObject

Added in API level 24
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.

也可以看看:

setBooleanAttribute

Added in API level 24
DateFormat setBooleanAttribute (DateFormat.BooleanAttribute key, 
                boolean value)

为此实例设置布尔属性。 DateFormat宽大的方面由布尔属性控制。

Parameters
key DateFormat.BooleanAttribute
value boolean
Returns
DateFormat

也可以看看:

setCalendar

Added in API level 24
void setCalendar (Calendar newCalendar)

设置此日期格式使用的日历。 最初,使用指定或默认区域设置的默认日历。

Parameters
newCalendar Calendar: the new Calendar to be used by the date format

setCalendarLenient

Added in API level 24
void setCalendarLenient (boolean lenient)

指定封装的Calendar对象中的日期/时间解析是否应该是宽松的。 通过宽松的解析,解析器可以使用启发式来解释不精确匹配此对象格式的输入。 没有宽松的解析,输入必须更紧密地匹配这个对象的格式。

Parameters
lenient boolean: when true, Calendar parsing is lenient

也可以看看:

setContext

Added in API level 24
void setContext (DisplayContext context)

[icu]在格式化程序中设置特定的DisplayContext值,例如CAPITALIZATION_FOR_STANDALONE。

Parameters
context DisplayContext: The DisplayContext value to set.

setLenient

Added in API level 24
void setLenient (boolean lenient)

指定日期/时间解析是否是宽松的。 通过宽松的解析,解析器可以使用启发式来解释不精确匹配此对象格式的输入。 没有宽松的解析,输入必须更紧密地匹配这个对象的格式。

注意: ICU 53引入了更细粒度的宽松控制(并添加了新的控制点),使得首选方法成为setCalendarLenient()和setBooleanAttribute()调用的组合。 此方法支持先前的功能,但可能不支持将来的宽大控制和DateFormat行为。 为了控制宽恕,Calendar和DateFormat空白和数字公差,该方法可以安全使用。 但是,通过此方法混合宽大控制和通过setBooleanAttribute()修改较新属性可能会产生不良结果。

Parameters
lenient boolean: True specifies date/time interpretation to be lenient.

也可以看看:

setNumberFormat

Added in API level 24
void setNumberFormat (NumberFormat newNumberFormat)

设置数字格式器。

Parameters
newNumberFormat NumberFormat: the given new NumberFormat.

setTimeZone

Added in API level 24
void setTimeZone (TimeZone zone)

设置此DateFormat对象日历的时区。

Parameters
zone TimeZone: the given new time zone.

Hooray!