ZonedDateTime Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Дата и время с часовой поясом в системе календаря ISO-8601, например 2007-12-03T10:15:30+01:00 Europe/Paris.
[Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZonedDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoZonedDateTime
[<Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type ZonedDateTime = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IChronoZonedDateTime
interface IComparable
interface ITemporal
interface ITemporalAccessor
- Наследование
- Атрибуты
- Реализации
Комментарии
Дата и время с часовой поясом в системе календаря ISO-8601, например 2007-12-03T10:15:30+01:00 Europe/Paris.
ZonedDateTime — неизменяемое представление даты и времени с часовым поясом. Этот класс сохраняет все поля даты и времени в точности наносекунд и часового пояса с смещением зоны, используемым для обработки неоднозначных локальных даты и времени. Например, значение "2-е октября 2007 г. в 13:45.30.123456789 +02:00 в часовом поясе Европы/Парижа" может храниться в пределах ZonedDateTime.
Этот класс обрабатывает преобразование из локальной строки LocalDateTime времени в моментальную строку Instantвремени. Разница между двумя временными линиями — смещение от UTC/Greenwich, представленное в виде ZoneOffset.
Преобразование между двумя временными строками включает вычисление смещения с помощью ZoneRules rules доступа из.ZoneId Получение смещения для мгновенного экземпляра просто, так как для каждого экземпляра существует ровно одно допустимое смещение. В отличие от этого, получение смещения для локального даты и времени не является простым. Существует три случая: <ul><li>Normal, с одним допустимым смещением. Для подавляющего большинства года обычное дело применяется, если существует одно допустимое смещение для локального времени даты.</li li><>Gap с нуля допустимыми смещениями. Это происходит, когда часы прыгают вперед, как правило, из-за весенней летней экономии смены с "зима" на "лето". В разрыве имеются локальные значения даты и времени без допустимого смещения.</li li><>Overlap с двумя допустимыми смещениями. Это происходит, когда часы устанавливаются обратно, как правило, из-за осеннего летнего сберегательного перехода с "лета" на "зиму". В перекрытии имеются локальные значения даты и времени с двумя допустимыми смещениями.</li></ul>
Любой метод, который преобразуется непосредственно или неявно из локального даты и времени в момент, получив смещение, может быть сложным.
Для пробелов общая стратегия заключается в том, что если местное время даты и даты падает в середине пробела, то результирующее время даты даты и даты будет перенесено на длину пробела, в результате чего время даты в дальнейшем смещение, обычно "лето".
Для перекрытий общая стратегия заключается в том, что если локальное время даты падает в середине перекрытия, то предыдущее смещение будет сохранено. Если предыдущее смещение отсутствует или предыдущее смещение недопустимо, используется более раннее смещение, обычно "лето". Два дополнительных метода #withEarlierOffsetAtOverlap() и #withLaterOffsetAtOverlap()управление случаем перекрытия.
С точки зрения дизайна этот класс должен рассматриваться в первую очередь как сочетание a LocalDateTime и a ZoneId. Это ZoneOffset жизненно важно, но вторичная часть информации, используемая для обеспечения того, что класс представляет моментальный, особенно во время перекрытия дневного света.
Добавлено в версии 1.8.
Java документации по java.time.ZonedDateTime.
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
Свойства
| Имя. | Описание |
|---|---|
| Class |
Возвращает класс среды выполнения этого |
| DayOfMonth |
Возвращает поле "День месяца". |
| DayOfWeek |
Возвращает поле дня недели, которое является перечислением DayOfWeek. |
| DayOfYear |
Возвращает поле дня года. |
| Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
| Hour |
Возвращает часовое поле. |
| JniIdentityHashCode |
Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object) |
| JniManagedPeerState |
Возвращает флаги состояния, назначенные средой выполнения. (Унаследовано от JavaObject) |
| JniPeerMembers |
Возвращает метаданные JNI, используемые для доступа к членам этой привязки Java. |
| Minute |
Возвращает минутное поле. |
| Month |
Возвращает поле месяца с использованием перечисления "Месяц". |
| MonthValue |
Возвращает поле месяца с 1 по 12. |
| Nano |
Возвращает поле nano-of-second. |
| Offset |
Возвращает смещение зоны, например "+01:00". |
| PeerReference |
Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object) |
| Second |
Возвращает второе поле. |
| ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| Year |
Возвращает поле года. |
| Zone |
Получает часовой пояс, например "Европа/Париж". |
Методы
| Имя. | Описание |
|---|---|
| Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
| CompareTo(Object) |
Сравнивает этот объект с указанным объектом для заказа. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Делегирует создание этого однорангового узла диспетчеру значений среды выполнения. (Унаследовано от JavaObject) |
| Dispose() |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| Dispose(Boolean) |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| DisposeUnlessReferenced() |
Запрашивает диспетчер значений удалить этот одноранговый узел, если его сопоставление не сохраняет этот управляемый экземпляр. (Унаследовано от JavaObject) |
| Equals(Object) |
Проверяет, относится ли другой управляемый одноранговый узел к тому же объекту Java. (Унаследовано от JavaObject) |
| Equals(Object) |
Указывает, равен ли другой объект этому объекту. (Унаследовано от Object) |
| Format(DateTimeFormatter) |
Форматирует этот формат даты и времени с помощью указанного средства форматирования. |
| From(ITemporalAccessor) |
Получает экземпляр ZonedDateTime из темпорального объекта. |
| Get(ITemporalField) |
Возвращает значение указанного поля из этого значения даты и времени в виде int. |
| GetHashCode() |
Возвращает хэш-значение кода для объекта. (Унаследовано от Object) |
| GetLong(ITemporalField) |
Возвращает значение указанного поля из этого даты и времени в течение длительного времени. |
| IsSupported(ITemporalField) |
Проверяет, поддерживается ли указанное поле. |
| IsSupported(ITemporalUnit) |
Проверяет, поддерживается ли указанная единица. |
| JavaFinalize() |
Устаревшие.
Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object) |
| Minus(Int64, ITemporalUnit) |
Возвращает копию этого даты и времени с указанной суммой, вычитаемой. |
| Minus(ITemporalAmount) |
Возвращает копию этого даты и времени с указанной суммой, вычитаемой. |
| MinusDays(Int64) |
Возвращает копию этого zonedDateTime с указанным числом дней, вычитаемых. |
| MinusHours(Int64) |
Возвращает копию этого zonedDateTime с указанным числом часов, вычитаемых. |
| MinusMinutes(Int64) |
Возвращает копию этого zonedDateTime с указанным числом минут, вычитаемых. |
| MinusMonths(Int64) |
Возвращает копию этого zonedDateTime с указанным числом месяцев, вычитаемых. |
| MinusNanos(Int64) |
Возвращает копию этого zonedDateTime с указанным числом наносекунд, вычитаемых. |
| MinusSeconds(Int64) |
Возвращает копию этого zonedDateTime с указанным количеством секунд, вычитаемых. |
| MinusWeeks(Int64) |
Возвращает копию этого zonedDateTime с указанным числом недель, вычитаемых. |
| MinusYears(Int64) |
Возвращает копию этого zonedDateTime с указанным числом вычитаемых лет. |
| Notify() |
Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object) |
| NotifyAll() |
Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object) |
| Now() |
Получает текущее время даты из системных часов в часовом поясе по умолчанию. |
| Now(Clock) |
Получает текущее время даты из указанных часов. |
| Now(ZoneId) |
Получает текущее время даты из системных часов в указанном часовом поясе. |
| Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId) |
Получает экземпляр ZonedDateTime из года, месяца, дня, часа, минуты, секунды, наносекунда и часового пояса. |
| Of(LocalDate, LocalTime, ZoneId) |
Получает экземпляр ZonedDateTime из локальной даты и времени. |
| Of(LocalDateTime, ZoneId) |
Получает экземпляр ZonedDateTime из локального даты и времени. |
| OfInstant(Instant, ZoneId) |
Получает экземпляр ZonedDateTime из мгновенного экземпляра. |
| OfInstant(LocalDateTime, ZoneOffset, ZoneId) |
Получает экземпляр ZonedDateTime из мгновенного формирования путем объединения локального времени даты и смещения. |
| OfLocal(LocalDateTime, ZoneId, ZoneOffset) |
Получает экземпляр ZonedDateTime из локального времени даты и времени, используя предпочтительное смещение, если это возможно. |
| OfStrict(LocalDateTime, ZoneOffset, ZoneId) |
Получает экземпляр ZonedDateTime строго проверяющий сочетание локального даты и времени, смещения и идентификатора зоны. |
| Parse(ICharSequence, DateTimeFormatter) |
Получает экземпляр ZonedDateTime из текстовой строки с помощью определенного средства форматирования. |
| Parse(ICharSequence) |
Получает экземпляр ZonedDateTime из текстовой строки, например 2007-12-03T10:15:30+01:00[Европа/Париж]. |
| Parse(String, DateTimeFormatter) |
Анализирует строку даты и времени между зонами с указанным форматировщиком. |
| Parse(String) |
Анализирует дату и время ISO с часовым поясом из строки. |
| Plus(Int64, ITemporalUnit) |
Возвращает копию этого даты и времени с указанным объемом, добавленным. |
| Plus(ITemporalAmount) |
Возвращает копию этого даты и времени с указанным объемом, добавленным. |
| PlusDays(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных дней. |
| PlusHours(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных часов. |
| PlusMinutes(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных минут. |
| PlusMonths(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных месяцев. |
| PlusNanos(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных наносекунд. |
| PlusSeconds(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных секунд. |
| PlusWeeks(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных недель. |
| PlusYears(Int64) |
Возвращает копию этого zonedDateTime с указанным числом добавленных лет. |
| Query(ITemporalQuery) |
Запрашивает этот период даты и времени с помощью указанного запроса. |
| Range(ITemporalField) |
Возвращает диапазон допустимых значений для указанного поля. |
| SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Сохраняет значение ссылки в блоке управления без создания копии ссылки JNI. (Унаследовано от JavaObject) |
| ToArray<T>() |
Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object) |
| ToLocalDate() |
Возвращает часть localDate этого даты и времени. |
| ToLocalDateTime() |
Возвращает часть LocalDateTime этого даты и времени. |
| ToLocalTime() |
Возвращает часть LocalTime этого даты и времени. |
| ToOffsetDateTime() |
Преобразует этот параметр даты и времени в OffsetDateTime. |
| ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
| TruncatedTo(ITemporalUnit) |
Возвращает копию этого zonedDateTime с усеченным временем. |
| UnregisterFromRuntime() |
Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object) |
| Until(ITemporal, ITemporalUnit) |
Вычисляет время до другого даты и времени с точки зрения указанной единицы. |
| Wait() |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object) |
| Wait(Int64, Int32) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
| Wait(Int64) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
| With(ITemporalAdjuster) |
Возвращает скорректированную копию этой даты и времени. |
| With(ITemporalField, Int64) |
Возвращает копию этого даты и времени с указанным полем, заданным для нового значения. |
| WithDayOfMonth(Int32) |
Возвращает копию этого zonedDateTime с измененным днем месяца. |
| WithDayOfYear(Int32) |
Возвращает копию этого zonedDateTime с изменением дня года. |
| WithEarlierOffsetAtOverlap() |
Возвращает копию этого смещения даты и времени, изменив смещение зоны на более ранние из двух допустимых смещения в локальной строке времени. |
| WithFixedOffsetZone() |
Возвращает копию этого даты и времени с идентификатором зоны, заданным для смещения. |
| WithHour(Int32) |
Возвращает копию этого zonedDateTime с изменением часа дня. |
| WithLaterOffsetAtOverlap() |
Возвращает копию этого даты и времени, изменяющую смещение зоны на более поздние два допустимых смещения в локальной строке времени. |
| WithMinute(Int32) |
Возвращает копию этого zonedDateTime с изменением минуты часа. |
| WithMonth(Int32) |
Возвращает копию этого zonedDateTime с измененным месяцем года. |
| WithNano(Int32) |
Возвращает копию этого zonedDateTime с измененным nano-of-second. |
| WithSecond(Int32) |
Возвращает копию этого zonedDateTime со второй минутой изменения. |
| WithYear(Int32) |
Возвращает копию этого zonedDateTime с измененным годом. |
| WithZoneSameInstant(ZoneId) |
Возвращает копию этого даты и времени с другим часовыми поясами, сохраняя момент. |
| WithZoneSameLocal(ZoneId) |
Возвращает копию этого даты и времени с другим часовыми поясами, сохраняя локальное время даты и времени, если это возможно. |
Явные реализации интерфейса
| Имя. | Описание |
|---|---|
| IChronoZonedDateTime.Plus(Int64, ITemporalUnit) |
Возвращает объект того же типа, что и этот объект с указанным периодом, добавленным. |
| IChronoZonedDateTime.ToLocalDateTime() |
Возвращает локальную часть даты и времени этого времени. |
| IChronoZonedDateTime.With(ITemporalField, Int64) |
Возвращает объект того же типа, что и этот объект с измененным полем. |
| IChronoZonedDateTime.WithEarlierOffsetAtOverlap() |
Возвращает копию этого смещения даты и времени, изменив смещение зоны на более ранние из двух допустимых смещения в локальной строке времени. |
| IChronoZonedDateTime.WithLaterOffsetAtOverlap() |
Возвращает копию этого даты и времени, изменяющую смещение зоны на более поздние два допустимых смещения в локальной строке времени. |
| IChronoZonedDateTime.WithZoneSameInstant(ZoneId) |
Возвращает копию этого даты и времени с другим часовыми поясами, сохраняя момент. |
| IChronoZonedDateTime.WithZoneSameLocal(ZoneId) |
Возвращает копию этого даты и времени с другим часовыми поясами, сохраняя локальное время даты и времени, если это возможно. |
| IJavaPeerable.Disposed() |
Помечает этот одноранговый узел как удаленный и вызовы |
| IJavaPeerable.Finalized() |
Помечает этот одноранговый узел как удаленный и вызовы |
| IJavaPeerable.JniObjectReferenceControlBlock |
Возвращает собственный указатель блока управления, используемый этим одноранговым элементом. (Унаследовано от JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Хранит хэш-код удостоверения, предоставленный средой выполнения. (Унаследовано от JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Заменяет сохраненные флаги управляемого однорангового узла. (Унаследовано от JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Обновляет ссылку на одноранговый узел и освобождает блок управления удаленного однорангового узла, если ссылка недопустима. (Унаследовано от JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Удаляет этот экземпляр из Java объекта среды выполнения. |
Методы расширения
| Имя. | Описание |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Возвращает имя JNI типа экземпляра |
| JavaAs<TResult>(IJavaPeerable) |
Попробуйте принуждать к типу |
| JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
| JavaCast<TResult>(IJavaObject) |
Повторно использует совместимый управляемый одноранговый узел или получает оболочку запрошенного типа. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Попробуйте принуждать к типу |