+ date
+ dateWithTimeIntervalSinceNow:
+ dateWithTimeInterval:sinceDate:
+ dateWithTimeIntervalSinceReferenceDate:
+ dateWithTimeIntervalSince1970:
Availability 有効性
Technology
@interface NSDate : NSObject
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 NSDate
objects to create localized representations of dates and times, as well as with NSCalendar
objects to perform calendar arithmetic.
NSDate
クラスは、日付の比較、2つの日付の間の時間の隔たりの計算、そして別の日付と相対的にある時間の隔たりから新しい日付を作成することに対してメソッドを提供します。NSDate
オブジェクトは、日付と時刻のローカライズされた表現を作成するためにNSDate
オブジェクトと、それだけでなくカレンダー算術を実行するためにNSCalendar
オブジェクトと協力して使用できます。
NSDate
is toll-free bridged with its Core Foundation counterpart, CFDate
. See Toll-Free Bridging for more information on toll-free bridging.
NSDate
は、それのCore Foundation相当物CFDate
とトールフリーブリッジ(通行料無料の橋渡し)されます。トールフリーブリッジに関する更なる情報としてtoll-free bridgingを見てください。
Important 重要
The Swift overlay to the Foundation framework provides the Date
structure, which bridges to the NSDate
class. For more information about value types, see Working with Cocoa Frameworks in Using Swift with Cocoa and Objective-C (Swift 4.1).
Foundationフレームワークに対するSwiftオーバーレイは、Date
構造体を提供します、それはNSDate
クラスへとブリッジします。値型についてのさらなる情報として、Working with Cocoa FrameworksをUsing Swift with Cocoa and Objective-C (Swift 4.1)で見てください。
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
のサブクラスの作成を行うかもしれません、それは特定のカレンダー関連システムを扱うのを、または日付と時刻の値を詳細な時間粒度で扱うのを、より簡単にするためにです。
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 time
instance method to provide the correct date and time value based on your instance variable
time
インスタンスメソッドをオーバーライドして正確な日付と時刻をあなたのインスタンス変数に基づいて提供してください
Override init
, one of the designated initializer methods
指定イニシャライザメソッドの1つ、init
をオーバーライドしてください
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
NSCopying
とNSCodingプロトコルによって必要とされるメソッドを実装してください、なぜならNSDate
はこれらのプロトコルを採用するからです
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 time
and init
. 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)とは違う基準日を使うかもしれません。たとえそうしても、それは依然として絶対基準日をメソッドtime
とinit
のそれの実装において使わなければなりません。すなわち、これらのメソッドのタイトルにおいて参照される基準日は、絶対基準日です。あなたが絶対基準日をこれらのメソッドにおいて使わないならば、あなたのサブクラスのNSDate
オブジェクトとあるプライベートなサブクラスのNSDate
オブジェクトの間の比較は、機能しません。
+ date
+ dateWithTimeIntervalSinceNow:
+ dateWithTimeInterval:sinceDate:
+ dateWithTimeIntervalSinceReferenceDate:
+ dateWithTimeIntervalSince1970:
- init
- initWithTimeIntervalSinceNow:
- initWithTimeInterval:sinceDate:
- initWithTimeIntervalSinceReferenceDate:
- initWithTimeIntervalSince1970:
- initWithCoder:
distantFuture
distantPast
now
- isEqualToDate:
- earlierDate:
- laterDate:
- compare:
- timeIntervalSinceDate:
timeIntervalSinceNow
timeIntervalSinceReferenceDate
timeIntervalSince1970
timeIntervalSinceReferenceDate
NSTimeIntervalSince1970
- dateByAddingTimeInterval:
description
- descriptionWithLocale:
NSSystemClockDidChangeNotification
+ dateWithNaturalLanguageString:
+ dateWithNaturalLanguageString:locale:
+ dateWithString:
YYYY-MM-DD HH:MM:SS ±HHMM
).
国際化文字列表現形式(YYYY-MM-DD HH:MM:SS ±HHMM
)で与えられる文字列によって指定される日付と時刻の値で日付オブジェクトを作成して返します。
- initWithString:
- addTimeInterval:
- dateWithCalendarFormat:timeZone:
- descriptionWithCalendarFormat:timeZone:locale:
NSDateInterval
NSTimeInterval