Type Method 型メソッド

date(withNaturalLanguageString:locale:)

Creates and returns a date object set to the date and time specified by a given string. 与えられた文字列によって指定される日付と時刻に設定されるある日付オブジェクトを作成して返します。

Declaration 宣言 

class func date(withNaturalLanguageString string: String, 
         locale: Any?) -> Any?

Parameters パラメータ

string

A string that contains a colloquial specification of a date, such as “last Tuesday at dinner,” “3pm December 31, 2001,” “12/31/01,” or “31/12/01.” ある文字列、それは日付の口語仕様を含みます、例えば “last Tuesday at dinner”、“3pm December 31, 2001”、“12/31/01” または “31/12/01”など。

localeDictionary

An NSDictionary object containing locale data. To use the user's preferences, you can use [[NSUserDefaults standardUserDefaults] dictionaryRepresentation]. ローカルデータを含んでいるNSDictionary。ユーザの環境設定を使うために、あなたは[[NSUserDefaults standardUserDefaults] dictionaryRepresentation]を使うことができます。

If you pass nil or an instance of NSLocale, NSDate uses the system default locale—this is not the same as the current user's locale. あなたがnilまたはNSLocaleのインスタンスを渡すならば、NSDateはシステム初期設定のロケールを使います — これは現在のユーザのロケールと同じではありません。

Return Value 戻り値

A new NSDate object set to the date and time specified by string as interpreted according to localeDictionary. ある新しいNSDateオブジェクト、stringによって指定される日付と時刻に設定されます、localeDictionaryによって解釈された通りに。

Discussion 議論

This method supports only a limited set of colloquial phrases, primarily in English. It may give unexpected results, and its use is strongly discouraged. To create a date object from a string, you should use a date formatter object instead (see DateFormatter and Data Formatting Guide). このメソッドは、主として英語で、ある制限された口語語句のみをサポートします。それは予想しない結果を与えるかもしれません、そしてそれの利用は強く反対されます。日付オブジェクトを文字列から作成するには、あなたは日付フォーマッタオブジェクトを代わりに使うべきです（DateFormatterとData Formatting Guideを見てください）。

The keys and values that represent the locale data from localeDictionary are used when parsing the string. In addition to the locale keys listed in the class description, these keys are used when parsing natural language strings: localeDictionaryからのロケールデータを表すキーと値が文字列を構文解析する時に使われます。クラス記述において一覧にされるロケールキーに加えて、これらのキーが自然言語文字列を構文解析する時に使われます：

  • NSDateTimeOrdering

  • NSEarlierTimeDesignations

  • NSHourNameDesignations

  • NSLaterTimeDesignations

  • NSNextDayDesignations

  • NSNextNextDayDesignations

  • NSPriorDayDesignations

  • NSThisDayDesignations

  • NSYearMonthWeekDesignations

See Also 参照

Legacy Operations レガシー演算

class func date(withNaturalLanguageString: String) -> Any?
Creates and returns a date object set to the date and time specified by a given string. 与えられた文字列によって指定される日付と時刻に設定されるある日付オブジェクトを作成して返します。
Deprecated 非推奨
class func date(with: String) -> Any
Creates and returns a date object with a date and time value specified by a given string in the international string representation format (YYYY-MM-DD HH:MM:SS ±HHMM). 国際化文字列表現形式（YYYY-MM-DD HH:MM:SS ±HHMM）で与えられる文字列によって指定される日付と時刻の値で日付オブジェクトを作成して返します。
Deprecated 非推奨
init?(string: String)
Returns a date object initialized with a date and time value specified by a given string in the international string representation format. 国際化文字列表現形式で与えられる文字列によって指定される日付と時刻の値で初期化される日付オブジェクトを返します。
Deprecated 非推奨
func addTimeInterval(TimeInterval) -> Any
Returns a new date object that is set to a given number of seconds relative to the receiver. レシーバに相対してある与えられた秒数を設定される新しい日付オブジェクトを返します。
Deprecated 非推奨
func date(withCalendarFormat: String?, timeZone: TimeZone?) -> NSCalendarDate
Converts the receiver to a calendar date with a given format string and time zone. レシーバをある与えられた書式設定文字列とタイムゾーンでのあるカレンダー日付へ変換します。
Deprecated 非推奨
func description(withCalendarFormat: String?, timeZone: TimeZone?, locale: Any?) -> String?
Returns a string representation of the date formatted as specified by given conversion specifiers. 与えられた変換指定子によって書式設定される日付の文字列表現を返します。
Deprecated 非推奨