文書 > Foundation > Dates and Times > Date > NSDate > description(withCalendarFormat:timeZone:locale:) 廃止

インスタンスメソッド

description(withCalendarFormat:timeZone:locale:)

与えられた変換指定子で指定された形式で日付の文字列表現を返します。

宣言

func description(withCalendarFormat format: String?, 
        timeZone aTimeZone: TimeZone?, 
          locale: Any?) -> String?

パラメータ

formatString	返される文字列の書式 (書式文字列の作成方法の議論については、OS X v10.0〜10.3 の日付と数値の書式を参照してください)。"％Y-％m-％d ％H:％M:％S ％z" のデフォルト書式を使用するには nil を渡して下さい。 (これは国際書式 YYYY-MM-DD HH:MM:SS±HHMM に準拠しています。)
aTimeZone	受信者を表すタイムゾーン。現在のロケールに固有のデフォルトのタイムゾーンを使用するには、nil を渡します。
localeDictionary	ロケールデータを含む NSDictionary オブジェクト。ユーザーの環境設定を使用するには、[[NSUserDefaults standardUserDefaults] dictionaryRepresentation] を使用します。 nil または NSLocale のインスタンスを渡すと、NSDate はシステムのデフォルトロケールを使用します。これは現在のユーザーのロケールとは異なります。

戻り値

指定された変換指定子で指定された書式での受信側の文字列表現。

議論

このメソッドの実装には、互換性の理由で修正できないいくつかの問題があります。日付を書式設定するには、代わりに日付フォーマッタオブジェクトを使用する必要があります (DateFormatter および データ書式ガイド を参照して下さい)。

このメソッドを使用すると、現在の時刻を次のように出力できます。

sprintf(aString, "The current time is %s\n", [[[NSDate  date]
    descriptionWithCalendarFormat:@"%H:%M:%S %Z" timeZone:nil
    locale:[[NSUserDefaults standardUserDefaults] dictionaryRepresentation]]
        UTF8String]);