Date Класс

Определение

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

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

Важно!

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

Класс Date представляет определенный момент времени с точностью миллисекунда.

[Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)]
public class Date : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Lang.IComparable

[<Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)>]
type Date = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IComparable

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

JavaObject

Object
Date

Производный: Java.Sql.Date

Java.Sql.Time

Java.Sql.Timestamp

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable ISerializable ICloneable IComparable IDisposable

До JDK>; 1.1 класс Date имел две дополнительные функции. Это позволило интерпретировать даты в виде года, месяца, дня, часа, минуты и второго значений. Кроме того, он позволял форматировать и анализировать строки даты. К сожалению, API для этих функций не поддался интернационализации. По состоянию на JDK> 1.1 Calendar класс должен использоваться для преобразования между полями даты и времени, а DateFormat класс должен использоваться для форматирования и анализа строк дат. Соответствующие методы в Date нерекомендуются.

Date Хотя класс предназначен для отражения согласованного универсального времени (UTC), он может не делать это точно в зависимости от среды узла виртуальной машины Java. Почти все современные операционные системы предполагают, что 1> day = 24> > > 60>; > > 60>= 86400 секунд во всех случаях. Однако в формате UTC примерно один раз в год или два есть дополнительная секунда, называемая "прыжок секундой". Прыжок второй всегда добавляется в качестве последней секунды дня, и всегда 31 декабря или 30 июня. Например, последняя минута года 1995 года составила 61 секунд, благодаря добавленной прыжок секунды. Большинство компьютерных часов недостаточно точны, чтобы быть в состоянии отразить прыжок-второе различие.

Некоторые стандарты компьютера определяются с точки зрения среднего времени Greenwich (GMT), что эквивалентно универсальному времени (UT). GMT — это "гражданское" имя стандарта; UT — это "научное" имя для того же стандарта. Различие между UTC и UT заключается в том, что UTC основан на атомарных часах и UT основан на астрономических наблюдениях, которые для всех практических целей является невидимые тонкие волосы для разделения. Поскольку поворот земли не является единообразным (он замедляется и ускоряется сложными способами), UT не всегда проходит равномерно. Секунды прыжка вводятся в формате UTC, чтобы сохранить UTC в пределах 0,9 секунды UT1, которая является версией UT с определенными исправлениями. Существуют и другие системы даты и времени; Например, шкала времени, используемая спутниковой системой позиционирования (GPS), синхронизирована с UTC, но не корректируется в секунды прыжка. Интересный источник дополнительной информации — это США военно-морской обсерватории (USNO): <blockquote>

<a href="https://www.usno.navy.mil/USNO">https://www.usno.navy.mil/USNO</a>

</blockquote>

и материалы о "Системах времени" в: <blockquote>

<a href="https://www.usno.navy.mil/USNO/time/master-clock/systems-of-time">https://www.usno.navy.mil/USNO/time/master-clock/systems-of-time</a>

</blockquote>

описание различных систем времени, включая UT, UT1 и UTC.

Во всех методах классаDate, которые принимают или возвращают год, месяц, дату, часы, минуты и секунды, используются следующие представления: <ul><li>A year y представлен целым числом y - 1900. <li>Месяц представлен целым числом от 0 до 11; 0 — 1 января и т. д. Таким образом, 11 декабря. <li>Дата (день месяца) представлена целым числом от 1 до 31 обычным образом. <li>Час представлен целым числом от 0 до 23. Таким образом, час от полуночи до 1 утра составляет час 0, и час от полудня до 1 вечера составляет час 12. <li>Минута представлена целым числом от 0 до 59 обычным образом. <li>Секунда представлена целым числом от 0 до 61; значения 60 и 61 происходят только в секундах прыжка, а затем только в Java реализации, которые фактически отслеживают секунды прыжка правильно. Из-за того, как в настоящее время вводятся секунды прыжка, крайне маловероятно, что две секунды прыжка будут происходить в ту же минуту, но эта спецификация соответствует соглашениям о дате и времени для ISO C. </ul>

Во всех случаях аргументы, заданные методам для этих целей, не должны соответствовать указанным диапазонам; Например, дата может быть указана как 32 января и интерпретируется как значение 1 февраля.

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

Java документации по java.util.Date.

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

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

Имя.	Описание
Date()	`Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял время, в течение которого он был выделен, измеряется в ближайшее миллисекунд.
Date(Int32, Int32, Int32, Int32, Int32, Int32)	Устаревшие. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял момент в начале второго, указанного `yearmonth`аргументами , и `datehrsminsec` аргументами в локальном часовом поясе.
Date(Int32, Int32, Int32, Int32, Int32)	Устаревшие. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял момент в начале минуты, указанной `yearmonthdatehrs`аргументами , и `min` аргументами в локальном часовом поясе.
Date(Int32, Int32, Int32)	Устаревшие. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял полночь, местное время в начале дня, указанного аргументами `yearmonth`и `date` аргументами.
Date(Int64)	`Date` Выделяет объект и инициализирует его для представления указанного числа миллисекунд, так как стандартное базовое время, известное как "эпоха", а именно 1 января 1970 г., 00:00:00 GMT.
Date(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.
Date(String)	Устаревшие. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял дату и время, указанное строкой`s`, которая интерпретируется как будто методом`Date#parse`.

Свойства

Имя.	Описание
Class	Возвращает класс среды выполнения этого `Object`объекта. (Унаследовано от Object)
Day	Устаревшие. Возвращает день недели, представленный этой датой.
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
Hours	Устаревшие. Возвращает час, представленный этим `Date` объектом. -или- Задает час данного `Date` объекта заданному значению.
JniIdentityHashCode	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
JniPeerMembers	Класс `Date` представляет определенный момент времени с точностью миллисекунда.
Minutes	Устаревшие. Возвращает количество минут за час, представленное этой датой, как интерпретируется в местном часовом поясе. -или- Задает минуты этого `Date` объекта указанным значением.
Month	Устаревшие. Возвращает число, представляющее месяц, содержащий или начинающийся с мгновенного времени, представленного этим `Date` объектом. -или- Задает месяц этой даты указанным значением.
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
Seconds	Устаревшие. Возвращает количество секунд за минуту, представленное этой датой. -или- задает секунды этого `Date` значения в указанное значение.
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
Time	Возвращает число миллисекунда с 1 января 1970 г., 00:00:00 GMT, представленное этим `Date` объектом. -или- Задает этот `Date` объект для представления точки во времени, которая является `time` миллисекундами после 1 января 1970 г. 00:00:00 GMT.
TimezoneOffset	Устаревшие. Возвращает смещение, измеряемое в минутах, для локального часового пояса относительно UTC, подходящего для времени, представленного этим `Date` объектом.
Year	Устаревшие. Возвращает значение, которое является результатом вычитания 1900 из года, содержащего или начинающегося с мгновенного времени, представленного этим `Date` объектом, как интерпретируется в локальном часовом поясе. -или- Задает год этого `Date` объекта, который должен быть указанным значением плюс 1900.

Методы

Имя.	Описание
After(Date)	Проверяет, находится ли эта дата после указанной даты.
Before(Date)	Проверяет, находится ли эта дата до указанной даты.
Clone()	Возвращает копию этого объекта.
CompareTo(Date)	Сравнивает два даты для упорядочивания.
Construct(JniObjectReference, JniObjectReferenceOptions)	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
Equals(Object)	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
From(Instant)	Получает экземпляр `Date` объекта `Instant` .
GetDate()	Устаревшие. Возвращает день месяца, представленный этим `Date` объектом.
GetHashCode()	Возвращает хэш-значение кода для объекта. (Унаследовано от Object)
JavaFinalize()	Устаревшие. Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
Notify()	Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
Parse(String)	Устаревшие. Пытается интерпретировать строку `s` как представление даты и времени.
SetDate(Int32)	Устаревшие. Задает день месяца данного `Date` объекта указанным значением.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToGMTString()	Устаревшие. Создает строковое представление этого `Date` объекта формы: <blockquote>
ToInstant()	Преобразует этот `Date` объект в объект `Instant`.
ToLocaleString()	Устаревшие. Создает строковое представление этого `Date` объекта в форме, зависящей от реализации.
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
UTC(Int32, Int32, Int32, Int32, Int32, Int32)	Устаревшие. Определяет дату и время на основе аргументов.
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

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

Имя.	Описание
IComparable.CompareTo(Object)	Класс `Date` представляет определенный момент времени с точностью миллисекунда.
IJavaPeerable.Disposed()	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Класс `Date` представляет определенный момент времени с точностью миллисекунда. (Унаследовано от JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Класс `Date` представляет определенный момент времени с точностью миллисекунда.

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

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

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