構造体

DateComponents

カレンダーシステムとタイムゾーンで評価される単位 (年、月、日、時間、分など) で指定された日付または時刻。

iOS 8.0+ iPadOS 8.0+ Mac Catalyst 13.0+ macOS 10.9+

tvOS 9.0+ visionOS 1.0+ watchOS 2.0+ Xcode 8.0+

struct DateComponents

概観

DateComponents は、日付のコンポーネントを拡張可能で構造化された方法でカプセル化します。

特定のカレンダーで日付と時刻を構成する時間コンポーネント (時間、分、秒、日、月、年など) を提供することで日付を指定するために使用されます。また、5 時間 16 分などの時間の長さを指定するためにも使用できます。すべてのコンポーネントフィールドを定義するために DateComponents は必要ありません。

DateComponents の新しいインスタンスが作成されると、日付コンポーネントは nil に設定されます。

トピックス

日付コンポーネントの初期化

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?)

日付コンポーネントの値を初期化し、オプションでそのフィールドの値を指定します。

var calendar: Calendar?

この構造体の他の値を解釈するために使用されるカレンダー。

var timeZone: TimeZone?

タイムゾーンです。

日付の検証

var isValidDate: Bool

現在のプロパティの組み合わせが現在のカレンダーに存在する日付を表すかどうかを示します。

func isValidDate(in: Calendar) -> Bool

現在のプロパティの組み合わせが、指定されたカレンダーに存在する日付を表しているかどうかを示します。

var date: Date?

保存されたカレンダーを使用して現在のコンポーネントから計算された日付。

月と年へのアクセス

一世紀または世紀の数。

一年または年数。

var yearForWeekOfYear: Int?

週を数える週に対応する年。

var quarter: Int?

四半期または四半期の数。

var month: Int?

一月または月の数。

var isLeapMonth: Bool?

これらのコンポーネントがうるう月を表す場合は true に設定します。

週と日へのアクセス

var weekOfMonth: Int?

月の一週、または月の週の数。

var weekOfYear: Int?

年の一週、または年の週の数。

var weekday: Int?

週日の一日または週日の数。

var weekdayOrdinal: Int?

週日の序数または週日の序数の数。

一日または日の数。

時間と秒へのアクセス

一時間または時間の数。

var minute: Int?

一分または分の数。

var second: Int?

一秒または秒の数。

var nanosecond: Int?

一ナノ秒またはナノ秒の数。

カレンダーコンポーネントへのアクセス

func value(for: Calendar.Component) -> Int?

プロパティ名の代わりに列挙値を使用して、プロパティの 1 つの値を返します。

func setValue(Int?, for: Calendar.Component)

プロパティ名の代わりに列挙値を使用して、プロパティの 1 つの値を設定します。

enum Calendar.Component

カレンダーの日付のさまざまなコンポーネントの列挙。

日付コンポーネントの比較

static func != (DateComponents, DateComponents) -> Bool

2 つの値が等しくないかどうかを示すブール値を返します。

static func == (DateComponents, DateComponents) -> Bool

2 つの日付コンポーネントインスタンスが同じかどうかを示します。

日付コンポーネントの説明

var description: String

日付コンポーネントのテキストによる説明。

var debugDescription: String

デバッグに適した日付コンポーネントのテキストによる説明。

var customMirror: Mirror

日付を映す鏡。

var hashValue: Int

計算された日付のハッシュ値。

参照型の使用

class NSDateComponents

DateComponents にブリッジするカレンダー単位で日付または時刻を指定するオブジェクト。参照の意味やその他の Foundation 固有の動作が必要な場合は、NSDateComponents を使用して下さい。

typealias DateComponents.ReferenceType

この値型と同等の参照型のエイリアス。

型エイリアス

typealias DateComponents.Specification

typealias DateComponents.UnwrappedType

typealias DateComponents.ValueType

イニシャライザ

init(from: any Decoder)

init(subscriptionPeriod: Product.SubscriptionPeriod)

インスタンスプロパティ

var dayOfYear: Int?

型プロパティ

static var defaultResolverSpecification: ResolverSpecification

インスタンスメソッド

func encode(to: any Encoder)

func hash(into: inout Hasher)

関連

以下に準拠

CustomDebugStringConvertible

CustomReflectable

CustomStringConvertible

ReferenceConvertible

以下も見よ

暦の計算

struct Calendar

カレンダー単位と絶対時点の関係の定義。日付の計算と比較の機能を提供します。

struct TimeZone

特定の地政学的地域に関連する標準時の慣習に関する情報。

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ