Класс Date

public Date()

Выделяет объект Date и инициализирует его так, чтобы он представлял время его выделения, измеренное с точностью до миллисекунды.

public Date(long date)

Выделяет объект Date и инициализирует его так, чтобы он представлял указанное количество миллисекунд, прошедших с момента стандартного базового времени, известного как «эпоха», а именно 1 января 1970 года, 00:00:00 GMT.

@Deprecated public Date(int year, int month, int date)

Выделяет объект Date и инициализирует его так, чтобы он представлял полночь, по местному времени, в начале дня, заданного аргументами year, month, и date.

@Deprecated public Date(int year, int month, int date, int hrs, int min)

Выделяет объект Date и инициализирует его так, чтобы он представлял мгновение в начале минуты, заданной аргументами year, month, date, hrs, и min, в часовом поясе по умолчанию.

@Deprecated public Date(int year, int month, int date, int hrs, int min, int sec)

Выделяет объект Date и инициализирует его так, чтобы он представлял мгновение в начале секунды, заданной аргументами year, month, date, hrs, min, и sec, в часовом поясе по умолчанию.

@Deprecated public Date(String s)

Выделяет объект Date и инициализирует его так, чтобы он представлял дату и время, указанные в строке s, интерпретируемой как метод parse(java.lang.String).

public Object clone()

Возвращает копию этого объекта.

@Deprecated public static long UTC(int year, int month, int date, int hrs, int min, int sec)

Определяет дату и время на основе аргументов. Аргументы интерпретируются как год, месяц, день месяца, час, минута и секунда, точно так же, как для конструктора Date с шестью аргументами, за исключением того, что аргументы интерпретируются относительно UTC, а не местного часового пояса. Указанное время возвращается в виде расстояния, измеренного в миллисекундах, от этого времени до эпохи (00:00:00 GMT 1 января 1970 г.).

@Deprecated public static long parse(String s)

Попытка интерпретировать строку s как представление даты и времени. Если попытка успешна, возвращается время, представленное как разность, измеренная в миллисекундах, между этим временем и началом отсчёта (00:00:00 GMT 1 января 1970 года). Если попытка неудачна, выбрасывается IllegalArgumentException.

Поддерживает множество синтаксисов; в частности, распознаёт стандартный синтаксис даты IETF: "Sat, 12 Aug 1995 13:30:00 GMT". Также понимает сокращения часовых поясов США, но для общего использования рекомендуется использовать смещение часового пояса: "Sat, 12 Aug 1995 13:30:00 GMT+0430" (4 часа, 30 минут к западу от Гринвича). Если часовой пояс не указан, предполагается местный часовой пояс. GMT и UTC считаются эквивалентными.

Строка s обрабатывается слева направо, ищутся интересные данные. Любая информация в s внутри символов ASCII-скобок ( и ) игнорируется. Скобки могут быть вложены. В противном случае, единственные разрешённые символы внутри s - это эти ASCII-символы:

 abcdefghijklmnopqrstuvwxyz
 ABCDEFGHIJKLMNOPQRSTUVWXYZ
 0123456789,+-:/

и пробельные символы.

Последовательность десятичных цифр трактуется как десятичное число:

• Если число предшествует + или - и год уже распознан, то число является смещением часового пояса. Если число меньше 24, то это смещение измеряется в часах. В противном случае, это смещение в минутах, выраженное в 24-часовом формате без знаков препинания. Предшествующий символ - обозначает смещение к западу. Смещения часовых поясов всегда относительны к UTC (Гринвичу). Например, -5 в строке означает "на пять часов к западу от Гринвича", а +0430 - "на четыре часа и тридцать минут к востоку от Гринвича". Допускается, что строка указывает GMT, UT, или UTC избыточно - например, GMT-5 или utc+0430.
• Число считается годом, если выполняется одно из следующих условий:
  • Число равно или больше 70 и за ним следует пробел, запятая, слэш или конец строки
  • Число меньше 70, и месяц и день месяца уже распознаны
  Если распознанный год меньше 100, он интерпретируется как сокращённый год относительно столетия, даты которого находятся в пределах 80 лет до и 19 лет после момента инициализации класса Date. После корректировки числа года от него вычитается 1900. Например, если текущий год 1999, то года в диапазоне от 19 до 99 предполагаются как 1919 до 1999, а года от 0 до 18 предполагаются как 2000 до 2018. Обратите внимание, что это немного отличается от интерпретации годов меньше 100, используемой в SimpleDateFormat.
• Если за числом следует двоеточие, оно интерпретируется как час, если час уже не распознан, в противном случае как минута.
• Если за числом следует слэш, оно интерпретируется как месяц (его уменьшают на 1, чтобы получить число в диапазоне 0 до 11), если месяц уже распознан, то как день месяца.
• Если за числом следует пробел, запятая, тире или конец строки, то если час распознан, но не минута, то это минута; в противном случае, если минута распознана, но не секунда, то это секунда; в противном случае это день месяца.

Последовательность букв интерпретируется как слово и обрабатывается следующим образом:

• Слово, соответствующее AM, без учёта регистра, игнорируется (но парсинг завершается неудачей, если час не распознан или меньше 1 или больше 12).
• Слово, соответствующее PM, без учёта регистра, добавляет 12 к часу (но парсинг завершается неудачей, если час не распознан или меньше 1 или больше 12).
• Любое слово, соответствующее любому префиксу SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, или SATURDAY, без учёта регистра, игнорируется. Например, sat, Friday, TUE, и Thurs игнорируются.
• В противном случае, любое слово, соответствующее любому префиксу JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, или DECEMBER, без учёта регистра и в указанном здесь порядке, распознаётся как месяц и преобразуется в число (0 до 11). Например, aug, Sept, april, и NOV распознаются как месяцы. Также распознаётся Ma, которое распознаётся как MARCH, а не MAY.
• Любое слово, соответствующее GMT, UT, или UTC, без учёта регистра, рассматривается как ссылка на UTC.
• Любое слово, соответствующее EST, CST, MST, или PST, без учёта регистра, распознаётся как ссылка на часовой пояс Северной Америки, который отстаёт на пять, шесть, семь или восемь часов от Гринвича соответственно. Любое слово, соответствующее EDT, CDT, MDT, или PDT, без учёта регистра, распознаётся как ссылка на тот же часовой пояс соответственно в летнее время.

После сканирования всей строки s она преобразуется в результат времени одним из двух способов. Если распознан часовой пояс или смещение часового пояса, год, месяц, день месяца, час, минута и секунда интерпретируются в UTC, а затем применяется смещение часового пояса. В противном случае год, месяц, день месяца, час, минута и секунда интерпретируются в местном часовом поясе.

@Deprecated public int getYear()

Возвращает значение, полученное вычитанием 1900 из года, содержащего или начинающегося с момента времени, представленного этим объектом Date, как интерпретируется в местном часовом поясе.

@Deprecated public void setYear(int year)

Устанавливает год этого объекта Date в указанное значение плюс 1900. Этот объект Date изменяется так, что он представляет точку во времени в указанном году, при этом месяц, дата, час, минута и секунда остаются такими же, как и раньше, как интерпретируется в местном часовом поясе. (Конечно, если дата была 29 февраля, например, а год установлен на невисокосный год, то новая дата будет обрабатываться как если бы она была 1 марта.)

@Deprecated public int getMonth()

Возвращает число, представляющее месяц, содержащий или начинающийся с момента времени, представленного этим объектом Date . Возвращаемое значение находится в диапазоне от 0 до 11, причём значение 0 соответствует январю.

@Deprecated public void setMonth(int month)

Устанавливает месяц этой даты в указанное значение. Объект Date изменяется таким образом, что он представляет момент времени в указанном месяце, при этом год, дата, час, минута и секунда остаются прежними, как интерпретируется в местном часовом поясе. Если дата была 31 октября, например, а месяц установлен на июнь, то новая дата будет обрабатываться как 1 июля, так как июнь имеет только 30 дней.

@Deprecated public int getDate()

Возвращает день месяца, представленный этим объектом Date. Возвращаемое значение находится в диапазоне от 1 до 31, представляющее день месяца, содержащий или начинающийся с момента времени, представленного этим объектом Date, как интерпретируется в местном часовом поясе.

@Deprecated public void setDate(int date)

Устанавливает день месяца для этого объекта Date на указанное значение. Этот объект Date изменяется так, чтобы он представлял точку во времени в указанный день месяца, при этом год, месяц, час, минута и секунда остаются такими же, как и раньше, интерпретируясь в местном часовом поясе. Например, если дата была 30 апреля, и дата устанавливается на 31, то она будет рассматриваться как 1 мая, так как в апреле всего 30 дней.

@Deprecated public int getDay()

Возвращает день недели, представленный этой датой. Возвращаемое значение (0 = воскресенье, 1 = понедельник, 2 = вторник, 3 = среда, 4 = четверг, 5 = пятница, 6 = суббота) представляет день недели, содержащий или начинающийся с момента времени, представленного этим объектом Date , интерпретируемый в местном часовом поясе.

@Deprecated public int getHours()

Возвращает час, представленный этим объектом Date . Возвращаемое значение — число (от 0 до 23) , представляющее час в течение дня, содержащий или начинающийся с момента времени, представленного этим объектом Date , интерпретируемый в местном часовом поясе.

@Deprecated public void setHours(int hours)

Устанавливает час для этого объекта Date на указанное значение. Этот объект Date изменяется так, чтобы он представлял точку во времени в указанный час дня, при этом год, месяц, дата, минута и секунда остаются такими же, как и раньше, интерпретируясь в местном часовом поясе.

@Deprecated public int getMinutes()

Возвращает количество минут, прошедших после часа, представленного этой датой, интерпретируясь в местном часовом поясе. Возвращаемое значение находится в диапазоне от 0 до 59.

@Deprecated public void setMinutes(int minutes)

Устанавливает минуты для этого объекта Date на указанное значение. Этот объект Date изменяется так, чтобы он представлял точку во времени в указанную минуту часа, при этом год, месяц, дата, час и секунда остаются такими же, как и раньше, интерпретируясь в местном часовом поясе.

@Deprecated public int getSeconds()

Возвращает количество секунд, прошедших после минуты, представленной этой датой. Возвращаемое значение находится в диапазоне от 0 до 61 . Значения 60 и 61 могут встречаться только на тех виртуальных машинах Java, которые учитывают високосные секунды.

@Deprecated public void setSeconds(int seconds)

Устанавливает секунды для этого объекта Date на указанное значение. Этот объект Date изменяется так, чтобы он представлял точку во времени в указанную секунду минуты, при этом год, месяц, дата, час и минута остаются такими же, как и раньше, интерпретируясь в местном часовом поясе.

public long getTime()

Возвращает количество миллисекунд с 1 января 1970 года, 00:00:00 по Гринвичу, представленное этим объектом Date .

public void setTime(long time)

Устанавливает этот объект Date так, чтобы он представлял точку во времени, которая является time миллисекундами после 1 января 1970 года, 00:00:00 по Гринвичу.

public boolean before(Date when)

Проверяет, предшествует ли эта дата указанной дате.

public boolean after(Date when)

Проверяет, следует ли эта дата за указанной датой.

public boolean equals(Object obj)

Сравнивает две даты на равенство. Результат — true тогда и только тогда, когда аргумент не null и является объектом типа Date , представляющим ту же точку во времени, до миллисекунды, что и этот объект.

Таким образом, два объекта Date равны тогда и только тогда, когда метод getTime возвращает одно и то же значение long для обоих.

public int compareTo(Date anotherDate)

Сравнивает две даты для упорядочения.

public int hashCode()

Возвращает код хэша для этого объекта. Результатом является исключающее ИЛИ двух половин примитивного значения long , возвращаемого методом getTime(). То есть, хэш-код — это значение выражения:

 (int)(this.getTime()^(this.getTime() >>> 32))
 

public String toString()

Преобразует этот объект Date в строку формата:

 dow mon dd hh:mm:ss zzz yyyy

, где:

• dow — день недели (Sun, Mon, Tue, Wed, Thu, Fri, Sat).
• mon — месяц (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec).
• dd — число месяца (01 по 31), как двузначное число.
• hh — час (00 по 23), как двузначное число.
• mm — минута (00 по 59), как двузначное число.
• ss — секунда (00 по 61), как двузначное число.
• zzz — часовой пояс (и может отражать летнее время). Стандартные аббревиатуры часовых поясов включают те, что распознаются методом parse. Если информация о часовом поясе недоступна, то zzz пуста — то есть она не содержит ни одного символа.
• yyyy — год, как четырёхзначное число.

@Deprecated public String toLocaleString()

Создаёт строковое представление объекта Date в формате, зависящем от реализации. Цель состоит в том, чтобы формат был понятен пользователю Java-приложения, где бы оно ни выполнялось. Цель аналогична формату «%c», поддерживаемому функцией strftime() языка ISO C.

@Deprecated public String toGMTString()

Создаёт строковое представление объекта Date в формате:

 d mon yyyy hh:mm:ss GMT

, где:

• d — число месяца (1 по 31), как одно- или двузначное число.
• mon — месяц (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec).
• yyyy — год, как четырёхзначное число.
• hh — час (00 по 23), как двузначное число.
• mm — минута (00 по 59), как двузначное число.
• ss — секунда (00 по 61), как двузначное число.
• GMT — ровно ASCII символы "GMT", чтобы указать Гринвичское время.

Результат не зависит от часового пояса.

@Deprecated public int getTimezoneOffset()

Возвращает смещение, измеряемое в минутах, для местного часового пояса относительно UTC, соответствующего времени, представленному этим объектом Date.

Например, в Массачусетсе, пять часовых поясов к западу от Гринвича:

 new Date(96, 1, 14).getTimezoneOffset() returns 300

потому что 14 февраля 1996 года используется стандартное время (Восточное стандартное время), которое смещено на пять часов от UTC; но:

 new Date(96, 5, 1).getTimezoneOffset() returns 240

потому что 1 июня 1996 года используется летнее время (Восточное летнее время), которое смещено всего на четыре часа от UTC.

Этот метод даёт тот же результат, что и если бы он вычислял:

 (this.getTime() - UTC(this.getYear(),
                       this.getMonth(),
                       this.getDate(),
                       this.getHours(),
                       this.getMinutes(),
                       this.getSeconds())) / (60 * 1000)
 

public static Date from(Instant instant)

Получает экземпляр Date из объекта Instant.

Instant использует точность в наносекундах, в то время как Date использует точность в миллисекундах. Преобразование будет усекать избыточную информацию о точности так, как будто значение в наносекундах подверглось целочисленному делению на миллион.

Instant может хранить точки на временной шкале дальше в будущем и дальше в прошлом, чем Date. В этом случае этот метод бросит исключение.

public Instant toInstant()

Преобразует этот объект Date в объект Instant.

Преобразование создаёт объект Instant, который представляет ту же точку на временной шкале, что и этот объект Date.