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

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

Проверяет, может ли эта дата быть запрошена для указанного поля. Если false, то вызов методов 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.

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