Класс 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 (без учёта регистра), распознаётся как ссылка на часовой пояс Северной Америки, соответственно, на 5, 6, 7 или 8 часов к западу от Гринвича. Любое слово, соответствующее 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 GMT, представленное этим объектом Date.

public void setTime(long time)

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

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 объект в String следующего вида:

 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 — точно символы "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.