Класс 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.

Вывод включает полную местную дату.