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

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