構造体


TimeZone


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


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

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

struct TimeZone





概観


TimeZone は、タイムゾーンの動作を定義します。タイムゾーンの値は、地政学的地域を表します。したがって、これらの値には、これらの地域の名前があります。タイムゾーンの値は、グリニッジ標準時 (GMT) からのプラスまたはマイナスの時間オフセットと略語 (太平洋標準時の場合は PST など) も表します。


TimeZone には、タイムゾーンの値を取得するための 2 つの静的関数 (currentautoupdatingCurrent) が用意されています。autoupdatingCurrent タイムゾーンは、ユーザによる更新を自動的に追跡します。


"America/Los_Angeles" などのタイムゾーンデータベースエントリは、名前ではなく ID であることに注意してください。タイムゾーン名の例としては、"Pacific Daylight Time" があります。多くの TimeZone 関数には "name" という単語が含まれていますが、これらは ID を参照します。


Cocoa は、コンピューターや他のアプリケーションのタイムゾーンを変更するための API を提供していません。





トピックス


現在の Time Zone を取得


static var autoupdatingCurrent: TimeZone

システムで現在使用されているタイムゾーン。ユーザの現在の設定に自動的に更新されます。


static var current: TimeZone

システムで現在使用されているタイムゾーン。



タイムゾーンの作成


init?(secondsFromGMT: Int)

GMT からの特定の秒数で初期化されたタイム ゾーンを返します。


static var knownTimeZoneIdentifiers: [String]

システムに既知のすべてのタイムゾーンの識別子をリストする文字列の配列を返します。


static var abbreviationDictionary: [String : String]

タイムゾーン識別子への略語のマッピングを返します。



タイムゾーン情報の取得


var identifier: String

タイムゾーンを識別する地政学的地域識別子。


func abbreviation(for: Date) -> String?

与えられた日付のタイムゾーンの略語を返します。


func secondsFromGMT(for: Date) -> Int

タイムゾーンとグリニッジ標準時との現在の差(秒単位)。


static var timeZoneDataVersion: String

タイムゾーン データのバージョンを返します。



夏時間での作業


func isDaylightSavingTime(for: Date) -> Bool

受信側が与えられた日付に夏時間を使用するかどうかを示すブール値を返します。


func daylightSavingTimeOffset(for: Date) -> TimeInterval

与えられた日付の夏時間オフセットを返します。


var nextDaylightSavingTimeTransition: Date?

タイムゾーンの次の(現在の時点の後の)夏時間移行の日付。


func nextDaylightSavingTimeTransition(after: Date) -> Date?

与えられた日付以降の次の夏時間移行を返します。



タイムゾーンの比較


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

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


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

2 つのタイムゾーンが同じかどうかを示します。



タイムゾーンの説明


func localizedName(for: TimeZone.NameStyle, locale: Locale?) -> String?

与えられたロケールにローカライズされた受信者の名前を返します。


var description: String

タイムゾーンのテキストによる説明。


var debugDescription: String

デバッグに適したタイムゾーンのテキストによる説明。


var customMirror: Mirror

タイムゾーンを映し出す鏡。


var hashValue: Int

タイムゾーンの計算されたハッシュ値。



関連型の使用


class NSTimeZone

TimeZone にブリッジするローカル時間規則に関する情報。参照の意味やその他の Foundation 固有の動作が必要な場合は、NSTimeZone を使用して下さい。


typealias TimeZone.ReferenceType

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



型エイリアス


typealias TimeZone.NameStyle



イニシャライザ


init?(abbreviation: String)

init(from: any Decoder)

init?(identifier: String)



型プロパティ


static var gmt: TimeZone



インスタンスメソッド


func encode(to: any Encoder)

func hash(into: inout Hasher)





関連


以下に準拠


CustomDebugStringConvertible

CustomReflectable

CustomStringConvertible

Decodable

Encodable

Hashable

ReferenceConvertible

Sendable





以下も見よ


暦の計算


struct DateComponents

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


struct Calendar

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














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ