Measurement.FormatStyle

Overview 概要

A measurement format style creates human-readable text from a Measurement. You can customize the formatting behavior of the format style using the width, numberFormat, usage, and locale properties. The system automatically caches unique configurations of Measurement.FormatStyle to enhance performance. 寸法書式設定スタイルは、人に読みやすいテキストをあるMeasurementから作成します。あなたは、書式設定スタイルの書式設定挙動をwidth、numberFormat、usage、そしてlocaleプロパティを使ってカスタマイズできます。システムは、自動的にMeasurement.FormatStyleの固有な構成設定それらをキャッシュすることで性能を高めます。

Use either the formatted() or the formatted(_:) instance method of Measurement to create a string representation of a measurement. Measurementのformatted()またはformatted(_:)インスタンスメソッドどちらかを使って、ある寸法の文字列表現を作成してください。

The formatted() method generates a string using the default measurement format style. formatted()メソッドは、ある文字列を省略時の寸法書式設定スタイルを使って生成します。

let temperature = Measurement<UnitTemperature>(value: 38, unit: .celsius)
temperature.formatted()
// For locale: en_US: 100°F
// For locale: fr_FR: 38°C

The default format style in the previous example abbreviates the measurement unit. To customize any of the properties of the formatted measurement, you provide a measurement format style to the formatted(_:) method. For example, to create a string with the full name of the unit, the code might resemble the following: 前の例での省略時書式設定スタイルは、寸法単位を省略形にしています。書式設定された寸法のプロパティのどれかをカスタマイズするには、あなたはある寸法書式設定スタイルをformatted(_:)メソッドに提供します。例として、ある文字列を単位の完全な名前で作成するには、そのコードは以下のようになるかもしれません：

temperature.formatted(.measurement(width: .wide))
// For locale: en_US: 100 degrees Fahrenheit
// For locale: fr_FR: 38 degrés Celsius

The previous example uses a static factory method to create a measurement format style within the call to the formatted(_:) method. You can also create a measurement format style and pass it to the method, such as in the following example: 前の例は、静的ファクトリメソッドを使って寸法書式設定スタイルをformatted(_:)メソッドへの呼び出し内で作成します。あなたはまた、ある寸法書式設定スタイルを作成して、そしてそれをメソッドに渡すことができます、たとえば以下の例でのように：

let distance = Measurement<UnitLength>(value: 36, unit: .miles)
let distanceStyle = Measurement<UnitLength>.FormatStyle(width: .wide, usage: .road)
distanceStyle.format(distance)
// for locale: en_US: 36 miles
// for locale: fr_FR: 58 kilomètres

After you create an instance of a format style, you can use it to format measurements of the same unit type. あなたが書式設定スタイルのあるインスタンスを作成した後、あなたはそれを使って同じ単位型の寸法を書式設定できます。