Structure

DateComponents

A date or time specified in terms of units (such as year, month, day, hour, and minute) to be evaluated in a calendar system and time zone. あるカレンダー体系とタイムゾーンにおいて評価されるように、単位いくつか（例えば年、月、日、時、そして分）の観点から指定される日付と時刻。

Declaration 宣言 

struct DateComponents

Overview 概要

DateComponents encapsulates the components of a date in an extendable, structured manner. DateComponentsは、ある日付の構成要素を、拡張可能な、構造化流儀においてカプセル化します。

It is used to specify a date by providing the temporal components that make up a date and time in a particular calendar: hour, minutes, seconds, day, month, year, and so on. It can also be used to specify a duration of time, for example, 5 hours and 16 minutes. A DateComponents is not required to define all the component fields. それは、特定のカレンダーにおいて日付と時刻を作り上げる時間構成要素：時間、分、秒、日、月、年、などを提供することによってある日付を指定するのに使われます。それはまたある継続時間を指定するのに使われます、例えば５時間と16分。DateComponentsは、全構成要素単位を定義するのに必須ではありません。

When a new instance of DateComponents is created, the date components are set to nil. DateComponentsの新しいインスタンスが作成される場合、日付構成要素それらはnilに設定されます。

Topics 話題

Initializing Date Components 日付構成要素を初期化する

init(calendar: Calendar?, timeZone: TimeZone?, era: Int?, year: Int?, month: Int?, day: Int?, hour: Int?, minute: Int?, second: Int?, nanosecond: Int?, weekday: Int?, weekdayOrdinal: Int?, quarter: Int?, weekOfMonth: Int?, weekOfYear: Int?, yearForWeekOfYear: Int?)
Initializes a date components value, optionally specifying values for its fields. 日付構成要素値を初期化します、随意にそれの各情報単位欄に対して値を指定します。
var calendar: Calendar?
The calendar used to interpret the other values in this structure. それの構造体の中の他の値を解釈するために使われるカレンダー。
var timeZone: TimeZone?
A time zone. あるタイムゾーン。

Validating a Date 日付を検証する

var isValidDate: Bool
Indicates whether the current combination of properties represents a date which exists in the current calendar. 現在のプロパティの組み合わせが、現在のカレンダーに存在する日付を表すかどうかを指し示します。
func isValidDate(in: Calendar) -> Bool
Indicates whether the current combination of properties represents a date which exists in the specified calendar. 現在のプロパティの組み合わせが、指定されたカレンダーに存在する日付を表すかどうかを指し示します。
var date: Date?
The date calculated from the current components using the stored calendar. 現在の構成要素から格納カレンダーを使って計算される日付。

Accessing Months and Years 月と年にアクセスする

var era: Int?
An era or count of eras. ある紀年または数え紀年。
var year: Int?
A year or count of years. ある年または数え年。
var yearForWeekOfYear: Int?
The year corresponding to a week-counting week. ある週計数の週に該当している年。
var quarter: Int?
A quarter or count of quarters. ある四半期または数え四半期。
var month: Int?
A month or count of months. ある月または数え月。
var isLeapMonth: Bool?
Set to true if these components represent a leap month. それらの構成要素が閏月を表すならばtrueに設定されます。

Accessing Weeks and Days 週と日にちにアクセスする

var weekOfMonth: Int?
A week of the month or a count of weeks of the month. その月のある週またはその月の数え週。
var weekOfYear: Int?
A week of the year or count of the weeks of the year. その年のある週またはその年の数え週。
var weekday: Int?
A weekday or count of weekdays. ある週日または数え週日。
var weekdayOrdinal: Int?
A weekday ordinal or count of weekday ordinals. ある週日序数または数え週日序数。
var day: Int?
A day or count of days. ある日または数え日。

Accessing Hours and Seconds 時と秒にアクセスする

var hour: Int?
An hour or count of hours. ある時間または数え時間。
var minute: Int?
A minute or count of minutes. 分または数え分。
var second: Int?
A second or count of seconds. 秒または数え秒。
var nanosecond: Int?
A nanosecond or count of nanoseconds. ナノ秒または数えナノ秒。

Accessing Calendar Components カレンダー構成要素にアクセスする

func value(for: Calendar.Component) -> Int?
Returns the value of one of the properties, using an enumeration value instead of a property name. プロパティの１つの値を返します、プロパティ名ではなく列挙値を使っています。
func setValue(Int?, for: Calendar.Component)
Set the value of one of the properties, using an enumeration value instead of a property name. プロパティの１つの値を設定します、プロパティ名ではなく列挙値を使っています。
enum Calendar.Component
An enumeration for the various components of a calendar date. あるカレンダー日付の様々な構成要素に対する列挙。

Comparing Date Components 日付構成要素を比較します

static func != (DateComponents, DateComponents) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。
static func == (DateComponents, DateComponents) -> Bool
Indicates whether two date component instances are the same. ２つの日付構成要素が同じかどうかを指し示します。

Describing Date Components 日付構成要素を記述する

var description: String
A textual description of the date components. 日付構成要素のテキスト表現。
var debugDescription: String
A textual description of the date components suitable for debugging. デバッグに適する日付構成要素のテキスト表現。
var customMirror: Mirror
A mirror that reflects the date. 日付を反映するミラー。
var hashValue: Int
The computed hash value of the date. 日付の計算ハッシュ値。

Using Reference Types 参照型を使用する

class NSDateComponents
An object that specifies a date or time in terms of calendar units that bridges to DateComponents; use NSDateComponents when you need reference semantics or other Foundation-specific behavior. あるオブジェクト、それはある日付または時刻をカレンダー単位の表現で指定します、それはDateComponentsにブリッジします；あなたが参照意味論や他のFoundation特有の挙動を必要とする場合にNSDateComponentsを使ってください。
typealias DateComponents.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Initializers イニシャライザ

init(from: Decoder)
init(subscriptionPeriod: Product.SubscriptionPeriod)

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

func encode(to: Encoder)
func hash(into: inout Hasher)

Relationships 関係

Conforms To 次に準拠

See Also 参照

Calendrical Calculations カレンダーに関する計算

struct Calendar
A definition of the relationships between calendar units (such as eras, years, and weekdays) and absolute points in time, providing features for calculation and comparison of dates. カレンダー単位（例えば、紀年、年、そして曜日など）と時間の中の絶対的時点の間のそれら関係からなるある定義で、日付の計算と比較のための機能を提供しています。
struct TimeZone
Information about standard time conventions associated with a specific geopolitical region. 指定された地政学的境界に関連付けられる標準的時刻慣例についての情報。