Класс MinguoDate

public static MinguoDate now()

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

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

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

public static MinguoDate now(ZoneId zone)

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

Будет запрошен system clock для получения текущей даты. Задание часового пояса исключает зависимость от часового пояса по умолчанию.

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

public static MinguoDate now(Clock clock)

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

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

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

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

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

public static MinguoDate from(TemporalAccessor temporal)

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

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

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

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

public MinguoChronology getChronology()

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

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

public MinguoEra getEra()

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

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

public int lengthOfMonth()

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

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

public ValueRange range(TemporalField field)

Получает диапазон допустимых значений для указанного поля.

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

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

public long getLong(TemporalField field)

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

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

public MinguoDate with(TemporalField field,
                       long newValue)

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

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

В некоторых случаях изменение поля не определено полностью. Например, если целевой объект — это дата, представляющая 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 long toEpochDay()

Преобразует эту дату в Эпоху Дня.

Epoch Day count — это простая нарастающая счетная единица дней, где день 0 — 1970-01-01 (ISO). Это определение одинаково для всех хронологий, что позволяет обеспечить преобразование.

Это реализация по умолчанию обращается к полю EPOCH_DAY.

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()

Возвращает строковое представление объекта. В общем случае метод toString возвращает строку, которая «текстово представляет» этот объект. Результат должен быть кратким, но информативным представлением, удобным для чтения человеком. Рекомендуется всем подклассам переопределять этот метод.

Метод toString для класса Object возвращает строку, состоящую из имени класса, к которому относится объект, символа «@» и беззнакового шестнадцатеричного представления хэш-кода объекта. Другими словами, этот метод возвращает строку, равную значению:

getClass().getName() + '@' + Integer.toHexString(hashCode())