Класс JapaneseDate

public static JapaneseDate now()

Получает текущую дату из системных часов в часовом поясе по умолчанию.

Для получения текущей даты будет запрошен system clock в часовом поясе по умолчанию.

Использование этого метода запретит возможность использования альтернативных часов для тестирования, так как часы жестко запрограммированы.

public static JapaneseDate now(ZoneId zone)

Получает текущую дату из системных часов в указанном часовом поясе.

Для получения текущей даты будет запрошен system clock. Указание часового пояса предотвращает зависимость от часового пояса по умолчанию.

Использование этого метода запретит возможность использования альтернативных часов для тестирования, так как часы жестко запрограммированы.

public static JapaneseDate now(Clock clock)

Получает текущую дату из указанных часов.

Для получения текущей даты будет запрошен указанный объект часов - сегодняшний день. Использование этого метода позволяет использовать альтернативные часы для тестирования. Альтернативные часы могут быть введены с помощью инъекции зависимостей.

public static JapaneseDate of(JapaneseEra era, int yearOfEra, int month, int dayOfMonth)

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

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

Японский месяц и день месяца совпадают с месяцами и днями месяца в григорианском календаре. Они не сбрасываются при изменении эпохи. Например:

  6th Jan Showa 64 = ISO 1989-01-06
  7th Jan Showa 64 = ISO 1989-01-07
  8th Jan Heisei 1 = ISO 1989-01-08
  9th Jan Heisei 1 = ISO 1989-01-09
 

public static JapaneseDate of(int prolepticYear, int month, int dayOfMonth)

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

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

Японский пролептический год, месяц и день месяца совпадают с соответствующими значениями в григорианском календаре. Они не сбрасываются при изменении эпохи.

public static JapaneseDate from(TemporalAccessor temporal)

Получает дату из временного объекта.

Получает дату в японском календаре на основе указанного временного объекта. Временной объект представляет собой произвольный набор информации о дате и времени, который этот фабричный метод преобразует в экземпляр JapaneseDate.

Преобразование обычно использует поле EPOCH_DAY, которое стандартизировано для всех календарных систем.

Этот метод соответствует сигнатуре функционального интерфейса TemporalQuery, позволяя использовать его в качестве запроса с помощью ссылки на метод, JapaneseDate::from.

public JapaneseChronology getChronology()

Получает хронологию этой даты, которая представляет японский календарь.

Chronology представляет используемую календарную систему. Эпоха и другие поля в ChronoField определяются хронологией.

public JapaneseEra getEra()

Получает эпоху, применимую к этой дате.

Японский календарный формат имеет несколько эпох, определенных в JapaneseEra.

public int lengthOfMonth()

Возвращает длительность месяца, представленного этой датой.

Возвращает длительность месяца в днях. Длины месяцев соответствуют длинам месяцев в григорианском календаре.

public boolean isSupported(TemporalField field)

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

Проверяет, может ли эта дата быть запрошена для указанного поля. Если ложь, то вызов методов range и get вызовет исключение.

Если поле является ChronoField, то запрос выполняется здесь. Поддерживаемые поля:

• DAY_OF_WEEK
• DAY_OF_MONTH
• DAY_OF_YEAR
• EPOCH_DAY
• MONTH_OF_YEAR
• PROLEPTIC_MONTH
• YEAR_OF_ERA
• YEAR
• ERA

Все остальные ChronoField будут возвращать false.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.isSupportedBy(TemporalAccessor) со значением this в качестве аргумента. Поддержка поля определяется самим полем.

public long getLong(TemporalField field)

Возвращает значение указанного поля как целое число.

Запрашивает значение указанного поля у даты. Возвращаемое значение может находиться вне допустимого диапазона значений для поля. Если дата не может вернуть значение (потому что поле не поддерживается или по какой-либо другой причине), будет выброшено исключение.

public JapaneseDate with(TemporalField field, long newValue)

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

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

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект представляет дату 31 января, то изменение месяца на февраль не определено. В таких случаях поле отвечает за решение результата. Обычно оно выбирает предыдущую корректную дату, которая в данном примере будет последним днём февраля.

public JapaneseDate with(TemporalAdjuster adjuster)

Возвращает скорректированный объект того же типа, что и этот объект, с произведенной корректировкой.

Это корректирует эту дату и время в соответствии с правилами указанного корректировщика. Простой корректировщик может просто установить одно из полей, например, поле года. Более сложный корректировщик может установить дату на последнее число месяца. Выбор распространенных корректировок представлен в TemporalAdjusters. Они включают нахождение "последнего дня месяца" и "следующей среды". Корректировщик отвечает за обработку особых случаев, таких как переменная длина месяца и високосные годы.

Некоторые примеры кода, показывающие, как и почему используется этот метод:

  date = date.with(Month.JULY);        // most key classes implement TemporalAdjuster
  date = date.with(lastDayOfMonth());  // static import from Adjusters
  date = date.with(next(WEDNESDAY));   // static import from Adjusters and DayOfWeek
 

public JapaneseDate plus(TemporalAmount amount)

Возвращает объект того же типа, что и этот объект, с добавленной величиной.

Это корректирует это временное значение, добавляя в соответствии с правилами указанного количества. Величина обычно является Period, но может быть любого другого типа, реализующего интерфейс TemporalAmount, например, Duration.

Некоторые примеры кода, показывающие, как и почему используется этот метод:

  date = date.plus(period);                // add a Period instance
  date = date.plus(duration);              // add a Duration instance
  date = date.plus(workingDays(6));        // example user-written workingDays method
 

Обратите внимание, что вызов plus после minus не гарантирует возвращение той же даты и времени.

public JapaneseDate minus(TemporalAmount amount)

Возвращает объект того же типа, что и этот объект, с вычтенной величиной.

Это корректирует это временное значение, вычитая в соответствии с правилами указанного количества. Величина обычно является Period, но может быть любого другого типа, реализующего интерфейс TemporalAmount, например, Duration.

Некоторые примеры кода, показывающие, как и почему используется этот метод:

  date = date.minus(period);               // subtract a Period instance
  date = date.minus(duration);             // subtract a Duration instance
  date = date.minus(workingDays(6));       // example user-written workingDays method
 

Обратите внимание, что вызов plus после minus не гарантирует возвращение той же даты и времени.

public JapaneseDate plus(long amountToAdd, TemporalUnit unit)

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

Этот метод возвращает новый объект, основанный на этом, с указанным периодом, добавленным. Например, в случае LocalDate, это может быть использовано для добавления количества лет, месяцев или дней. Возвращаемый объект будет иметь тот же наблюдаемый тип, что и этот объект.

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

public JapaneseDate minus(long amountToSubtract, TemporalUnit unit)

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

Этот метод возвращает новый объект, основанный на этом, с указанным периодом, вычтенным. Например, в случае LocalDate, это может быть использовано для вычитания количества лет, месяцев или дней. Возвращаемый объект будет иметь тот же наблюдаемый тип, что и этот объект.

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

public final ChronoLocalDateTime<JapaneseDate> atTime(LocalTime localTime)

Объединяет эту дату с временем, чтобы создать ChronoLocalDateTime.

Это возвращает ChronoLocalDateTime, сформированное из этой даты в указанное время. Все возможные комбинации даты и времени допустимы.

public ChronoPeriod until(ChronoLocalDate endDate)

Вычисляет период между этой датой и другой датой как ChronoPeriod.

Это вычисляет период между двумя датами. Все предоставленные хронологии вычисляют период с использованием лет, месяцев и дней, однако API ChronoPeriod позволяет представлять период с использованием других единиц.

Точки начала и конца - this и указанная дата. Результат будет отрицательным, если конец находится до начала. Отрицательный знак будет одинаковым в каждом из года, месяца и дня.

Вычисление выполняется с помощью хронологии этой даты. При необходимости входная дата будет преобразована для соответствия.

Этот экземпляр неизменяем и не затрагивается этим вызовом метода.

public boolean equals(Object obj)

Сравнивает эту дату с другой датой, включая хронологию.

Сравнивает это JapaneseDate с другим, гарантируя, что дата такая же.

Сравниваются только объекты типа JapaneseDate, другие типы возвращают false. Чтобы сравнить даты двух TemporalAccessor экземпляров, включая даты в двух разных хронологиях, используйте ChronoField.EPOCH_DAY в качестве компаратора.

public int hashCode()

Хеш-код для этой даты.

public long until(Temporal endExclusive, TemporalUnit unit)

Вычисляет количество времени до другой даты в указанных единицах измерения.

Эта функция вычисляет количество времени между двумя ChronoLocalDate объектами в единицах указанного TemporalUnit. Начальная и конечная точки — это this и заданная дата. Результат будет отрицательным, если конечная дата раньше начальной. Temporal , переданный в этот метод, преобразуется в ChronoLocalDate с помощью Chronology.date(TemporalAccessor). Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами. Например, количество дней между двумя датами можно рассчитать с помощью startDate.until(endDate, DAYS).

Существует два равнозначных способа использования этого метода. Первый — вызвать этот метод. Второй — использовать TemporalUnit.between(Temporal, Temporal):

   // these two lines are equivalent
   amount = start.until(end, MONTHS);
   amount = MONTHS.between(start, end);
 

Выбор должен зависеть от того, какой вариант делает код более читаемым.

Вычисление реализовано в этом методе для ChronoUnit. Единицы DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS должны поддерживаться всеми реализациями. Другие значения ChronoUnit приведут к исключению.

Если единица не является ChronoUnit, то результат этого метода получается путем вызова TemporalUnit.between(Temporal, Temporal) с this в качестве первого аргумента и преобразованного входного временного объекта в качестве второго аргумента.

Этот экземпляр неизменяемый и не изменяется в результате вызова этого метода.

public String toString()

Возвращает строковое представление объекта.