程序包 ohos.global.i18n.text

类 MeasureFormatter

java.lang.Object

ohos.global.i18n.text.MeasureFormatter

public abstract class MeasureFormatter
extends Object

Provides methods for formatting weights and measures.

从以下版本开始:

5

构造器概要

构造器

构造器	说明
MeasureFormatter()

方法概要

限定符和类型	方法	说明
abstract String	format(MeasureOptions.Unit unit, double value, MeasureOptions.FormatStyle formatStyle)	Formats weights and measures based on the specified unit, value, and formatting style.
abstract String	format(MeasureOptions.Unit fromUnit, double value, MeasureOptions.Unit toUnit, MeasureOptions.FormatStyle formatStyle)	Converts the source unit to the target unit and formats the target unit according to the specified formatting style.
abstract String	format(MeasureOptions.Unit unit, double value, MeasureOptions.Usage usage, MeasureOptions.FormatStyle formatStyle, MeasureOptions.Style style)	Selects a preferred unit in the specified application scenario based on the locale of the MeasureFormatter object and formats the preferred unit according to the specified formatting style.
static MeasureFormatter	getInstance()	Creates a MeasureFormatter instance with the current locale.
static MeasureFormatter	getInstance(Locale locale)	Creates a MeasureFormatter instance with a specified locale.
abstract void	setFractionPrecision(int value)	Sets the precision of the fraction in the number displayed in the formatted string.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

MeasureFormatter

public MeasureFormatter()

方法详细资料

getInstance

public static MeasureFormatter getInstance()

Creates a MeasureFormatter instance with the current locale.

返回:

Returns the MeasureFormatter instance.

从以下版本开始:

5

getInstance

public static MeasureFormatter getInstance(Locale locale)

Creates a MeasureFormatter instance with a specified locale.

参数:

locale - Indicates the specified locale.

返回:

Returns the MeasureFormatter instance.

从以下版本开始:

5

setFractionPrecision

public abstract void setFractionPrecision(int value)

Sets the precision of the fraction in the number displayed in the formatted string.

参数:

value - Indicates the precision of the fraction.

从以下版本开始:

5

format

public abstract String format(MeasureOptions.Unit unit,
                              double value,
                              MeasureOptions.FormatStyle formatStyle)

Formats weights and measures based on the specified unit, value, and formatting style.

参数:

unit - Indicates the specified unit.

value - Indicates the value of the unit.

formatStyle - Indicates the formatting style.

返回:

Returns a string representation of the formatted weights and measures.

从以下版本开始:

5

format

public abstract String format(MeasureOptions.Unit unit,
                              double value,
                              MeasureOptions.Usage usage,
                              MeasureOptions.FormatStyle formatStyle,
                              MeasureOptions.Style style)
                       throws NotSupportConvertException

Selects a preferred unit in the specified application scenario based on the locale of the MeasureFormatter object and formats the preferred unit according to the specified formatting style.

If there are multiple preferred units, the style parameter determines whether to automatically select a proper one. The value of the input unit is then converted to that of the preferred unit.

参数:

unit - Indicates the input unit.

value - Indicates the value of the unit.

usage - Indicates the application scenario of the unit.

formatStyle - Indicates the formatting style.

style - Specifies whether to automatically select a proper unit.

返回:

Returns the string representation of the formatted preferred unit.

抛出:

NotSupportConvertException - Throws this exception if any input parameter is invalid.

从以下版本开始:

5

format

public abstract String format(MeasureOptions.Unit fromUnit,
                              double value,
                              MeasureOptions.Unit toUnit,
                              MeasureOptions.FormatStyle formatStyle)
                       throws NotSupportConvertException

Converts the source unit to the target unit and formats the target unit according to the specified formatting style.

参数:

fromUnit - Indicates the source unit.

value - Indicates the value of the source unit.

toUnit - Indicates the target unit.

formatStyle - Indicates the formatting style.

返回:

Returns a string representation of the formatted target unit.

抛出:

NotSupportConvertException - Throws this exception if the source unit cannot be converted to the target unit.

从以下版本开始:

5