Structure

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. カレンダー単位（例えば、紀年、年、そして曜日など）と時間の中の絶対的時点の間のそれら関係からなるある定義で、日付の計算と比較のための機能を提供しています。

Declaration 宣言 

struct Calendar

Overview 概要

Calendar encapsulates information about systems of reckoning time in which the beginning, length, and divisions of a year are defined. It provides information about the calendar and support for calendrical computations such as determining the range of a given calendrical unit and adding units to a given absolute time. Calendarは、ある年の始まり、長さ、そしていくつかの区分が定義されるところのさまざまな刻時体系についての情報をカプセル化します。それはカレンダーについての情報を、そしてカレンダーに関する計算のサポートを提供します、例えば、与えられたカレンダー単位の範囲の決定や与えられた絶対時間にカレンダー単位を追加することなど。

Topics 話題

Creating a Calendar カレンダーを作成する

enum Calendar.Identifier
An enumeration for the available calendars. 利用可能なカレンダーに対するある列挙。

Getting the User's Calendar ユーザの持つカレンダーの取得。

static var autoupdatingCurrent: Calendar
A calendar that tracks changes to user’s preferred calendar. ユーザの持つ優先カレンダーに対する変更を追跡するカレンダー。
static var current: Calendar
The user’s current calendar. ユーザの持つ現在のカレンダー。

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タイムゾーンの代わりに）。
enum Calendar.Component
An enumeration for the various components of a calendar date. あるカレンダー日付の様々な構成要素に対する列挙。

Getting Calendar Information カレンダー情報を取得する

var identifier: Calendar.Identifier
The identifier of the calendar. カレンダーの識別子。
var locale: Locale?
The locale of the calendar. カレンダーのロケール。
var firstWeekday: Int
The first day of the week for the calendar. そのカレンダーに対する週の最初の日。
var minimumDaysInFirstWeek: Int
The number of minimum days in the first week. 最初の週における最も小さい日にち。
var timeZone: TimeZone
The time zone of the calendar. カレンダーのタイムゾーン。
func maximumRange(of: Calendar.Component) -> Range<Int>?
The maximum range limits of the values that a given component can take on. 与えられた構成要素が取ることが可能な値の最大限界範囲。
func minimumRange(of: Calendar.Component) -> Range<Int>?
Returns the minimum range limits of the values that a given component can take on. 与えられた構成要素が取ることが可能な値の最小限界範囲。
func ordinality(of: Calendar.Component, in: Calendar.Component, for: Date) -> Int?
Returns, for a given absolute time, the ordinal number of a smaller calendar component (such as a day) within a specified larger calendar component (such as a week). 与えられた絶対時間に対して、指定されたより大きいカレンダー構成要素（例えば週）内のより小さいカレンダー構成要素（例えば日にち）の順序数を返します。
func range(of: Calendar.Component, in: Calendar.Component, for: Date) -> Range<Int>?
Returns the range of absolute time values that a smaller calendar component (such as a day) can take on in a larger calendar component (such as a month) that includes a specified absolute time. 指定された絶対時間を含むあるより大きいカレンダー構成要素（例えば月）の中で、あるより小さいカレンダー構成要素（例えば日にち）が取ることができる絶対時間値からなる範囲を返します。

Scanning Dates 日付を走査する

func startOfDay(for: Date) -> Date
Returns the first moment of a given Date, as a Date. 与えられたDateの最初の瞬間を、Dateとして返します。
func enumerateDates(startingAfter: Date, matching: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection, using: (Date?, Bool, inout Bool) -> Void)
Computes the dates which match (or most closely match) a given set of components, and calls the closure once for each of them, until the enumeration is stopped. 与えられた一揃いの構成要素と合致する（または最も近くの合致する）日付それらを計算します、そしてそれらの各々で一度だけクロージャを呼び出します、列挙が停止されるまで。
func nextDate(after: Date, matching: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection) -> Date?
Computes the next date which matches (or most closely matches) a given set of components. 与えられた一揃いの構成要素に合致する（または最も近くの合致する）次の日付を計算します。
enum Calendar.MatchingPolicy
A hint to the search algorithm to control the method used for searching for dates. 日付を検索するのに使われるメソッドを制御する検索アルゴリズムへのヒント。
enum Calendar.RepeatedTimePolicy
Determines which result to use when a time is repeated on a day in a calendar (for example, during a daylight saving transition when the times between 2:00am and 3:00am may happen twice). あるカレンダーのある日にある時間が繰り返される場合に使う結果を決定します（例えば、サマータイムの変わり目には、2:00amと3:00amの間の時間は２度起こるかもしれません）。

Calculating Dates from Components 構成要素から日付を計算する

func date(from: DateComponents) -> Date?
Returns a date created from the specified components. 指定された構成要素から作成される日付を返します。
func date(byAdding: DateComponents, to: Date, wrappingComponents: Bool) -> Date?
Returns a new Date representing the date calculated by adding components to a given date. いくつかの構成要素をある与えられた日付に加えることによって計算される日付を表している新しいDateを返します。
func date(byAdding: Calendar.Component, value: Int, to: Date, wrappingComponents: Bool) -> Date?
Returns a new Date representing the date calculated by adding an amount of a specific component to a given date. ある量の特定の構成要素をある与えられた日付に加えることによって計算される日付を表している新しいDateを返します。
func date(bySetting: Calendar.Component, value: Int, of: Date) -> Date?
Returns a new Date representing the date calculated by setting a specific component to a given time, and trying to keep lower components the same. If the component already has that value, this may result in a date which is the same as the given date. 特定の構成要素をある与えられた時間に設定し、そしてより低い構成要素を同じに保つよう試みることによって計算される日付を表している新しいDateを返します。構成要素が既にその値を持つならば、これはその与えられた日付と同じ日付という結果になるでしょう。
func date(bySettingHour: Int, minute: Int, second: Int, of: Date, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection) -> Date?
Returns a new Date representing the date calculated by setting hour, minute, and second to a given time on a specified Date. ある指定されたDate上のある与えられた時間に時、分、そして秒を設定することによって算出される日付を表している新しいDateを返します。

Calculating Intervals 隔たりを計算する

func dateInterval(of: Calendar.Component, for: Date) -> DateInterval?
Returns the starting time and duration of a given calendar component that contains a given date. 開始時間と与えられたカレンダー構成要素の継続期間を返します、それは与えられた日付を含みます。（開始時間が与えられた日付？）
func dateInterval(of: Calendar.Component, start: inout Date, interval: inout TimeInterval, for: Date) -> Bool
Returns, via two inout parameters, the starting time and duration of a given calendar component that contains a given date. ２つのインアウトパラメータ経由で、開始時間と与えられたカレンダー構成要素の継続期間を返します、それは与えられた日付を含みます。（開始時間が与えられた日付？）
func dateIntervalOfWeekend(containing: Date) -> DateInterval?
Returns a DateInterval of the weekend contained by the given date, or nil if the date is not in a weekend. 与えられた日付によって含まれる、週末のDateIntervalを、またはその日付が週末の中にないならばnilを返します。
func dateIntervalOfWeekend(containing: Date, start: inout Date, interval: inout TimeInterval) -> Bool
Find the range of the weekend around the given date, returned via two by-reference parameters. 与えられた日付の辺りの週末の範囲を見つけます、２つの参照渡しパラメータ経由で返されます。
func nextWeekend(startingAfter: Date, direction: Calendar.SearchDirection) -> DateInterval?
Returns a DateInterval of the next weekend, which starts strictly after the given date. 次の週末のDateIntervalを返します、それは与えられた日付の厳密に後で開始します。
func nextWeekend(startingAfter: Date, start: inout Date, interval: inout TimeInterval, direction: Calendar.SearchDirection) -> Bool
Returns the range of the next weekend via two inout parameters. The weekend starts strictly after the given date. 次の週末の範囲を２つのインアウトパラメータ経由で返します。週末は、与えられた値の厳密に後で開始します。
enum Calendar.SearchDirection
The direction in time to search. 時間での検索する方向。

Comparing Dates 日付を比較する

func compare(Date, to: Date, toGranularity: Calendar.Component) -> ComparisonResult
Compares two dates down to the specified component. 指定された構成要素へと至るまで２つの日付を比較します。
func isDate(Date, equalTo: Date, toGranularity: Calendar.Component) -> Bool
Returns a Boolean value indicating whether two dates are equal down to the specified component. 指定された構成要素へと至るまで２つの日付が等しいかどうかを指し示すブール値を返します。
func isDate(Date, inSameDayAs: Date) -> Bool
Returns a Boolean value indicating whether a date is within the same day as another date. ある日付が別の日付と同じ日にちの内であるかどうかを指し示すブール値を返します。
func isDateInToday(Date) -> Bool
Returns a Boolean value indicating whether the given date is within today. 与えられた日付が今日の内であるかどうかを指し示すブール値を返します。
func isDateInTomorrow(Date) -> Bool
Returns a Boolean value indicating whether the given date is within tomorrow. 与えられた日付が明日の内であるかどうかを指し示すブール値を返します。
func isDateInYesterday(Date) -> Bool
Returns a Boolean value indicating whether the given date is within yesterday. 与えられた日付が昨日の内であるかどうかを指し示すブール値を返します。
func isDateInWeekend(Date) -> Bool
Returns a Boolean value indicating whether the given date is within a weekend period. 与えられた日付が週末期間の内であるかどうかを指し示すブール値を返します。

Comparing Calendars カレンダーを比較する

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

Getting AM and PM symbols AM および PM表象を得る

var amSymbol: String
The symbol used to represent “AM”, localized to the Calendar’s locale. “AM” を表すために使われる表象、Calendarの持つlocaleにローカライズされます。
var pmSymbol: String
The symbol used to represent “PM”, localized to the Calendar’s locale. “PM” を表すために使われる表象、Calendarの持つlocaleにローカライズされます。

Getting Weekday Symbols 曜日表象を得る

var weekdaySymbols: [String]
A list of weekdays in this calendar, localized to the Calendar’s locale. このカレンダーの中の曜日のリスト、Calendarの持つlocaleにローカライズされます。
var shortWeekdaySymbols: [String]
A list of shorter-named weekdays in this calendar, localized to the Calendar’s locale. このカレンダーの中の短縮名の曜日のリスト、Calendarの持つlocaleにローカライズされます。
var veryShortWeekdaySymbols: [String]
A list of very-shortly-named weekdays in this calendar, localized to the Calendar’s locale. このカレンダーの中の超短縮名の曜日のリスト、Calendarの持つlocaleにローカライズされています。
var standaloneWeekdaySymbols: [String]
A list of standalone weekday names in this calendar, localized to the Calendar’s locale. このカレンダーの中の単独動作型の曜日名のリスト、Calendarの持つlocaleにローカライズされます。
var shortStandaloneWeekdaySymbols: [String]
A list of shorter-named standalone weekdays in this calendar, localized to the Calendar’s locale. このカレンダーの中の短縮名の単独動作型の曜日のリスト、Calendarの持つlocaleにローカライズされます。
var veryShortStandaloneWeekdaySymbols: [String]
A list of very-shortly-named weekdays in this calendar, localized to the Calendar’s locale. このカレンダーの中の超短縮名の曜日のリスト、Calendarの持つlocaleにローカライズされています。

Getting Month Symbols 月表象を得る

var monthSymbols: [String]
A list of months in this calendar, localized to the Calendar’s locale. このカレンダーの中の月のリスト、Calendarの持つlocaleにローカライズされます。
var shortMonthSymbols: [String]
A list of shorter-named months in this calendar, localized to the Calendar’s locale. このカレンダーの中の短縮名の月のリスト、Calendarの持つlocaleにローカライズされます。
var veryShortMonthSymbols: [String]
A list of very-shortly-named months in this calendar, localized to the Calendar’s locale. このカレンダーの中の超短縮名の月のリスト、Calendarの持つlocaleにローカライズされます。
var standaloneMonthSymbols: [String]
A list of standalone months in this calendar, localized to the Calendar’s locale. このカレンダーの中の単独動作型の月のリスト、Calendarの持つlocaleにローカライズされます。
var shortStandaloneMonthSymbols: [String]
A list of shorter-named standalone months in this calendar, localized to the Calendar’s locale. このカレンダーの中の短縮名の単独動作型の月のリスト、Calendarの持つlocaleにローカライズされます。
var veryShortStandaloneMonthSymbols: [String]
A list of very-shortly-named standalone months in this calendar, localized to the Calendar’s locale. このカレンダーの中の超短縮名の単独動作型の月のリスト、Calendarの持つlocaleにローカライズされます。

Getting Quarter Symbols 四半期表象を得る

var quarterSymbols: [String]
A list of quarter names in this calendar, localized to the Calendar’s locale. このカレンダーの中の四半期名のリスト、Calendarの持つlocaleにローカライズされます。
var shortQuarterSymbols: [String]
A list of shorter-named quarters in this calendar, localized to the Calendar’s locale. このカレンダーの中の短縮名の四半期のリスト、Calendarの持つlocaleにローカライズされます。
var standaloneQuarterSymbols: [String]
A list of standalone quarter names in this calendar, localized to the Calendar’s locale. このカレンダーの中の単独動作型の四半期名のリスト、Calendarの持つlocaleにローカライズされます。
var shortStandaloneQuarterSymbols: [String]
A list of shorter-named standalone quarters in this calendar, localized to the Calendar’s locale. このカレンダーの中の短縮名の単独動作型の四半期のリスト、Calendarの持つlocaleにローカライズされます。

Getting Era Symbols 紀元表象を得る

var eraSymbols: [String]
A list of eras in this calendar, localized to the Calendar’s locale. このカレンダーの中の紀年のリスト、Calendarの持つlocaleにローカライズされます。
var longEraSymbols: [String]
A list of longer-named eras in this calendar, localized to the Calendar’s locale. このカレンダーの中の伸長名の紀年のリスト、Calendarの持つlocaleにローカライズされます。

Describing a Calendar カレンダーを記述する

var description: String
A textual description of the calendar. カレンダーのテキスト記述。
var debugDescription: String
A textual description of the locale suitable for debugging. デバッグに適するこのロケールのテキスト表現。
var customMirror: Mirror
A mirror that reflects the calendar. カレンダーを反映するミラー。
var hashValue: Int
The computed hash value for the calendar. カレンダーに対する計算ハッシュ値。

Encoding and Decoding エンコーディングとデコーディング

func encode(to: Encoder)
Encodes this calendar into the given encoder. 与えられたエンコーダへとこのカレンダーをエンコードします。
init(from: Decoder)
Creates a new calendar instance by decoding from the given decoder. 新しいカレンダーインスタンスをこの与えられたデコーダからデコーディングすることによって作成します。

Using Reference Types 参照型を使用する

class NSCalendar
An encapsulation of calendar information and calculations that bridges to Calendar; use NSCalendar when you need reference semantics or other Foundation-specific behavior. カレンダーの情報といくつかの計算のカプセル化で、それはCalendarへブリッジを行います；あなたが参照意味論や他のFoundation特有の挙動を必要とする場合はNSCalendarを使ってください。
typealias Calendar.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Initializers イニシャライザ

init(identifier: Calendar.Identifier)

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

func hash(into: inout Hasher)

Relationships 関係

Conforms To 次に準拠

See Also 参照

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

struct 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. あるカレンダー体系とタイムゾーンにおいて評価されるように、単位いくつか（例えば年、月、日、時、そして分）の観点から指定される日付と時刻。
struct TimeZone
Information about standard time conventions associated with a specific geopolitical region. 指定された地政学的境界に関連付けられる標準的時刻慣例についての情報。