Instance Property インスタンスプロパティ

maximumUnitCount

The maximum number of time units to include in the output string. 出力文字列に含める最大の時間単位数。

Declaration 宣言 

var maximumUnitCount: Int { get set }

Discussion 議論

Use this property to limit the number of units displayed in the resulting string. For example, with this property set to 2, instead of “1h 10m, 30s”, the resulting string would be “1h 10m”. Use this property when you are constrained for space or want to round up values to the nearest large unit. このプロパティを使って、結果文字列で表示される単位の数を制限してください。例えば、このプロパティを２に設定すると、“1h 10m, 30s” の代わりに、結果文字列は “1h 10m” になるでしょう。あなたが空間的に窮屈であるまたは値を最も近い大きな単位に切り上げたい場合に、このプロパティを使ってください。

The default value of this property is 0, which does not cause the elimination of any units. このプロパティの省略時の値は0、それはどんな単位の排除も引き起こしません。

See Also 参照

Configuring the Formatter Options フォーマッタオプションを構成設定する

var allowedUnits: NSCalendar.Unit
The bitmask of calendrical units such as day and month to include in the output string. 出力文字列に含まれる日にちと月のような、様々なカレンダー単位のビットマスク。
var allowsFractionalUnits: Bool
A Boolean indicating whether non-integer units may be used for values. 非整数単位が値として使われるかもしれないかどうかを指し示すブール値。
var calendar: Calendar?
The default calendar to use when formatting date components. 日付構成要素を書式設定するときに使う省略時のカレンダー。
var collapsesLargestUnit: Bool
A Boolean value indicating whether to collapse the largest unit into smaller units when a certain threshold is met. 特定の閾値に達する場合に最も大きい単位をより小さい単位へ折りたたむかどうかを指し示すブール値。
var includesApproximationPhrase: Bool
A Boolean value indicating whether the resulting phrase reflects an inexact time value. 結果の語句が正確でない時間値を再現するかどうかを指し示すブール値。
var includesTimeRemainingPhrase: Bool
A Boolean value indicating whether output strings reflect the amount of time remaining. 出力文字列が残りの時間量を再現するかどうかを指し示すブール値。
var unitsStyle: DateComponentsFormatter.UnitsStyle
The formatting style for unit names. 単位名に対する書式設定スタイル。
var zeroFormattingBehavior: DateComponentsFormatter.ZeroFormattingBehavior
The formatting style for units whose value is 0. 値がゼロである単位に対する書式設定スタイル。