ZoneId クラス

定義

[Android.Runtime.Register("java/time/ZoneId", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class ZoneId : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/time/ZoneId", ApiSince=26, DoNotGenerateAcw=true)>]
type ZoneId = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承

Object

JavaObject

Object

ZoneId

派生

Java.Time.ZoneOffset

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable ISerializable IDisposable

注釈

Europe/Parisなどのタイム ゾーン ID。

ZoneIdは、InstantとLocalDateTimeの間の変換に使用される規則を識別するために使用されます。 ID には、 <ul><li>Fixed offsets という 2 種類があります。UTC/グリニッジからの完全に解決されたオフセットです。これは、すべてのローカル日時 <li>地理領域に対して同じオフセットを使用します。UTC/グリニッジからのオフセットを見つけるための特定のルールセットが <適用される領域> ほとんどの固定オフセットは ZoneOffsetで表されます。 #normalized()でZoneIdを呼び出すと、固定オフセット ID がZoneOffsetとして表されることが保証されます。

オフセットがいつどのように変化するかを説明する実際のルールは、 ZoneRulesによって定義されます。 このクラスは、基になる規則を取得するために使用される単なる ID です。 このアプローチは、規則が政府によって定義され、頻繁に変更されるのに対し、ID は安定しているためです。

区別には他の効果があります。 ZoneIdをシリアル化すると ID のみが送信されますが、ルールをシリアル化するとデータ セット全体が送信されます。 同様に、2 つの ID の比較では ID のみが調べられますが、2 つのルールの比較ではデータ セット全体が調べられます。

<h2>Time-zone ID</h2> ID はシステム内で一意です。 ID には 3 種類あります。

最も簡単な種類の ID は、 ZoneOffsetからの ID です。 これは、'Z' と '+' または '-' で始まる ID で構成されます。

次の種類の ID は、"GMT+2" や "UTC+01:00" など、何らかの形式のプレフィックスを持つオフセット スタイルの ID です。 認識されるプレフィックスは、'UTC'、'GMT'、および 'UT' です。 オフセットはサフィックスであり、作成時に正規化されます。 これらの ID は、ZoneOffsetを使用してnormalized()に正規化できます。

3 番目の種類の ID は、リージョンベースの ID です。 リージョンベースの ID は 2 つ以上の文字である必要があり、'UTC'、'GMT'、'UT' '+' または '-' で始まるものではありません。 リージョンベースの ID は、構成によって定義されます。 この構成では、ID から基になる ZoneRulesへの参照を提供することに重点を置いています。

タイム ゾーン ルールは政府によって定義され、頻繁に変更されます。 ここでは、タイム ゾーンの変更を監視して照合する組織が多数存在します。これはグループと呼ばれます。 既定のグループは IANA タイム ゾーン データベース (TZDB) です。 その他の組織には、IATA (航空会社の業界団体) とMicrosoftがあります。

各グループは、提供するリージョン ID に対して独自の形式を定義します。 TZDB グループは、"Europe/London" や "America/New_York" などの ID を定義します。 TZDB ID は他のグループよりも優先されます。

競合を回避するために、グループ名は TZDB 以外のグループによって提供されるすべての ID に含まれることを強くお勧めします。 たとえば、IATA 航空会社のタイム ゾーンリージョン ID は、通常、3 文字の空港コードと同じです。 しかし、ユトレヒトの空港にはコード 'UTC' があり、これは明らかに競合しています。 TZDB 以外のグループからのリージョン ID に推奨される形式は、"group~region" です。 したがって、IATA データが定義されている場合、ユトレヒト空港は "IATA~UTC" になります。

<h2>Serialization</h2> このクラスはシリアル化して、文字列ゾーン ID を外部形式で格納できます。 ZoneOffset サブクラスは、UTC/グリニッジからのオフセットのみを格納する専用の形式を使用します。

ZoneIdは、ID が不明なJava ランタイムで逆シリアル化できます。 たとえば、サーバー側のJava ランタイムが新しいゾーン ID で更新されたが、クライアント側の Java ランタイムが更新されていない場合などです。 この場合、 ZoneId オブジェクトが存在し、 getId、 equals、 hashCode、 toString、 getDisplayName 、および normalizedを使用してクエリを実行できます。 ただし、 getRules の呼び出しは、 ZoneRulesExceptionで失敗します。 このアプローチは、不完全なタイム ゾーン情報を含むJava ランタイムで、ZonedDateTimeを読み込んでクエリを実行できるように設計されていますが、変更は行われません。

1.8 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。