- dateFromString:
- stringFromDate:
+ localizedStringFromDate:dateStyle:timeStyle:
- getObjectValue:forString:range:error:
Availability 有効性
Technology
@interface NSDateFormatter : NSFormatter
Instances of NSDate
create string representations of NSDate
objects, and convert textual representations of dates and times into NSDate
objects. For user-visible representations of dates and times, NSDate
provides a variety of localized presets and configuration options. For fixed format representations of dates and times, you can specify a custom format string.
NSDate
のインスタンスは、NSDate
オブジェクトの文字列表現を作成します、そして日付と時刻のテキスト表現をNSDate
オブジェクトへ変換します。日付と時刻のユーザが見る表現に対して、NSDate
は様々なローカライズされた既定値や設定オプションを提供します。日付と時刻の固定形式の表現に対して、あなたは誂えの書式設定文字列を指定できます。
When working with date representations in ISO 8601 format, use NSISO8601Date
instead.
日付表現をISO 8601フォーマットにおいて扱う場合、NSISO8601Date
を代わりに使ってください。
To represent an interval between two NSDate
objects, use NSDate
instead.
2つのNSDate
オブジェクトの間の隔たりを表すには、NSDate
を代わりに使ってください。
To represent a quantity of time specified by an NSDate
object, use NSDate
instead.
NSDate
オブジェクトによって指定された時間量を表すには、代わりにNSDate
を使ってください。
When displaying a date to a user, you set the date
and time
properties of the date formatter according to your particular needs. For example, if you want to show the month, day, and year without showing the time, you would set the date
property to NSDate
and the time
property to NSDate
. Conversely, if you want to show only the time, you would set the date
property to NSDate
and the time
property to NSDate
. Based on the values of the date
and time
properties, NSDate
provides a representation of a specified date that is appropriate for a given locale.
日付をユーザに表示する場合、あなたは日付フォーマッタのdate
とtime
プロパティをあなたの特定の必要に応じて設定します。例えば、あなたが月、日、そして年の表示を、時間表示なしに望むならば、あなたはdate
プロパティをNSDate
に、time
プロパティをNSDate
に設定するでしょう。逆に言えば、あなたが時間だけを示すことを望むならば、あなたはdate
プロパティをNSDate
に、そしてtime
プロパティをNSDate
に設定するでしょう。date
とtime
プロパティの値に基づいて、NSDate
は指定された日付の、与えられたロケールにふさわしい表現を提供します。
If you need to define a format that cannot be achieved using the predefined styles, you can use the set
to specify a localized date format from a template.
あらかじめ定義されたスタイルを使ってアーカイブできない書式設定を定義するのをあなたが望むならば、あなたはset
を使って、ローカライズされた日付書式設定を雛形から指定します。
Important 重要
In macOS 10.12 and later or iOS 10 and later, use the NSISO8601Date
class when working with ISO 8601 date representations.
macOS 10.12以降またはiOS 10以降では、ISO 8601日付表現を扱う場合はNSISO8601Date
クラスを使ってください。
When working with fixed format dates, such as RFC 3339, you set the date
property to specify a format string. For most fixed formats, you should also set the locale
property to a POSIX locale ("en
), and set the time
property to UTC.
固定された書式設定日付を扱う場合、例えばRFC 3339など、あなたはdate
プロパティを設定して、書式設定文字列を指定します。最も固定された書式設定のために、あなたはまたlocale
プロパティをPOSIXロケール("en
)に設定すべきです、そしてtime
プロパティをUTCに設定すべきです。
For more information, see Technical Q&A QA1480 “NSDateFormatter and Internet Dates”. さらなる情報のために、Technical Q&A QA1480 “NSDateFormatter and Internet Dates”を見てください。
On iOS 7 and later NSDate
is thread safe.
iOS 7以降ではNSDate
はスレッド安全です。
In macOS 10.9 and later NSDate
is thread safe so long as you are using the modern behavior in a 64-bit app.
macOS 10.9以降ではNSDate
はスレッド安全です、あなたがモダンな挙動を64-bitアプリにおいて使っている限りは。
On earlier versions of the operating system, or when using the legacy formatter behavior or running in 32-bit in macOS, NSDate
is not thread safe, and you therefore must not mutate a date formatter simultaneously from multiple threads.
オペレーティングシステムの以前のバージョンでは、またはレガシーフォーマッタ挙動を使うまたは32-bitをmacOSで実行する場合、NSDate
はスレッド安全ではありません、そしてあなたはそのゆえに複数のスレッドから同時に日付フォーマッタを変更してはいけません。
- dateFromString:
- stringFromDate:
+ localizedStringFromDate:dateStyle:timeStyle:
- getObjectValue:forString:range:error:
dateStyle
timeStyle
dateFormat
- setLocalizedDateFormatFromTemplate:
+ dateFormatFromTemplate:options:locale:
formattingContext
calendar
defaultDate
locale
timeZone
twoDigitStartDate
gregorianStartDate
formatterBehavior
defaultFormatterBehavior
- allowsNaturalLanguage
lenient
doesRelativeDateFormatting
weekdaySymbols
shortWeekdaySymbols
veryShortWeekdaySymbols
standaloneWeekdaySymbols
shortStandaloneWeekdaySymbols
veryShortStandaloneWeekdaySymbols
monthSymbols
shortMonthSymbols
veryShortMonthSymbols
standaloneMonthSymbols
shortStandaloneMonthSymbols
veryShortStandaloneMonthSymbols
quarterSymbols
shortQuarterSymbols
standaloneQuarterSymbols
shortStandaloneQuarterSymbols
eraSymbols
longEraSymbols
- initWithDateFormat:allowNaturalLanguage:
NSDateFormatter
instance that uses the OS X 10.0 formatting behavior and the given date format string in its conversions.
あるNSDateFormatter
インスタンスを初期化して返します、それはOS X 10.0書式設定挙動とこの与えられた日付書式設定文字列をそれの変換において使用します。
generatesCalendarDates
NSDateFormatterStyle
NSDateFormatterBehavior
NSDateFormatter
should exhibit.
NSDateFormatter
が発揮すべき挙動を指定する定数。
NSDateComponentsFormatter
NSDateIntervalFormatter
NSISO8601DateFormatter