XCode 9.4 日本語化計画:Foundation: TimeInterval

文書   >   Foundation   >   Dates and Times   >   TimeZone

構造体

TimeZone

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

概要

TimeZone は、タイムゾーンの動作を定義します。タイムゾーン値は地政学的地域を表します。結果として、これらの値はこれらの領域の名前を持ちます。タイムゾーン値はまた、グリニッジ標準時 (GMT) と省略形 (太平洋標準時の PST など) からの時間オフセット (プラスまたはマイナスのいずれか) も表します。

TimeZone は、タイムゾーン値を取得するための 2 つの静的関数 current および autoupdatingCurrent を提供します。autoupdating のタイムゾーンは、ユーザーが行った更新を自動的に追跡します。

"America/Los_Angeles" のようなタイムゾーンデータベースエントリは ID であり、名前ではない事に注意して下さい。タイムゾーンの名前の一例は "太平洋夏時間" です。多くの TimeZone 関数には "name" という単語が含まれていますが、それらは ID を参照します。

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

トピックス

現在のタイムゾーンの取得

static var autoupdatingCurrent: TimeZone




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




static var current: TimeZone




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

タイムゾーンの作成

init?(identifier: String)




与えられた識別子で初期化されたタイムゾーンを返します。




init?(abbreviation: String)




与えられた省略形によって識別されるタイムゾーンを返します。




init?(secondsFromGMT: Int)




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




static var knownTimeZoneIdentifiers: [String]




システムが認識しているすべてのタイムゾーンの識別子を列挙する文字列の配列を返します。




static var abbreviationDictionary: [String : String]




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

タイムゾーン情報の取得

var identifier: String




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




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: NSTimeZone.NameStyle, locale: Locale?) -> String?




指定されたロケールに位置した受信者の名前を返します。




var description: String




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




var debugDescription: String




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




var customMirror: Mirror




タイムゾーンを反映するミラー。




var hashValue: Int




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

参照型の使用

class NSTimeZone




TimeZone に橋渡しをする現地時間慣習に関する情報。参照セマンティクスまたはその他の Foundation 固有の動作が必要な場合は、NSTimeZone を使用して下さい。




typealias TimeZone.ReferenceType




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

イニシャライザ

init(from: Decoder)

インスタンスメソッド

func encode(to: Encoder)

関連

以下に準拠