文書 > Foundation > Dates and Times > Date
構造体
Date
カレンダーやタイムゾーンとは関係ない、特定の時点。
概要
Date 値は、特定のカレンダーシステムまたはタイムゾーンとは関係なく、単一の時点をカプセル化します。Date 値は、絶対参照日付に対する時間間隔を表します。
Date 構造体は、日付の比較、2 つの日付間の時間間隔の計算、および別の日付に対する時間間隔からの新しい日付の作成のためのメソッドを提供します。DateFormatter インスタンスと一緒に日付値を使用して、日付と時刻のローカライズされた表現を作成し、Calendar インスタンスを使用してカレンダーの演算を実行します。
NSDate クラスへ Date はブリッジします。Objective-C API と相互作用するコードでは、これらを同じ意味で使用できます。
トピックス
日付の作成
現在の日付と時間に初期化された日付値を作成します。
init(timeIntervalSinceNow: TimeInterval)
現在の日付と時間を基準にして与えられた秒数で初期化された日付値を作成します。
init(timeInterval: TimeInterval, since: Date)
与えられた別の日付を基準にして秒数で初期化された日付値を作成します。
init(timeIntervalSinceReferenceDate: TimeInterval)
2001 年 1 月 1 日 00:00:00 UTC を基準に与えられた秒数で初期化された日付値を作成します。
init(timeIntervalSince1970: TimeInterval)
1970 年 1 月 1 日 00:00:00 UTC を基準に与えられた秒数で初期化された日付値を作成します。
時間的境界の取得
static let distantFuture: Date
遠い将来の日付を表す日付値。
遠い過去の日付を表す日付値。
日付の比較
static func < (Date, Date) -> Bool
左の日付が右の日付よりも早い場合に true となるブール値を返します。
static func == (Date, Date) -> Bool
2 つの日付の値が同じ時点を表す場合は true のブール値を返します。
func compare(Date) -> ComparisonResult
2 つの日付値を比較します。
時間間隔の取得
func timeIntervalSince(Date) -> TimeInterval
受信者と別の与えられた日付との間隔を返します。
var timeIntervalSinceNow: TimeInterval
日付値と現在の日付および時間の間の時間間隔。
var timeIntervalSinceReferenceDate: TimeInterval
2001 年 1 月 1 日 00:00:00 UTC と日付値との間隔。
var timeIntervalSince1970: TimeInterval
1970 年 1 月 1 日 00:00:00 UTC と日付値との間隔。
static var timeIntervalSinceReferenceDate: TimeInterval
2001 年 1 月 1 日 00:00:00 UTC と現在の日付および時間までの間隔。
static let timeIntervalBetween1970AndReferenceDate: TimeInterval
1970 年 1 月 1 日から基準日、2001 年 1 月 1 日までの秒数。
時間間隔の追加と削除
static func != (Date, Date) -> Bool
2 つの値が等しくないかどうかを示すブール値を返します。
static func + (Date, TimeInterval) -> Date
指定された時間の量が追加された日付を返します。
static func += (inout Date, TimeInterval)
日付に時間間隔を追加します。
static func - (Date, TimeInterval) -> Date
指定された時間の量を差し引いた日付を返します。
static func -= (inout Date, TimeInterval)
日付から時間間隔を引きます。
static func < (Date, Date) -> Bool
左の日付が右の日付よりも早い場合に true となるブール値を返します。
static func <= (Date, Date) -> Bool
最初の引数の値が 2 番目の引数の値以下かどうかを示すブール値を返します。
static func == (Date, Date) -> Bool
2 つの日付の値が同じ時点を表す場合は true のブール値を返します。
static func >= (Date, Date) -> Bool
最初の引数の値が 2 番目の引数の値以上かどうかを示すブール値を返します。
日付の記述
日付値のテキスト記述。
func description(with: Locale?) -> String
与えられたロケールを使用して日付の文字列表現を返します。
デバッグに適した日付のテキスト記述。
日付を反映するミラー。
計算された日付のハッシュ値。
var customPlaygroundQuickLook: PlaygroundQuickLook
日付のカスタムのプレイグラウンドクイックルック。
廃止
参照型の使用
Date にブリッジする特定の時点の表現。参照セマンティクスやその他の Foundation 特有の動作が必要な場合は NSDate を使用して下さい。
この値型と同等の参照型のエイリアス。
イニシャライザ
インスタンスメソッド
func addTimeInterval(TimeInterval)
この日付に時間間隔を追加します。
func addingTimeInterval(TimeInterval) -> Date
この日付に時間間隔を追加して新しい日付値を作成します。
演算子関数
static func ... (Date) -> PartialRangeFrom<Date>
下限から上に延びる部分範囲を返します。
static func ... (Date) -> PartialRangeThrough<Date>
上限を含む、上に向かう部分範囲を返します。
static func ... (Date, Date) -> ClosedRange<Date>
両方の境界を含む閉じた範囲を返します。
static func ..< (Date) -> PartialRangeUpTo<Date>
その上限を含まない、上に向かう部分範囲を返します。
static func ..< (Date, Date) -> Range<Date>
下限を含み、上限を含まない半開放の範囲を返します。
static func > (Date, Date) -> Bool
static func > (Date, Date) -> Bool
最初の引数の値が 2 番目の引数の値より大きいかどうかを示すブール値を返します。
関連
以下に準拠
- CKRecordValueProtocol
- Comparable
- CustomDebugStringConvertible
- CustomPlaygroundQuickLookable
- CustomReflectable
- CustomStringConvertible
- Equatable
- ReferenceConvertible
以下も見よ
日付の表現
特定の開始の日付と終了する日付の間の時間間隔。
秒数。