Instant Класс

Ссылка

Определение

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

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

Важно!

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

Мгновенная точка на временной линии.

[Android.Runtime.Register("java/time/Instant", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Instant : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.IComparable, Java.Time.Temporal.ITemporal, Java.Time.Temporal.ITemporalAdjuster

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

Наследование: Object

Object
Instant

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable ISerializable IComparable ITemporal ITemporalAccessor ITemporalAdjuster IDisposable

Для диапазона мгновенного требуется хранение числа, превышающего longзначение . Для этого класс хранит long значение , представляющее эпоху-секунды и int значение , представляющее наносекунд секунды, которые всегда будут находиться в диапазоне от 0 до 999 999 99999. Эпоха-секунды измеряются из стандартной эпохи Java, 1970-01-01T00:00:00Z где мгновения после эпохи имеют положительные значения, а более ранние — отрицательные. Для частей эпохи-секунды и наносекунд большее значение всегда позднее на временной линии, чем меньшее значение.

<h2>Time-scale</h2>

Продолжительность солнечного дня является стандартным способом, который люди измеряют время. Это традиционно было разделено на 24 часа 60 минут 60 секунд, образуя 86400 второй день.

Современное хронометрирование основано на атомарных часах, которые точно определяют секунду SI относительно переходов атома цезия. Длина секунды SI была определена очень близко к 86400-й доли дня.

К сожалению, по мере вращения Земли продолжительность дня меняется. Кроме того, со временем средняя продолжительность дня становится все длиннее, так как Земля замедляется. В результате продолжительность солнечного дня в 2012 году немного превышает 86400 секунд si. Фактическая продолжительность любого заданного дня и величина, на которую Земля замедляется, не предсказуемы и могут быть определены только по измерению. Шкала времени UT1 фиксирует точную продолжительность дня, но доступна только через некоторое время после завершения дня.

Шкала времени в формате UTC — это стандартный подход, который позволяет объединить все дополнительные доли секунды с UT1 в целые секунды, называемые високосными секундами. Високосная секунда может быть добавлена или удалена в зависимости от изменений вращения Земли. Таким образом, UTC позволяет деньу иметь 86399 секунд SI или 86401 секунды SI, если это необходимо, чтобы день был выровнен с Солнцем.

Современная шкала времени в формате UTC была введена в 1972 году, введя концепцию целых високосных секунд. В период с 1958 по 1972 год определение UTC было сложным, с незначительными скачками в секунду и изменением длины гонимой секунды. По состоянию на 2012 год ведутся обсуждения о том, чтобы снова изменить определение UTC, с потенциалом удаления високосных секунд или внесения других изменений.

Учитывая сложность точного хранения времени, описанную выше, этот API Java определяет собственную шкалу времени Java Time-Scale.

Java Time-Scale делит каждый календарный день на 86400 подразделений, которые называются секундами. Эти секунды могут отличаться от секунды SI. Она тесно соответствует де-факто международной шкале гражданского времени, определение которой время от времени меняется.

Java Time-Scale имеет несколько разные определения для разных сегментов временной линии, каждый из которых основан на консенсусной международной шкале времени, которая используется в качестве основы для гражданского времени. При изменении или замене согласованной на международном уровне шкалы времени для нее необходимо определить новый сегмент Time-Scale Java. Каждый сегмент должен соответствовать этим требованиям: <ul><li>Java Time-Scale должны точно соответствовать базовой международной шкале гражданского времени;</li><li>Time-Scale Java должен точно соответствовать международной шкале гражданского времени в полдень каждый день;</li><li>Time-Scale Java должен иметь четко определенную связь с международной шкалой гражданского времени.</li></ul> В настоящее время по состоянию на 2013 год в шкале времени Java существует два сегмента.

Для сегмента с 1972-11-03 (точная граница рассматривается ниже) до дальнейшего уведомления, консенсусная международная шкала времени — UTC (с високосными секундами). В этом сегменте Time-Scale Java идентична UTC-SLS. Это идентично utc в днях, в которых нет секунды корректировок. В дни, которые имеют корректировочную секунду, корректировочные секунды распределяется одинаково за последние 1000 секунд дня, сохраняя вид ровно 86400 секунд в день.

Для сегмента до 1972-11-03, простирая назад произвольно далеко, консенсусная международная шкала времени определена как UT1, примененная пролептически, что эквивалентно (среднее) солнечное время на основном меридиане (Гринвич). В этом сегменте Time-Scale Java идентична консенсусной международной временной шкале. Точная граница между двумя сегментами — это момент, когда UT1 = UTC между 1972-11-03T00:00 и 1972-11-04T12:00.

Реализации временной шкалы Java с помощью API JSR-310 не требуются для предоставления часов с точностью до секунды или монотонного или плавного хода. Поэтому реализации не требуются для фактического выполнения операции UTC-SLS или иным образом учитывать високосные секунды. Однако JSR-310 требует, чтобы реализации должны документировать подход, используемый при определении часов, представляющих текущий момент. Дополнительные сведения о доступных часах см Clock . в этой статье.

Шкала времени Java используется для всех классов даты и времени. К ним относятся Instant, LocalDate, LocalTime, OffsetDateTime, ZonedDateTime и Duration.

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

Документация по Java для java.time.Instant.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Свойства

Class	Возвращает класс среды выполнения данного объекта `Object`. (Унаследовано от Object)
Epoch	Мгновенная точка на временной линии.
EpochSecond	Возвращает количество секунд от эпохи Java 1970-01-01T00:00:00Z.
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
JniIdentityHashCode	Мгновенная точка на временной линии. (Унаследовано от Object)
JniPeerMembers	Мгновенная точка на временной линии.
Max	Мгновенная точка на временной линии.
Min	Мгновенная точка на временной линии.
Nano	Возвращает число наносекунд, позже по линии времени, начиная с начала секунды.
PeerReference	Мгновенная точка на временной линии. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object)
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object)

Методы

AdjustInto(ITemporal)	Мгновенная точка на временной линии.
AtOffset(ZoneOffset)	Мгновенная точка на временной линии.
AtZone(ZoneId)	Мгновенная точка на временной линии.
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
CompareTo(Instant)	Мгновенная точка на временной линии.
Dispose()	Мгновенная точка на временной линии. (Унаследовано от Object)
Dispose(Boolean)	Мгновенная точка на временной линии. (Унаследовано от Object)
Equals(Object)	Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object)
From(ITemporalAccessor)	Мгновенная точка на временной линии.
Get(ITemporalField)	Мгновенная точка на временной линии.
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
GetLong(ITemporalField)	Мгновенная точка на временной линии.
IsAfter(Instant)	Мгновенная точка на временной линии.
IsBefore(Instant)	Мгновенная точка на временной линии.
IsSupported(ITemporalField)	Мгновенная точка на временной линии.
IsSupported(ITemporalUnit)	Мгновенная точка на временной линии.
JavaFinalize()	Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object)
Minus(Int64, ITemporalUnit)	Мгновенная точка на временной линии.
Minus(ITemporalAmount)	Мгновенная точка на временной линии.
MinusMillis(Int64)	Мгновенная точка на временной линии.
MinusNanos(Int64)	Мгновенная точка на временной линии.
MinusSeconds(Int64)	Мгновенная точка на временной линии.
Notify()	Пробуждение одного потока, ожидающего на мониторе этого объекта. (Унаследовано от Object)
NotifyAll()	Активирует все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object)
Now()	Мгновенная точка на временной линии.
Now(Clock)	Мгновенная точка на временной линии.
OfEpochMilli(Int64)	Мгновенная точка на временной линии.
OfEpochSecond(Int64)	Мгновенная точка на временной линии.
OfEpochSecond(Int64, Int64)	Мгновенная точка на временной линии.
Parse(ICharSequence)	Мгновенная точка на временной линии.
Parse(String)	Мгновенная точка на временной линии.
Plus(Int64, ITemporalUnit)	Мгновенная точка на временной линии.
Plus(ITemporalAmount)	Мгновенная точка на временной линии.
PlusMillis(Int64)	Мгновенная точка на временной линии.
PlusNanos(Int64)	Мгновенная точка на временной линии.
PlusSeconds(Int64)	Мгновенная точка на временной линии.
Query(ITemporalQuery)	Мгновенная точка на временной линии.
Range(ITemporalField)	Мгновенная точка на временной линии.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
ToArray<T>()	Мгновенная точка на временной линии. (Унаследовано от Object)
ToEpochMilli()	Преобразует этот момент в миллисекундах эпохи 1970-01-01T00:00:00Z.
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
TruncatedTo(ITemporalUnit)	Мгновенная точка на временной линии.
UnregisterFromRuntime()	Мгновенная точка на временной линии. (Унаследовано от Object)
Until(ITemporal, ITemporalUnit)	Мгновенная точка на временной линии.
Wait()	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object)
Wait(Int64)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)
With(ITemporalAdjuster)	Мгновенная точка на временной линии.
With(ITemporalField, Int64)	Мгновенная точка на временной линии.

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

IComparable.CompareTo(Object)	Мгновенная точка на временной линии.
IJavaPeerable.Disposed()	Мгновенная точка на временной линии. (Унаследовано от Object)
IJavaPeerable.DisposeUnlessReferenced()	Мгновенная точка на временной линии. (Унаследовано от Object)
IJavaPeerable.Finalized()	Мгновенная точка на временной линии. (Унаследовано от Object)
IJavaPeerable.JniManagedPeerState	Мгновенная точка на временной линии. (Унаследовано от Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Мгновенная точка на временной линии. (Унаследовано от Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Мгновенная точка на временной линии. (Унаследовано от Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Мгновенная точка на временной линии. (Унаследовано от Object)

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

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверенное средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Мгновенная точка на временной линии.
GetJniTypeName(IJavaPeerable)	Мгновенная точка на временной линии.

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

Share via