NSDateFormatter

Overview 概要

Instances of NSDateFormatter 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, NSDateFormatter provides a variety of localized presets and configuration options. For fixed format representations of dates and times, you can specify a custom format string. NSDateFormatterのインスタンスは、NSDateオブジェクトの文字列表現を作成します、そして日付と時刻のテキスト表現をNSDateオブジェクトへ変換します。日付と時刻のユーザが見る表現に対して、NSDateFormatterは様々なローカライズされた既定値や設定オプションを提供します。日付と時刻の固定形式の表現に対して、あなたは誂えの書式設定文字列を指定できます。

When working with date representations in ISO 8601 format, use NSISO8601DateFormatter instead. 日付表現をISO 8601フォーマットにおいて扱う場合、NSISO8601DateFormatterを代わりに使ってください。

To represent an interval between two NSDate objects, use NSDateIntervalFormatter instead. ２つのNSDateオブジェクトの間の隔たりを表すには、NSDateIntervalFormatterを代わりに使ってください。

To represent a quantity of time specified by an NSDateComponents object, use NSDateComponentsFormatter instead. NSDateComponentsオブジェクトによって指定された時間量を表すには、代わりにNSDateComponentsFormatterを使ってください。

Working With User-Visible Representations of Dates and Times ユーザが見ることができる日付と時刻の表現を扱う

When displaying a date to a user, you set the dateStyle and timeStyle 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 dateStyle property to NSDateFormatterLongStyle and the timeStyle property to NSDateFormatterNoStyle. Conversely, if you want to show only the time, you would set the dateStyle property to NSDateFormatterNoStyle and the timeStyle property to NSDateFormatterShortStyle. Based on the values of the dateStyle and timeStyle properties, NSDateFormatter provides a representation of a specified date that is appropriate for a given locale. 日付をユーザに表示する場合、あなたは日付フォーマッタのdateStyleとtimeStyleプロパティをあなたの特定の必要に応じて設定します。例えば、あなたが月、日、そして年の表示を、時間表示なしに望むならば、あなたはdateStyleプロパティをNSDateFormatterLongStyleに、timeStyleプロパティをNSDateFormatterNoStyleに設定するでしょう。逆に言えば、あなたが時間だけを示すことを望むならば、あなたはdateStyleプロパティをNSDateFormatterNoStyleに、そしてtimeStyleプロパティをNSDateFormatterShortStyleに設定するでしょう。dateStyleとtimeStyleプロパティの値に基づいて、NSDateFormatterは指定された日付の、与えられたロケールにふさわしい表現を提供します。

NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
dateFormatter.dateStyle = NSDateFormatterMediumStyle;
dateFormatter.timeStyle = NSDateFormatterNoStyle;
 
NSDate *date = [NSDate dateWithTimeIntervalSinceReferenceDate:118800];
 
// US English Locale (en_US)
dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
NSLog(@"%@", [dateFormatter stringFromDate:date]); // Jan 2, 2001
 
// French Locale (fr_FR)
dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"fr_FR"];
NSLog(@"%@", [dateFormatter stringFromDate:date]); // 2 janv. 2001
 
// Japanese Locale (ja_JP)
dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"ja_JP"];
NSLog(@"%@", [dateFormatter stringFromDate:date]); // 2001/01/02

If you need to define a format that cannot be achieved using the predefined styles, you can use the setLocalizedDateFormatFromTemplate: to specify a localized date format from a template. あらかじめ定義されたスタイルを使ってアーカイブできない書式設定を定義するのをあなたが望むならば、あなたはsetLocalizedDateFormatFromTemplate:を使って、ローカライズされた日付書式設定を雛形から指定します。

NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
NSDate *date = [NSDate dateWithTimeIntervalSinceReferenceDate:410220000];
 
// US English Locale (en_US)
dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
[dateFormatter setLocalizedDateFormatFromTemplate:@"MMMMd"]; // set template after setting locale
NSLog(@"%@", [dateFormatter stringFromDate:date]); // December 31
 
// British English Locale (en_GB)
dateFormatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_GB"];
[dateFormatter setLocalizedDateFormatFromTemplate:@"MMMMd"]; // set template after setting locale
NSLog(@"%@", [dateFormatter stringFromDate:date]); // 31 December

Working With Fixed Format Date Representations 固定された書式設定日付表現を扱う

When working with fixed format dates, such as RFC 3339, you set the dateFormat property to specify a format string. For most fixed formats, you should also set the locale property to a POSIX locale ("en_US_POSIX"), and set the timeZone property to UTC. 固定された書式設定日付を扱う場合、例えばRFC 3339など、あなたはdateFormatプロパティを設定して、書式設定文字列を指定します。最も固定された書式設定のために、あなたはまたlocaleプロパティをPOSIXロケール（"en_US_POSIX"）に設定すべきです、そしてtimeZoneプロパティをUTCに設定すべきです。

RFC3339DateFormatter = [[NSDateFormatter alloc] init];
RFC3339DateFormatter.locale = [NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"];
RFC3339DateFormatter.dateFormat = @"yyyy-MM-dd'T'HH:mm:ssZZZZZ";
RFC3339DateFormatter.timeZone = [NSTimeZone timeZoneForSecondsFromGMT:0];
 
/* 39 minutes and 57 seconds after the 16th hour of December 19th, 1996 with an offset of -08:00 from UTC (Pacific Standard Time) */
NSString *string = @"1996-12-19T16:39:57-08:00";
NSDate *date = [RFC3339DateFormatter dateFromString:string];

For more information, see Technical Q&A QA1480 “NSDateFormatter and Internet Dates”. さらなる情報のために、Technical Q&A QA1480 “NSDateFormatter and Internet Dates”を見てください。

Thread Safety スレッド安全

On iOS 7 and later NSDateFormatter is thread safe. iOS 7以降ではNSDateFormatterはスレッド安全です。

In macOS 10.9 and later NSDateFormatter is thread safe so long as you are using the modern behavior in a 64-bit app. macOS 10.9以降ではNSDateFormatterはスレッド安全です、あなたがモダンな挙動を64-bitアプリにおいて使っている限りは。

On earlier versions of the operating system, or when using the legacy formatter behavior or running in 32-bit in macOS, NSDateFormatter is not thread safe, and you therefore must not mutate a date formatter simultaneously from multiple threads. オペレーティングシステムの以前のバージョンでは、またはレガシーフォーマッタ挙動を使うまたは32-bitをmacOSで実行する場合、NSDateFormatterはスレッド安全ではありません、そしてあなたはそのゆえに複数のスレッドから同時に日付フォーマッタを変更してはいけません。