Type Method
型メソッド
dateWithNaturalLanguageString:locale:
Creates and returns a date object set to the date and time specified by a given string.
与えられた文字列によって指定される日付と時刻に設定されるある日付オブジェクトを作成して返します。
Declaration
宣言
+ (id)dateWithNaturalLanguageString:(NSString
*)string
locale:(id)locale;
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 NSDateFormatter
and Data Formatting Guide).
このメソッドは、主として英語で、ある制限された口語語句のみをサポートします。それは予想しない結果を与えるかもしれません、そしてそれの利用は強く反対されます。日付オブジェクトを文字列から作成するには、あなたは日付フォーマッタオブジェクトを代わりに使うべきです(NSDateFormatter
と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
レガシー演算
+ dateWithNaturalLanguageString:
Creates and returns a date object set to the date and time specified by a given string.
与えられた文字列によって指定される日付と時刻に設定されるある日付オブジェクトを作成して返します。
Deprecated
非推奨
+ dateWithString:
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
非推奨
- initWithString:
Returns a date object initialized with a date and time value specified by a given string in the international string representation format.
国際化文字列表現形式で与えられる文字列によって指定される日付と時刻の値で初期化される日付オブジェクトを返します。
Deprecated
非推奨
- addTimeInterval:
Returns a new date object that is set to a given number of seconds relative to the receiver.
レシーバに相対してある与えられた秒数を設定される新しい日付オブジェクトを返します。
Deprecated
非推奨
- dateWithCalendarFormat:timeZone:
Converts the receiver to a calendar date with a given format string and time zone.
レシーバをある与えられた書式設定文字列とタイムゾーンでのあるカレンダー日付へ変換します。
Deprecated
非推奨