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

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

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