Generic Instance Method 総称体インスタンスメソッド

formatted(_:)

Generates a locale-aware string representation of a measurement using the provided measurement format style. ある寸法のロケールを意識した文字列表現をこの提供された寸法書式形式を使って生成します。

Declaration 宣言

func formatted<S>(_ style: S) -> S.FormatOutput where S : FormatStyle, S.FormatInput == Measurement<UnitType>
Available when UnitType conforms to Dimension. UnitTypeDimensionに準拠する時に利用可能。

Parameters パラメータ

style

The measurement format style to apply to the measurement. この寸法に適用する寸法書式設定スタイル。

Return Value 戻り値

A string, formatted according to the provided style. ある文字列、提供された形式により書式設定されます。

Discussion 議論

Use the formatted(_:) method to create a string representation of a measurement using a custom measurement format style. You can specify the width of the unit name, the numeric formatting of the value, and the intended usage type of the measurement. You can use the Measurement.FormatStyle static factory method measurement(width:usage:numberFormat:) to create a custom format style as a parameter to the method, such as in the following example: formatted(_:)メソッドを使って、ある寸法の文字列表現をあつらえの寸法書式設定スタイルを使って作成してください。あなたは、単位名の幅、値の数値書式設定、そしてその寸法の意図された使用法を指定できます。あなたは、Measurement.FormatStyleの静的ファクトリメソッドmeasurement(width:usage:numberFormat:)を使って、あつらえの書式設定スタイルを、メソッドへのパラメータとして作成できます、たとえば以下の例でのように:


let temp = Measurement<UnitTemperature>(value: 38, unit: .celsius)
let formattedTemp = temp.formatted(.measurement(width: .wide, usage: .weather, numberFormat: .numeric(precision: .fractionLength(1))))
// For locale: en_US: 100.4 degrees Fahrenheit

See Also 参照

Formatting a Measurement ある寸法を書式設定する