文書 > Foundation > Date and Times > Date > NSDate

クラス

NSDate

Date にブリッジする特定の時点の表現。参照セマンティクスやその他の Foundation 特有の動作が必要な場合は NSDate を使用して下さい。

概観

NSDate オブジェクトは、特定のカレンダーシステムまたはタイムゾーンとは関係なく、単一の時点をカプセル化します。Date オブジェクトは不変であり、絶対参照日付 (2001 年 1 月 1 日 00:00:00 UTC) に対する不変時間間隔を表します。

NSDate クラスは、日付の比較、2 つの日付間の時間間隔の計算、および別の日付に対する時間間隔からの新しい日付の作成方法を提供します。NSDate オブジェクトを DateFormatter オブジェクトと共に使用して、日付と時刻のローカライズされた表現を作成することができます。また、NSCalendar オブジェクトを使用してカレンダー演算を行うこともできます。

NSDate は、Core Foundation の対応する相手、CFDate と通話無料でブリッジされています。通話無料のブリッジの詳細については、通話無料でブリッジを参照してください。

重要： Foundation フレームワークへの Swift のオーバーレイは、Date 構造体を提供し、NSDate クラスにブリッジします。値の型の詳細については、Cocoa と Objective-C での Swift の使用 (Swift 4.1) の Cocoa フレームワークでの作業を参照してください。

サブクラス化する際の注意点

特定のカレンダーシステムでの作業をより簡単にするため、またはより細かい時間的精度で日付と時刻の値を扱うために、NSDate をサブクラス化することができます。

オーバーライドするべきメソッドとその他の要件

private サブクラスまたは public サブクラスで提供される動作とは異なる動作を取得するために NSDate をサブクラス化する必要がある場合は、次の作業を行なわなければなりません。

日付と時刻の値を保持する適切なインスタンス変数を宣言します (絶対参照日付を基準にして)

timeIntervalSinceReferenceDate インスタンスメソッドをオーバーライドして、インスタンス変数に基づいて正しい日付と時刻の値を指定します。

指定初期化メソッドの 1 つである init(timeIntervalSinceReferenceDate:) をオーバーライドします

カレンダーシステムを表すサブクラスを作成する場合は、過去と未来の期間をこのカレンダーの単位に分割するメソッドを定義します

NSDate はこれらのプロトコルを採用しているため、NSCopying プロトコルと NSCoding プロトコルで必要なメソッドを実装します

特別の考慮事項

あなたのサブクラスでは、NSDate (2001 年 1 月 1 日 00:00:00 UTC) で使用されている絶対参照日付とは異なる参照日付を使用することがあります。もしそうであれば、timeIntervalSinceReferenceDate メソッドと init(timeIntervalSinceReferenceDate:) メソッドの実装で絶対参照日付を使用しなければなりません。つまり、これらのメソッドのタイトルで参照される参照日付は絶対参照日付です。これらのメソッドで絶対参照日付を使用しない場合、あなたのサブクラスの NSDate オブジェクトと private サブクラスの NSDate オブジェクトの比較は機能しません。