Data Formatting データ書式設定

Convert numbers, dates, measurements, and other values to and from locale-aware string representations. 数字、日付、寸法、および他の値をロケール対応文字列表現へと、そしてそれから変換します。

Overview 概要

Foundation supports two approaches for data formatting: Foundationは、２つの取り組みをデータ書式設定に対してサポートします：

When working in Swift, use formatted methods directly on the types you want to format, optionally using FormatStyle and its subtypes to customize formatter output. This approach supports dates, integers, floating-point numbers, measurements, sequences, and person name components. Foundation caches identically-configured formatter instances internally, allowing you to focus on your app’s formatting needs. Swiftにおいて作業する場合、formattedメソッドをあなたが書式設定したい型の上で直接に使用します、随意にFormatStyleとそれの下位型を使ってフォーマッタ出力をカスタマイズしてください。この取り組みは、日付、整数、浮動小数点数、寸法、シーケンス、そして個人名構成要素をサポートします。Foundationは、同一的に構成設定されたフォーマッタインスタンスを内部的にキャッシュして、あなたをあなたのアプリのもつ書式設定需要に集中させます。
In Objective-C, create instances of Formatter and its subtypes, and use the string(for:) method to convert objects to formatted strings.

Topics 話題

Essentials 要点

Building a Localized Food-Ordering App ローカライズされたFood-Orderingアプリを構築する

Format, style, and localize your app’s text for use in multiple languages with string formatting, attributed strings, and automatic grammar agreement. あなたのアプリのテキストを複数の言語で使用するために、書式設定して、体裁を整えて、そしてローカライズしてください、文字列書式設定、属性付き文字列、そして自動文法一致を使って。

Displaying Human-Friendly Content 人にやさしい内容を表示する

Convert data into readable strings or Swift objects using formatters. テータを読出可能文字列またはSwiftオブジェクトへとフォーマッタを使って変換します。

Numbers and Currency 数値と通貨

class NumberFormatter

A formatter that converts between numeric values and their textual representations. 数値とそれらのテキスト表現の間で変換するフォーマッタ。

Names さまざまな名前

class PersonNameComponentsFormatter

A formatter that provides localized representations of the components of a person’s name. ある個人の名前の構成要素のローカライズされた表現を提供するフォーマッタ。

struct PersonNameComponents

The separate parts of a person's name, allowing locale-aware formatting. ある個人の名前の個々の部分、ロケール対応の書式設定を可能にします。

Dates and Times 日付と時刻

class DateFormatter

A formatter that converts between dates and their textual representations. 日付とそれらのテキスト表現の間で変換をするフォーマッタ。

class DateComponentsFormatter

A formatter that creates string representations of quantities of time. 一定量の時間の文字列表現を作成するフォーマッタ。

class RelativeDateTimeFormatter

A formatter that creates locale-aware string representations of a relative date or time. 相対日付または時刻のロケール対応文字列表現を作成するフォーマッタ。

class DateIntervalFormatter

A formatter that creates string representations of time intervals. 時間間隔の文字列表現を作成するフォーマッタ。

class ISO8601DateFormatter

A formatter that converts between dates and their ISO 8601 string representations. 日付とそれらのISO 8601文字列表現の間で変換をするフォーマッタ。

Data Sizes データサイズ

class ByteCountFormatter

A formatter that converts a byte count value into a localized description that is formatted with the appropriate byte modifier (KB, MB, GB and so on). あるフォーマッタ、それは、バイト計数値をローカライズされた記述へ変換します、それは適切なバイト修飾子（KB、MB、GBなど）で書式化されます。

Measurements 寸法

class MeasurementFormatter

A formatter that provides localized representations of units and measurements. 単位と寸法のローカライズされた表現を提供するフォーマッタ。

Lists

class ListFormatter

An object that provides locale-correct formatting of a list of items using the appropriate separator and conjunction. あるオブジェクト、それはいくつかの項目からなるあるリストのロケール的に正しい書式設定を適切な分離子と接続詞を使用して提供します。

Internationalization 国際化

struct Locale

Information about linguistic, cultural, and technological conventions for use in formatting data for presentation. 提示用にデータの体裁を整えるのに使う言語的、文化的、そして技術的な慣行についての情報。

Custom Formatters あつらえのフォーマッタ

class Formatter

An abstract class that declares an interface for objects that create, interpret, and validate the textual representation of values. 値のテキスト表現を作成、解釈、そして確認するオブジェクトへのインターフェイスを宣言する抽象クラス。

Data Formatting in Swift Swiftでのデータ書式設定

protocol FormatStyle

struct FormatStyleCapitalizationContext

The capitalization formatting context used when formatting dates and times. 日付と時刻を書式設定する時に使われる、キャピタライズの書式設定文脈。

struct IntegerFormatStyle

struct FloatingPointFormatStyle

struct ListFormatStyle

A type used to format lists of items with a separator and conjunction appropriate for a given locale. 項目いくつかからなるリストそれらをある与えられたロケールに適した区切りと接続詞で書式設定するために使われるある型。

struct StringStyle

Format Style Configurations 書式設定スタイル構成設定

Collections of behaviors for traits like numeric precision, rounding, and scale, used for formatting and parsing numeric values. 数値精度、丸め、そして記数法のような特徴に対する挙動のコレクション、数値を書式設定および構文解析するために使われます。

Data Parsing in Swift Swiftにおけるデータ構文解析

protocol ParseableFormatStyle

A type that can convert a given input data type into a representation in an output type. ある型、それは与えられた入力データ型をある出力型における表現へと変換できるものです。

protocol ParseStrategy

struct FloatingPointParseStrategy

Automatic Grammar Agreement 自動文法一致

enum InflectionRule

A rule that affects how an attributed string performs automatic grammatical agreement. ある規則、それはどのようにある属性付き文字列が自動文法一致を実行するかに影響します。

struct Morphology

A description of the grammatical properties of a string. ある文字列の文法的プロパティそれらのある記述。

Deprecated 非推奨

class LengthFormatter

A formatter that provides localized descriptions of linear distances, such as length and height measurements. 直線距離、例えば長さおよび高さ寸法のローカライズされた記述を提供するフォーマッタ。

class MassFormatter

A formatter that provides localized descriptions of mass and weight values. ローカライズされた容積および重量値の記述を提供するフォーマッタ。

class EnergyFormatter

A formatter that provides localized descriptions of energy values. ローカライズされたエネルギー値の記述を提供するフォーマッタ。