Класс 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 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 объект в строку формата:

 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.