Date Класс

Ссылка

Определение

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

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

Важно!

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

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

[Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)]
public class Date : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, 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

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 секунду благодаря добавленной корректировочной секунде. Большинство компьютерных часов не достаточно точны, чтобы быть в состоянии отразить корректировочную секунду различия.

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

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

</blockquote>

и материал о "Системах времени" в: <блокquote>

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

</blockquote>

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

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

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

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

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

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

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

Date()	`Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял время, в которое он был выделен, измеряемый до ближайшей миллисекунды.
Date(Int32, Int32, Int32)	Устаревшие.. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял полночь, местное время в начале дня, указанного `year`аргументами , `month`и `date` .
Date(Int32, Int32, Int32, Int32, Int32)	Устаревшие.. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял момент в начале минуты, указанной аргументами `year`, `month`, `date`, `hrs`и`min`, в локальном часовом поясе.
Date(Int32, Int32, Int32, Int32, Int32, Int32)	Устаревшие.. `Date` Выделяет объект и инициализирует его таким образом, чтобы он представлял момент в начале секунды, указанной аргументами `year`, `month`, `hrsdate`, `min`, и`sec`, в локальном часовом поясе.
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	Класс `Date` представляет определенный момент времени с точностью в миллисекундах. (Унаследовано от Object)
JniPeerMembers	Класс `Date` представляет определенный момент времени с точностью в миллисекундах.
Minutes	Устаревшие.. Возвращает количество минут после часа, представленного этой датой, как интерпретируется в местном часовом поясе. -или- Задает указанное значение для этого `Date` объекта в минутах.
Month	Устаревшие.. Возвращает число, представляющее месяц, который содержит или начинается с момента во времени, представленного этим `Date` объектом. -или- Задает для месяца этой даты указанное значение.
PeerReference	Класс `Date` представляет определенный момент времени с точностью в миллисекундах. (Унаследовано от 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)	Сравнивает две даты для упорядочения.
Dispose()	Класс `Date` представляет определенный момент времени с точностью в миллисекундах. (Унаследовано от Object)
Dispose(Boolean)	Класс `Date` представляет определенный момент времени с точностью в миллисекундах. (Унаследовано от Object)
Equals(Object)	Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object)
From(Instant)	Получает экземпляр из `DateInstant` объекта .
GetDate()	Устаревшие.. Возвращает день месяца, представленный этим `Date` объектом.
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
JavaFinalize()	Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object)
Notify()	Пробуждение одного потока, ожидающего на мониторе этого объекта. (Унаследовано от Object)
NotifyAll()	Активирует все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object)
Parse(String)	Устаревшие.. Пытается интерпретировать строку `s` как представление даты и времени.
SetDate(Int32)	Устаревшие.. Задает в день месяца данного `Date` объекта указанное значение.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
ToArray<T>()	Класс `Date` представляет определенный момент времени с точностью в миллисекундах. (Унаследовано от Object)
ToGMTString()	Устаревшие.. Создает строковое представление этого `Date` объекта в формате blockquote <.>
ToInstant()	Преобразует этот `Date` объект в .`Instant`
ToLocaleString()	Устаревшие.. Создает строковое представление этого `Date` объекта в форме, зависящей от реализации.
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Класс `Date` представляет определенный момент времени с точностью в миллисекундах. (Унаследовано от Object)
UTC(Int32, Int32, Int32, Int32, Int32, Int32)	Устаревшие.. Определяет дату и время на основе аргументов.
Wait()	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object)
Wait(Int64)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)

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

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

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

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверенное средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Класс `Date` представляет определенный момент времени с точностью в миллисекундах.
GetJniTypeName(IJavaPeerable)	Класс `Date` представляет определенный момент времени с точностью в миллисекундах.

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