Enumeration 列挙

Calendar.Component

An enumeration for the various components of a calendar date. あるカレンダー日付の様々な構成要素に対する列挙。

Declaration 宣言 

enum Calendar.Component

Overview 概要

You use one or more Calendar.Component values with the component(_:from:) or dateComponents(_:from:) methods to specify parts to extract from a given Date. あなたは１つ以上のCalendar.Component値をcomponent(_:from:)またはdateComponents(_:from:)メソッドで使用して、与えられたDateから抽出する部分を指定します。

Listing 1 shows how to use the year, month, and day components to get the corresponding units of the current Gregorian calendar date as a DateComponents instance. コード出力 1 は、year、month、そしてday構成要素を使って現在のグレゴリオ暦日付の対応する単位をDateComponentsインスタンスとして取得する方法を示します。

Listing 1 Getting the Gregorian year, month, and day of month from the current date. コード出力 1 グレゴリオ年、月、そして日にちを現在の日付から取得する。 

let myCalendar = Calendar(identifier: .gregorian)
let ymd = myCalendar.dateComponents([.year, .month, .day], from: Date())

Topics 話題

Specifying Years and Months 年と月を指定する

case era
Identifier for the era unit. 紀年単位に対する識別子。
case year
Identifier for the year unit. 年単位に対する識別子。
case yearForWeekOfYear
Identifier for the week-counting year unit. 週計数年単位に対する識別子。
case quarter
Identifier for the quarter of the calendar. 四半期暦に対する識別子。
case month
Identifier for the month unit. 月単位に対する識別子。

Specifying Weeks and Days 週と日にちを指定する

case weekOfYear
Identifier for the week of the year unit. 年内週番号単位に対する識別子。
case weekOfMonth
Identifier for the week of the month calendar unit. 月カレンダー単位での週に対する識別子。
case weekday
Identifier for the weekday unit. 週日単位に対する識別子。
case weekdayOrdinal
Identifier for the weekday ordinal unit. 週日序数単位に対する識別子。
case day
Identifier for the day unit. 日にち単位に対する識別子。

Specifying Hours, Minutes, and Seconds 時間、分、そして秒を指定する

case hour
Identifier for the hour unit. 時間単位に対する識別子。
case minute
Identifier for the minute unit. 分単位に対する識別子。
case second
Identifier for the second unit. 秒単位に対する識別子。
case nanosecond
Identifier for the nanosecond unit. ナノ秒単位に対する識別子。

Specifying Calendars and Time Zones カレンダーとタイムゾーンを指定する

case calendar
Identifier for the calendar unit. カレンダー単位に対する識別子。
case timeZone
Identifier for the time zone unit. タイムゾーンに対する識別子。

Comparing Components 構成要素を比較する

static func != (Calendar.Component, Calendar.Component) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。

Instance Properties インスタンスプロパティ

var hashValue: Int

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

func hash(into: inout Hasher)

Operator Functions 演算子関数

static func == (Calendar.Component, Calendar.Component) -> Bool

See Also 参照

Extracting Components 構成要素の抽出

func date(Date, matchesComponents: DateComponents) -> Bool
Determines if the date has all of the specified date components. 指定された日付構成要素のすべてを、この日付が持つかどうかを判定します。
func component(Calendar.Component, from: Date) -> Int
Returns the value for one component of a date. ある日付の１つの構成要素に対する値を返します。
func dateComponents(Set<Calendar.Component>, from: Date) -> DateComponents
Returns all the date components of a date, using the calendar time zone. ある日付の日付構成要素のすべてを返します、そのカレンダーのタイムゾーンを使います。
func dateComponents(Set<Calendar.Component>, from: Date, to: Date) -> DateComponents
Returns the difference between two dates. ２つの日付の間の差を返します。
func dateComponents(Set<Calendar.Component>, from: DateComponents, to: DateComponents) -> DateComponents
Returns the difference between two dates specified as DateComponents. DateComponentsとして指定された２つの日付の間の差を返します。
func dateComponents(in: TimeZone, from: Date) -> DateComponents
Returns all the date components of a date, as if in a given time zone (instead of the Calendar time zone). ある日付の日付構成要素のすべてを返します、与えられたタイムゾーンを使います（Calendarタイムゾーンの代わりに）。