Класс 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(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 в 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 — это в точности буквы 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.