Класс JapaneseDate

public static JapaneseDate now()

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

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

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

public static JapaneseDate now(ZoneId zone)

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

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

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

public static JapaneseDate now(Clock clock)

Получает текущую дату JapaneseDate по указанным часам.

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

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

Создает JapaneseDate, представляющую дату в японской календарной системе, на основе полей эры, года эры, месяца года и дня месяца.

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

Месяцы и дни месяца в японском календаре совпадают с месяцами и днями месяца в календарной системе ISO. Они не обнуляются при смене эры. Например:

 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)

Создает JapaneseDate, представляющую дату в японской календарной системе, на основе полей пролептического года, месяца года и дня месяца.

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

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

public static JapaneseDate from(TemporalAccessor temporal)

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

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

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

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

public JapaneseChronology getChronology()

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

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

public JapaneseEra getEra()

Возвращает эру, действующую на эту дату.

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

public int lengthOfMonth()

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

Возвращает продолжительность месяца в днях. Продолжительность месяцев совпадает с продолжительностью месяцев в календарной системе ISO.

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)

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

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

public JapaneseDate with(TemporalField field, long newValue)

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

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

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, соответствующая 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()

Выводит эту дату в виде String.

Вывод будет содержать полную местную дату.