ZoneId Класс

Определение

Пространство имен:: Java.Time

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Идентификатор часового пояса, например Europe/Paris.

[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

Используется ZoneId для идентификации правил, используемых для преобразования между a Instant и a LocalDateTime. Существует два разных типа идентификаторов: <ul><li>Фиксированные смещения — полностью разрешенное смещение от UTC/Greenwich, которое использует одинаковое смещение для всех локальных регионов даты и времени <li>— область, в которой определенный набор правил для поиска смещения из UTC/Greenwich применить </ul> Большинство фиксированных смещения представлены ZoneOffset. Вызов любого #normalized() будет гарантировать, что фиксированный идентификатор смещения будет представлен в виде ZoneId.ZoneOffset

Фактические правила, описывающие, когда и как изменяется смещение, определяются ZoneRules. Этот класс является просто идентификатором, используемым для получения базовых правил. Этот подход применяется, так как правила определяются правительствами и часто изменяются, в то время как идентификатор является стабильным.

Различие имеет другие последствия. Сериализация будет отправлять только идентификатор, а сериализация ZoneId правил отправляет весь набор данных. Аналогичным образом сравнение двух идентификаторов проверяет только идентификатор, в то время как сравнение двух правил проверяет весь набор данных.

<h2>Идентификаторы часовых поясов</h2> Идентификаторы уникальны в системе. Существует три типа идентификатора.

Самый простой тип идентификатора заключается в том, что из ZoneOffset. Это состоит из "Z" и идентификаторов, начиная с "+" или "-".

Следующий тип идентификатора — идентификаторы в стиле смещения с некоторыми формами префикса, например GMT+2 или UTC+01:00. Признанные префиксы : UTC, GMT и UT. Смещение является суффиксом и будет нормализовано во время создания. Эти идентификаторы можно нормализовать для ZoneOffset использования normalized().

Третий тип идентификатора — идентификаторы на основе региона. Идентификатор на основе региона должен иметь два или более символов, а не начинаться с "UTC", "GMT", "UT" "+" или "-". Идентификаторы на основе региона определяются конфигурацией. Конфигурация фокусируется на предоставлении подстановки из идентификатора в базовый ZoneRules.

Правила часового пояса определяются правительствами и часто изменяются. Существует ряд организаций, известных здесь как группы, которые отслеживают изменения часового пояса и сопоставляют их. Группа по умолчанию — это база данных часового пояса IANA (TZDB). Другие организации включают IATA (орган отрасли авиакомпаний) и Microsoft.

Каждая группа определяет собственный формат для идентификатора региона, который он предоставляет. Группа TZDB определяет идентификаторы, такие как "Европа/Лондон" или "Америка/New_York". Идентификаторы TZDB имеют приоритет над другими группами.

Настоятельно рекомендуется включить имя группы во все идентификаторы, предоставляемые группами, кроме TZDB, чтобы избежать конфликтов. Например, идентификаторы региона часового пояса авиакомпании IATA обычно совпадают с кодом трех букв аэропорта. Однако в аэропорту Utrecht есть код "UTC", который, очевидно, конфликт. Рекомендуемый формат идентификаторов регионов из групп, отличных от TZDB, — group~region. Таким образом, если были определены данные IATA, аэропорт Utrecht будет "IATA~UTC".

<h2>Serialization</h2> Этот класс можно сериализовать и хранить идентификатор зоны строки во внешней форме. Подкласс ZoneOffset использует выделенный формат, который сохраняет смещение только из UTC/Greenwich.

Можно ZoneId десериализировать в среде выполнения Java, где идентификатор неизвестен. Например, если серверная среда выполнения Java обновлена с новым идентификатором зоны, но клиентская Java Runtime не была обновлена. В этом случае ZoneId объект будет существовать и может запрашиваться с помощью getId, , equals, hashCodeи toStringgetDisplayName. normalized Однако любой вызов завершится getRules ошибкой ZoneRulesException. Этот подход предназначен для загрузки ZonedDateTime и запроса, но не изменения в среде выполнения Java с неполными сведениями часового пояса.

Добавлено в версии 1.8.

Java документации по java.time.ZoneId.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Конструкторы

Имя.	Описание
ZoneId(IntPtr, JniHandleOwnership)	Идентификатор часового пояса, например `Europe/Paris`.

Свойства

Имя.	Описание
AvailableZoneIds	Возвращает набор идентификаторов доступных зон.
Class	Возвращает класс среды выполнения этого `Object`объекта. (Унаследовано от Object)
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
Id	Возвращает уникальный идентификатор часового пояса.
JniIdentityHashCode	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
JniPeerMembers	Идентификатор часового пояса, например `Europe/Paris`.
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
Rules	Возвращает правила часового пояса для этого идентификатора, позволяя выполнять вычисления.
ShortIds	Идентификатор часового пояса, например `Europe/Paris`.
ThresholdClass	Идентификатор часового пояса, например `Europe/Paris`.
ThresholdType	Идентификатор часового пояса, например `Europe/Paris`.

Методы

Имя.	Описание
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
Equals(Object)	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
From(ITemporalAccessor)	Получает экземпляр ZoneId из темпорального объекта.
GetDisplayName(TextStyle, Locale)	Получает текстовое представление зоны, например "Британское время" или "+02:00".
GetHashCode()	Возвращает хэш-значение кода для объекта. (Унаследовано от Object)
JavaFinalize()	Устаревшие. Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
Normalized()	Нормализует идентификатор часового пояса, возвращая ZoneOffset по возможности.
Notify()	Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
Of(String, IDictionary<String,String>)	Получает экземпляр ZoneId с помощью его идентификатора с помощью карты псевдонимов, чтобы дополнить идентификаторы стандартной зоны.
Of(String)	Получает экземпляр ZoneId из идентификатора, гарантируя, что идентификатор действителен и доступен для использования.
OfOffset(String, ZoneOffset)	Получает экземпляр ZoneId, упаковав смещение.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
SystemDefault()	Идентификатор часового пояса, например `Europe/Paris`.
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

Явные реализации интерфейса

Имя.	Описание
IJavaPeerable.Disposed()	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Идентификатор часового пояса, например `Europe/Paris`. (Унаследовано от JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Идентификатор часового пояса, например `Europe/Paris`.

Методы расширения

Имя.	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Идентификатор часового пояса, например `Europe/Paris`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к