Класс MinguoDate

public static MinguoDate now()

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

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

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

public static MinguoDate now(ZoneId zone)

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

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

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

public static MinguoDate now(Clock clock)

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

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

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

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

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

public static MinguoDate from(TemporalAccessor temporal)

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

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

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

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

public MinguoChronology getChronology()

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

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

public MinguoEra getEra()

Получает применимую эру для этой даты.

Система календаря Мингуо имеет две эры, 'ROC' и 'BEFORE_ROC', определенные в MinguoEra.

public int lengthOfMonth()

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

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

public long getLong(TemporalField field)

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

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

public MinguoDate with(TemporalField field, long newValue)

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

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

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

public MinguoDate 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 MinguoDate 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 MinguoDate 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 MinguoDate plus(long amountToAdd, TemporalUnit unit)

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

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

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

public MinguoDate minus(long amountToAdd, TemporalUnit unit)

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

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

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

public final ChronoLocalDateTime<MinguoDate> atTime(LocalTime localTime)

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

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

public ChronoPeriod until(ChronoLocalDate endDate)

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

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

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

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

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

public boolean equals(Object obj)

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

Сравнивает эту MinguoDate с другой, гарантируя, что дата совпадает.

Сравниваются только объекты типа MinguoDate, другие типы возвращают 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()

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