Structure

Date

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

Declaration 宣言 

struct Date

Overview 概要

A Date value encapsulate a single point in time, independent of any particular calendrical system or time zone. Date values represent a time interval relative to an absolute reference date. Date値は、あらゆる特定のカレンダーシステムまたはタイムゾーンに独立して、ある単一の時点をカプセル化します。日付値は、絶対基準日に相対して時間間隔を表します。

The Date structure 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. Use date values in conjunction with DateFormatter instances to create localized representations of dates and times and with Calendar instances to perform calendar arithmetic. Date構造体は、日付を比較する、２つの日付の時間間隔を計算する、そして別の日付と相対してある時間間隔から新しい日付を作成するメソッドを提供します。日付値を使って、DateFormatterインスタンスと連携して日付と時刻のローカライズされた表現を作成したり、Calendarインスタンスとともにカレンダー計算を実行してください。

Date bridges to the NSDate class. You can use these interchangeably in code that interacts with Objective-C APIs. Dateは、NSDateクラスへとブリッジします。あなたは、Objective-C APIと相互作用するコードにおいて、それらを交換可能に使用できます。

Topics 話題

Creating a Date 日付の作成

init()
Creates a date value initialized to the current date and time. 現在の日付と時刻に初期化される日付値を作成します。
init(timeIntervalSinceNow: TimeInterval)
Creates a date value initialized relative to the current date and time by a given number of seconds. 現在の日付と時刻に相対してある与えられた秒数の差で初期化される日付値を作成します。
init(timeInterval: TimeInterval, since: Date)
Creates a date value initialized relative to another given date by a given number of seconds. 別の与えられた日付に相対してある与えられた秒数の差で初期化される日付値を作成します。
init(timeIntervalSinceReferenceDate: TimeInterval)
Creates a date value initialized relative to 00:00:00 UTC on 1 January 2001 by a given number of seconds. 00:00:00 UTC 1 January 2001に相対してある与えられた秒数の差で初期化される日付値を作成します。
init(timeIntervalSince1970: TimeInterval)
Creates a date value initialized relative to 00:00:00 UTC on 1 January 1970 by a given number of seconds. 00:00:00 UTC 1 January 1970に相対してある与えられた秒数の差で初期化される日付値を作成します。
init(from: Decoder)
Creates a new instance by decoding from the given decoder. 新しいインスタンスをこの与えられたデコーダからデコーディングすることによって作成します。

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

static let distantFuture: Date
A date value representing a date in the distant future. 遠い未来のある日付を表している日付値。
static let distantPast: Date
A date value representing a date in the distant past. 遠い過去のある日付を表している日付値。

Comparing Dates 日付を比較する

static func == (Date, Date) -> Bool
Returns a Boolean value that indicates whether two dates represent the same point in time. あるブール値を返します、それは２つの日付が同じ時点を表すかどうかを指し示します。
static func != (Date, Date) -> Bool
Returns a Boolean value that indicates whether two dates don’t represent the same point in time. あるブール値を返します、それは２つの日付が同じ時点を表さないかどうかを指し示します。
static func > (Date, Date) -> Bool
Returns a Boolean value that indicates whether the value of the first argument is greater than that of the second argument. あるブール値を返します、それは最初の引数の値が２番目の引数のそれより大きいかどうかを指し示します。
static func >= (Date, Date) -> Bool
Returns a Boolean value indicating whether the value of the first argument is greater than or equal to that of the second argument. 最初の引数の値が２番目の引数のそれより大きいまたは等しいかどうかを指し示すブール値を返します。
static func < (Date, Date) -> Bool
Returns a Boolean value that indicates whether the value of the first argument is less than that of the second argument. あるブール値を返します、それは最初の引数の値が２番目の引数のそれより少ないかどうかを指し示します。
static func <= (Date, Date) -> Bool
Returns a Boolean value indicating whether the value of the first argument is less than or equal to that of the second argument. 最初の引数の値が２番目の引数のそれより少ないまたは等しいかどうかを指し示すブール値を返します。
func compare(Date) -> ComparisonResult
Compares another date to this one. 別の日付値をこのものと比較します。
func distance(to: Date) -> TimeInterval
Returns the distance from this date to another date, specified as a time interval. この日付から別の日付までの隔たりを返します、ある時間間隔として指定されます。

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

func timeIntervalSince(Date) -> TimeInterval
Returns the interval between this date and another given date. この日付と別の与えられた日付の間の隔たりを返します。
var timeIntervalSinceNow: TimeInterval
The time interval between the date value and the current date and time. 日付値と現在の日付と時刻の間の時間間隔。
var timeIntervalSinceReferenceDate: TimeInterval
The interval between the date value and 00:00:00 UTC on 1 January 2001. 日付値と00:00:00 UTC 1 January 2001の間の隔たり。
var timeIntervalSince1970: TimeInterval
The interval between the date value and 00:00:00 UTC on 1 January 1970. 日付値と00:00:00 UTC 1 January 1970の間の隔たり。
static var timeIntervalSinceReferenceDate: TimeInterval
The interval between 00:00:00 UTC on 1 January 2001 and the current date and time. 00:00:00 UTC 1 January 2001と現在の日付と時刻との間の隔たり。
static let timeIntervalBetween1970AndReferenceDate: Double
The number of seconds from 1 January 1970 to the reference date, 1 January 2001. 1 January 1970から基準日、1 January 2001までの秒数。
typealias Date.Stride
A type alias to define the stride of a date. ある日付のストライド（歩幅）を定義する型エイリアス。

Adding or Subtracting a Time Interval 時間間隔を加えたり引いたりする

func addTimeInterval(TimeInterval)
Adds a time interval to this date. 時間間隔をこの日付に加えます。
func addingTimeInterval(TimeInterval) -> Date
Creates a new date value by adding a time interval to this date. ある時間間隔をこの日付に加えることによって新しい日付値を作成します。
func advanced(by: TimeInterval) -> Date
Returns a date offset the specified time interval from this date. この日付からこの指定された時間間隔をオフセットした（補った）ある日付を返します。
static func + (Date, TimeInterval) -> Date
Returns a date with a specified amount of time added to it. 指定された量の時間をそれに加えたある日付を返します。
static func += (inout Date, TimeInterval)
Adds a time interval to a date. ある時間間隔を日付に加えます。
static func - (Date, TimeInterval) -> Date
Returns a date with a specified amount of time subtracted from it. 指定された量の時間をそれから引いたある日付を返します。
static func -= (inout Date, TimeInterval)
Subtracts a time interval from a date. ある日付から時間間隔を引きます。

Creating Date Ranges 日付範囲の作成

static func ... (Date) -> PartialRangeFrom<Date>
Returns a partial range extending upward from a lower bound. 下側の境界から上方に拡張している部分的な範囲を返します。
static func ... (Date) -> PartialRangeThrough<Date>
Returns a partial range up to, and including, its upper bound. それの上側の境界までの、そしてそれを含む部分的な範囲を返します。
static func ... (Date, Date) -> ClosedRange<Date>
Returns a closed range that contains both of its bounds. それの境界の両方を含む完結範囲を返します。
static func ..< (Date) -> PartialRangeUpTo<Date>
Returns a partial range up to, but not including, its upper bound. それの上側の境界までの、しかしそれを含んでいない、部分的な範囲を返します。
static func ..< (Date, Date) -> Range<Date>
Returns a half-open range that contains its lower bound but not its upper bound. それの下側の境界は含むがそれの上側の境界はそうしない半開範囲を返します。

Encoding Dates 日付をエンコードする

func encode(to: Encoder)
Encodes this date into the given encoder. この日付をその与えられたエンコーダへとエンコードします。

Describing Dates 日付を記述する

var description: String
A textual description of the date value. 日付値のテキスト表現。
func description(with: Locale?) -> String
Returns a string representation of the date using the given locale. 与えられたロケールを使って時間の文字列表現を返します。
var debugDescription: String
A textual description of the date suitable for debugging. デバッグに適する日付のテキスト表現。
var customMirror: Mirror
A mirror that reflects the date. 日付を反映するミラー。
var hashValue: Int
The computed hash value of the date. 日付の計算ハッシュ値。
func hash(into: inout Hasher)
Hashes the essential components of this value by feeding them into the given hasher. この値の本質的な構成要素それらを、それらをこの与えられたハーシャーに供給する事によってハッシュ化します。
var customPlaygroundQuickLook: PlaygroundQuickLook
A custom playground Quick Look for the date. 日付のためのカスタムプレイグラウンドQuick Look。
Deprecated 非推奨

Using Reference Types 参照型を使用する

class NSDate
A representation of a specific point in time, for use when you need reference semantics or other Foundation-specific behavior. ある特定の時点の表現、あなたが参照意味論や他のFoundation特有の挙動を必要とする場合に使うために。
typealias Date.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Initializers イニシャライザ

init<T, Value>(Value, strategy: T)
init<T>(T.ParseInput, strategy: T)

Type Properties 型プロパティ

static var now: Date

Instance Methods インスタンス メソッド

func ISO8601Format(Date.ISO8601FormatStyle) -> String
func formatted() -> String
func formatted<F>(F) -> F.FormatOutput
func formatted(date: Date.FormatStyle.DateStyle, time: Date.FormatStyle.TimeStyle) -> String

Structures 構造体

struct Date.AttributedStyle
struct Date.ComponentsFormatStyle
struct Date.FormatString
struct Date.FormatStyle
struct Date.ISO8601FormatStyle
struct Date.IntervalFormatStyle
A format style that creates string representations of date intervals. ある書式設定スタイル、それは日付間隔の文字列表現を作成するものです。
struct Date.ParseStrategy
struct Date.RelativeFormatStyle
A format style that forms locale-aware string representations of a relative date or time.
struct Date.VerbatimFormatStyle

Relationships 関係

Conforms To 次に準拠

See Also 参照

Date Representations 日付表現

struct DateInterval
The span of time between a specific start date and end date. 特定の開始日付と終了日付の間の期間。
typealias TimeInterval
A number of seconds. 秒数。