Class

NSDate

A representation of a specific point in time, independent of any calendar or time zone. あらゆるカレンダーまたはタイムゾーンに影響を受けない、ある特定の時点のある表現。

Declaration 宣言

@interface NSDate : NSObject

Overview 概要

NSDate objects encapsulate a single point in time, independent of any particular calendrical system or time zone. Date objects are immutable, representing an invariant time interval relative to an absolute reference date (00:00:00 UTC on 1 January 2001). NSDateオブジェクトは、あらゆる特定の暦体系またはタイムゾーンから独立して、時間の中のある一点をカプセル化します。Dateオブジェクトは不変です、ある変化しない時間間隔を、絶対基準日(2001 January 1 での 00:00:00 UTC)に相対して表します。

The NSDate class provides methods for comparing dates, calculating the time interval between two dates, and creating a new date from a time interval relative to another date. NSDate objects can be used in conjunction with NSDateFormatter objects to create localized representations of dates and times, as well as with NSCalendar objects to perform calendar arithmetic. NSDateクラスは、日付の比較、2つの日付の間の時間の隔たりの計算、そして別の日付と相対的にある時間の隔たりから新しい日付を作成することに対してメソッドを提供します。NSDateオブジェクトは、日付と時刻のローカライズされた表現を作成するためにNSDateFormatterオブジェクトと、それだけでなくカレンダー算術を実行するためにNSCalendarオブジェクトと協力して使用できます。

NSDate is toll-free bridged with its Core Foundation counterpart, CFDateRef. See Toll-Free Bridging for more information on toll-free bridging. NSDateは、それのCore Foundation相当物CFDateRefトールフリーブリッジ(通行料無料の橋渡し)されます。トールフリーブリッジに関する更なる情報としてtoll-free bridgingを見てください。

Subclassing Notes サブクラス作成の注意

You might subclass NSDate in order to make it easier to work with a particular calendrical system, or to work with date and time values with a finer temporal granularity. あなたはNSDateのサブクラスの作成を行うかもしれません、それは特定のカレンダー関連システムを扱うのを、または日付と時刻の値を詳細な時間粒度で扱うのを、より簡単にするためにです。

Methods to Override and Other Requirements オーバーライドするメソッドと他の要件

If you want to subclass NSDate to obtain behavior different than that provided by the private or public subclasses, you must: あなたがNSDateのサブクラスを作ってプライベートまたはパブリックなサブクラスによって提供されるものとは異なる挙動を獲得したいならば、あなたは次をしなければなりません:

  • Declare a suitable instance variable to hold the date and time value (relative to an absolute reference date) 適切なインスタンス変数を宣言して日付と時刻の値を保持してください(ある絶対基準日に相対的に)

  • Override the timeIntervalSinceReferenceDate instance method to provide the correct date and time value based on your instance variable timeIntervalSinceReferenceDateインスタンスメソッドをオーバーライドして正確な日付と時刻をあなたのインスタンス変数に基づいて提供してください

  • Override initWithTimeIntervalSinceReferenceDate:, one of the designated initializer methods 指定イニシャライザメソッドの1つ、initWithTimeIntervalSinceReferenceDate:をオーバーライドしてください

  • If creating a subclass that represents a calendrical system, define methods that partition past and future periods into the units of this calendar あるカレンダー関連システムを表すサブクラスを作成するならば、過去と未来の期間をこのカレンダーの単位へと分割するメソッドを定義してください

  • Implement the methods required by the NSCopying and NSCoding protocols, because NSDate adopts these protocols NSCopyingNSCodingプロトコルによって必要とされるメソッドを実装してください、なぜならNSDateはこれらのプロトコルを採用するからです

Special Considerations 特別な注意事項

Your subclass may use a different reference date than the absolute reference date used by NSDate (00:00:00 UTC on 1 January 2001). If it does, it must still use the absolute reference date in its implementations of the methods timeIntervalSinceReferenceDate and initWithTimeIntervalSinceReferenceDate:. That is, the reference date referred to in the titles of these methods is the absolute reference date. If you do not use the absolute reference date in these methods, comparisons between NSDate objects of your subclass and NSDate objects of a private subclass will not work. あなたのサブクラスは、NSDateによって使われる絶対基準日(1 January 2001 での 00:00:00 UTC)とは違う基準日を使うかもしれません。たとえそうしても、それは依然として絶対基準日をメソッドtimeIntervalSinceReferenceDateinitWithTimeIntervalSinceReferenceDate:のそれの実装において使わなければなりません。すなわち、これらのメソッドのタイトルにおいて参照される基準日は、絶対基準日です。あなたが絶対基準日をこれらのメソッドにおいて使わないならば、あなたのサブクラスのNSDateオブジェクトとあるプライベートなサブクラスのNSDateオブジェクトの間の比較は、機能しません。

Topics 話題

Creating a Date 日付の作成

Initializing a Date 日付を初期化する

Getting Temporal Boundaries 時間的な境界を得る

Retrieving the Current Date 現在の日付を取ってくる

Comparing Dates 日付を比較する

Getting Time Intervals 時間の隔たりを得る

Adding Time Intervals 時間間隔の加算

Describing Dates 日付を記述する

Recognizing Notifications 通知を認識する

Legacy Operations レガシー演算

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

Date Representations 日付表現