Structure

TimeZone

Information about standard time conventions associated with a specific geopolitical region. 指定された地政学的境界に関連付けられる標準的時刻慣例についての情報。

Declaration 宣言 

struct TimeZone

Overview 概要

TimeZone defines the behavior of a time zone. Time zone values represent geopolitical regions. Consequently, these values have names for these regions. Time zone values also represent a temporal offset, either plus or minus, from Greenwich Mean Time (GMT) and an abbreviation (such as PST for Pacific Standard Time). TimeZoneは、あるタイムゾーンの挙動を定義します。タイムゾーン値それらは、地政学的境界それらを表します。その結果として、それらの値は、それら領域の名前を持ちます。タイムゾーン値はまた、グリニッジ標準時（GMT）からの、足すか引くかどちらかでの、時間的相殺そして略語（たとえば太平洋標準時にはPSTなど）も表します。

TimeZone provides two static functions to get time zone values: current and autoupdatingCurrent. The autoupdatingCurrent time zone automatically tracks updates made by the user. TimeZoneは、２つの静的関数を提供して、タイムゾーン値：currentおよびautoupdatingCurrentを取得します。autoupdatingCurrentタイムゾーンは、ユーザによってなされる更新を自動的に追跡します。

Note that time zone database entries such as “America/Los_Angeles” are IDs, not names. An example of a time zone name is “Pacific Daylight Time”. Although many TimeZone functions include the word “name”, they refer to IDs. タイムゾーンデータベース登録項目、たとえば “America/Los_Angeles” などは、IDです、名前でなく。タイムゾーン名の一例は、 “Pacific Daylight Time（太平洋夏時間）” です。多くのTimeZone関数が単語 “name” を含むとはいえ、それらはIDを参照します。

Cocoa does not provide any API to change the time zone of the computer, or of other applications. Cocoaは、コンピュータの、または他のアプリケーションのタイムゾーンを変更するために、どのようなAPIも提供しません。

Topics 話題

Getting the Current Time Zone 現在のタイムゾーンを取得する

static var autoupdatingCurrent: TimeZone
The time zone currently used by the system, automatically updating to the user’s current preference. システムによって現在使われるタイムゾーン、自動的にユーザのもつ現在の環境設定に更新します。
static var current: TimeZone
The time zone currently used by the system. 現在システムによって使われるタイムゾーン。

Creating a Time Zone タイムゾーンを作成する

init?(secondsFromGMT: Int)
Returns a time zone initialized with a specific number of seconds from GMT. GMTから指定された秒数で初期化されたタイムゾーンを返します。
static var knownTimeZoneIdentifiers: [String]
Returns an array of strings listing the identifier of all the time zones known to the system. システムに既知の全てのタイムゾーンの識別子を列記する文字列それらからなるある配列を返します。
static var abbreviationDictionary: [String : String]
Returns the mapping of abbreviations to time zone identifiers. 略語のタイムゾーン識別子への対応づけを返します。

Getting Time Zone Information タイムゾーン情報を得る

var identifier: String
The geopolitical region identifier that identifies the time zone. そのタイムゾーンを識別する地政学的境界識別子。
func abbreviation(for: Date) -> String?
Returns the abbreviation for the time zone at a given date. 与えられた日付でのそのタイムゾーンに対する略語を返します。
func secondsFromGMT(for: Date) -> Int
The current difference in seconds between the time zone and Greenwich Mean Time. タイムゾーンとグリニッジ標準時の間の秒での現在の差異。
static var timeZoneDataVersion: String
Returns the time zone data version. タイムゾーンデータバージョンを返します。

Working with Daylight Savings 夏時間を扱う

func isDaylightSavingTime(for: Date) -> Bool
Returns a Boolean value that indicates whether the receiver uses daylight saving time at a given date. レシーバが夏時間をある与えられた日付で使用するかどうかを指し示すブール値を返します。
func daylightSavingTimeOffset(for: Date) -> TimeInterval
Returns the daylight saving time offset for a given date. ある与えられた日付に対する夏時間とのズレ。
var nextDaylightSavingTimeTransition: Date?
The date of the next (after the current instant) daylight saving time transition for the time zone. このタイムゾーンに対する次の（現在のインスタンスの後の）夏時間移行の日付。
func nextDaylightSavingTimeTransition(after: Date) -> Date?
Returns the next daylight saving time transition after a given date. 与えられた日付の後の次の夏時間移行を返します。

Comparing Time Zones タイムゾーンを比較する

static func != (TimeZone, TimeZone) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。
static func == (TimeZone, TimeZone) -> Bool
Indicates whether two time zones are the same. ２つのタイムゾーンが同じかどうかを指し示します。

Describing Time Zones タイムゾーンを記述する

func localizedName(for: NSTimeZone.NameStyle, locale: Locale?) -> String?
Returns the name of the receiver localized for a given locale. 与えられたロケールにローカライズされたレシーバの名前を返します。
var description: String
A textual description of the time zone. タイムゾーンのテキスト表現。
var debugDescription: String
A textual description of the time zone suitable for debugging. デバッグに適したタイムゾーンのテキスト記述。
var customMirror: Mirror
A mirror that reflects the time zone. タイムゾーンを反映するミラー。
var hashValue: Int
The computed hash value of the time zone. タイムゾーンの計算ハッシュ値。

Using Reference Types 参照型を使用する

class NSTimeZone
Information about local time conventions that bridges to TimeZone; use NSTimeZone when you need reference semantics or other Foundation-specific behavior. TimeZoneにブリッジするローカル時間慣例についての情報；あなたが参照意味論や他のFoundation特有の挙動を必要とする場合にNSTimeZoneを使ってください。
typealias TimeZone.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Initializers イニシャライザ

init?(abbreviation: String)
init(from: Decoder)
init?(identifier: String)

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

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