Class

DateIntervalFormatter

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

Declaration 宣言

class DateIntervalFormatter : Formatter

Overview 概要

A DateIntervalFormatter object creates user-readable strings from pairs of dates. Use a date interval formatter to create user-readable strings of the form <start> - <end> for your app’s interface, where <start> and <end> are date values that you supply. The formatter uses locale and language information, along with custom formatting options, to define the content of the resulting string. You can specify different styles for the date and time information in each date value. DateIntervalFormatterオブジェクトは、ユーザが読むことができる文字列を一組の日付から作成します。日付間隔フォーマッタを使って、形式<start> - <end>のユーザが読むことができる文字列をあなたのアプリのインターフェイスのために作成してください、そこで<start><end>はあなたが提供する日付値です。フォーマッタは、ロケールと言語情報、それだけでなくあつらえの書式設定オプションも使って、結果文字列の内容を定義します。あなたは、各日付値において日付と時刻情報に対して異なるスタイルを指定できます。

To use this class, create an instance, configure its properties, and call the string(from:to:) method to generate a string. The properties of this class let you configure the calendar and specify the style to apply to date and time values. Given a current date of January 16, 2015, Configuring the Formatter Options shows how to configure a formatter object and generate the string “1/16/15 - 1/17/15”. このクラスを使うには、1つのインスタンスを作成して、それのプロパティを構成設定します、そしてstring(from:to:)メソッドを呼び出すことで文字列を生成してください。このクラスのそれらプロパティは、あなたにカレンダーを構成設定させて、日付と時刻値に適用するスタイルを指定させます。January 16, 2015の現在の日付を与えられて、フォーマッタオプションを構成設定するは、フォーマッタオブジェクトを構成設定する、そして文字列 “1/16/15 - 1/17/15” を生成する方法を示します。

Listing 1 Configuring a formatter object コード出力 1 フォーマッタオブジェクトの構成設定

let formatter = DateIntervalFormatter()
formatter.dateStyle = .short
formatter.timeStyle = .none


// Create two dates that are exactly 1 day apart.
let startDate = Date()
let endDate = Date(timeInterval: 86400, since: startDate)


// Use the configured formatter to generate the string.
let outputString = formatter.string(from: startDate, to: endDate)

The string(from:to:) method may be called safely from any thread of your app. It is also safe to share a single instance of this class from multiple threads, with the caveat that you should not change the configuration of the object while another thread is using it to generate a string. string(from:to:)メソッドは、あなたのアプリのあらゆるスレッドから安全に呼び出されるかもしれません。またこのクラスの単一のインスタンスを複数のスレッドから共有するのは、あなたがそのオブジェクトの構成設定を別のスレッドがそれを文字列生成のために使っている間に変更すべきでないのを警告することで、同様に安全です。

Topics 話題

Formatting a String 文字列を書式設定する

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

Constants 定数

Instance Methods インスタンス メソッド

Relationships 関係

Inherits From 継承元

See Also 参照

Date Formatting 日付を書式設定する