TimeZoneFormat

TimeZoneFormat

TimeZoneFormat (ULocale locale)

子类的保护构造函数。

cloneAsThawed

TimeZoneFormat cloneAsThawed ()

提供克隆操作。 任何克隆都是最初解冻的。

format

StringBuffer format (Object obj, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

格式化对象并将结果文本附加到给定的字符串缓冲区。 如果参数pos标识该格式使用的字段，则其索引设置为遇到的第一个此类字段的开始和结尾。

format

String format (TimeZoneFormat.Style style, 
                TimeZone tz, 
                long date, 
                Output<TimeZoneFormat.TimeType> timeType)

返回样式给定日期的时区显示名称。 此方法需要一个额外的参数Output<TimeType> timeType除的参数列表format(Style, TimeZone, long) 。 该参数用于接收实际用于显示名称的时间类型（标准时间或夏令时或未知）。

format

String format (TimeZoneFormat.Style style, 
                TimeZone tz, 
                long date)

返回样式给定日期的时区显示名称。

注意 ：样式可能会定义回退样式。 例如，当请求GENERIC_LONG ，但没有可用于GENERIC_LONG样式的显示名称数据时，实现可能使用GENERIC_LOCATION或LOCALIZED_GMT 。 有关详细信息，请参阅UTS＃35 UNICODE LOCALE DATA MARKUP LANGUAGE（LDML） Appendix J: Time Zone Display Name 。

formatOffsetISO8601Basic

String formatOffsetISO8601Basic (int offset, 
                boolean useUtcIndicator, 
                boolean isShort, 
                boolean ignoreSeconds)

返回给定偏移量的ISO 8601基本时区字符串。 例如，“-08”，“-0830”和“Z”

formatOffsetISO8601Extended

String formatOffsetISO8601Extended (int offset, 
                boolean useUtcIndicator, 
                boolean isShort, 
                boolean ignoreSeconds)

返回给定偏移量的ISO 8601扩展时区字符串。 例如，“-08：00”，“-08：30”和“Z”

formatOffsetLocalizedGMT

String formatOffsetLocalizedGMT (int offset)

返回给定偏移量的本地化GMT（UTC）偏移格式。 本地化的GMT偏移量由以下定义：

• GMT format pattern (e.g. "GMT {0}" - see getGMTPattern())
• Offset time pattern (e.g. "+HH:mm" - see getGMTOffsetPattern(GMTOffsetPatternType))
• Offset digits (e.g. "0123456789" - see getGMTOffsetDigits())
• GMT zero format (e.g. "GMT" - see getGMTZeroFormat())

formatOffsetShortLocalizedGMT

String formatOffsetShortLocalizedGMT (int offset)

返回给定偏移量的短局部化GMT（UTC）偏移格式。 短局部GMT时间偏移由以下定义：

• GMT format pattern (e.g. "GMT {0}" - see getGMTPattern())
• Offset time pattern (e.g. "+HH:mm" - see getGMTOffsetPattern(GMTOffsetPatternType))
• Offset digits (e.g. "0123456789" - see getGMTOffsetDigits())
• GMT zero format (e.g. "GMT" - see getGMTZeroFormat())

formatToCharacterIterator

AttributedCharacterIterator formatToCharacterIterator (Object obj)

格式化产生AttributedCharacterIterator的对象。 您可以使用返回的AttributedCharacterIterator构建生成的字符串，以及确定有关生成的字符串的信息。

AttributedCharacterIterator的每个属性键都是类型Field 。 它是由每Format实现定义什么合法的值是在每个属性AttributedCharacterIterator ，但通常属性键也用作属性值。

默认实现创建一个没有属性的AttributedCharacterIterator 。 支持字段的子类应该覆盖该字段并创建具有有意义属性的AttributedCharacterIterator 。

freeze

TimeZoneFormat freeze ()

冻结对象。

getDefaultParseOptions

EnumSet<TimeZoneFormat.ParseOption> getDefaultParseOptions ()

返回此 TimeZoneFormat实例使用的默认分析选项。

getGMTOffsetDigits

String getGMTOffsetDigits ()

以升序方式返回包含从0到9的单个字符串中用于本地化GMT格式的十进制数字字符。

getGMTOffsetPattern

String getGMTOffsetPattern (TimeZoneFormat.GMTOffsetPatternType type)

返回用于本地化GMT格式的偏移模式。

getGMTPattern

String getGMTPattern ()

返回本地化的格式GMT格式。

getGMTZeroFormat

String getGMTZeroFormat ()

返回格林尼治标准时间（UTC）本地化的GMT格式字符串（GMT偏移量为0）。

getInstance

TimeZoneFormat getInstance (Locale locale)

为给定的 Locale返回一个 TimeZoneFormat的冻结实例。

注意 ：此方法返回的实例被冻结。 如果您想定制TimeZoneFormat，则必须先使用cloneAsThawed()才能获得解冻后的副本。

getInstance

TimeZoneFormat getInstance (ULocale locale)

返回给定语言环境的冻结实例 TimeZoneFormat 。

注意 ：此方法返回的实例被冻结。 如果您想自定义TimeZoneFormat，则必须先使用cloneAsThawed()才能获得解冻后的副本。

getTimeZoneNames

TimeZoneNames getTimeZoneNames ()

返回此实例使用的时区显示名称数据。

isFrozen

boolean isFrozen ()

确定对象是否被冻结。

parse

TimeZone parse (String text)

给定文本返回 TimeZone 。

注意 ：此方法的行为等同于 parse(String, ParsePosition) 。

parse

TimeZone parse (String text, 
                ParsePosition pos)

根据给定的解析位置解析时区字符串，返回 TimeZone 。

注意 ：此方法相当于 parse(Style.GENERIC_LOCATION, text, pos, EnumSet.of(ParseOption.ALL_STYLES), timeType) 。

parse

TimeZone parse (TimeZoneFormat.Style style, 
                String text, 
                ParsePosition pos, 
                Output<TimeZoneFormat.TimeType> timeType)

根据解析位置，样式和默认解析选项解析时区字符串，返回 TimeZone 。

注意 ：此方法相当于 parse(style, text, pos, null, timeType) 。

parse

TimeZone parse (TimeZoneFormat.Style style, 
                String text, 
                ParsePosition pos, 
                EnumSet<TimeZoneFormat.ParseOption> options, 
                Output<TimeZoneFormat.TimeType> timeType)

根据解析位置，样式和解析选项解析时区字符串，返回 TimeZone 。

parseObject

Object parseObject (String source, 
                ParsePosition pos)

分析字符串中的文本以生成对象。

该方法试图解析从pos给出的索引开始的文本。 如果解析成功，则在使用最后一个字符（解析不一定使用到字符串末尾的所有字符）之后，将索引pos更新为索引，并返回解析对象。 已更新的pos可用于指示下一次调用此方法的起点。 如果发生错误，则pos的索引不会更改，将错误索引pos设置为发生错误的字符的索引，并返回null。

parseOffsetISO8601

int parseOffsetISO8601 (String text, 
                ParsePosition pos)

返回给定ISO 8601基本或扩展时区字符串的GMT（UTC）（以毫秒为单位的偏移量）。 当给定字符串不是ISO 8601时区字符串时，此方法将当前位置设置为错误索引ParsePosition pos并返回0。

parseOffsetLocalizedGMT

int parseOffsetLocalizedGMT (String text, 
                ParsePosition pos)

对于给定的本地化GMT偏移格式字符串，返回GMT（UTC）以毫秒为单位的偏移量。 当给定的字符串不能被解析时，该方法将当前位置设置为错误索引ParsePosition pos并返回0。

parseOffsetShortLocalizedGMT

int parseOffsetShortLocalizedGMT (String text, 
                ParsePosition pos)

返回GMT（UTC）的偏移量，以毫秒为单位给定短的局部GMT偏移格式字符串。 当给定的字符串不能被解析时，这个方法将当前位置设置为错误索引ParsePosition pos并返回0。

setDefaultParseOptions

TimeZoneFormat setDefaultParseOptions (EnumSet<TimeZoneFormat.ParseOption> options)

设置默认分析选项。

注意：默认情况下，实例 TimeZoneFormat由{#LINK创建 getInstance(ULocale)有没有设定解析选项。

setGMTOffsetDigits

TimeZoneFormat setGMTOffsetDigits (String digits)

设置用于本地化GMT格式的十进制数字字符。

setGMTOffsetPattern

TimeZoneFormat setGMTOffsetPattern (TimeZoneFormat.GMTOffsetPatternType type, 
                String pattern)

设置给定偏移类型的偏移模式。

setGMTPattern

TimeZoneFormat setGMTPattern (String pattern)

设置本地化的GMT格式模式。 该模式必须包含单个参数{0}，例如“GMT {0}”。

setGMTZeroFormat

TimeZoneFormat setGMTZeroFormat (String gmtZeroFormat)

设置格林尼治标准时间（UTC）本地化的GMT格式字符串（GMT偏移量为0）。

setTimeZoneNames

TimeZoneFormat setTimeZoneNames (TimeZoneNames tznames)

将时区显示名称数据设置为此实例。