Класс MinguoDate

Все реализованные интерфейсы:
Serializable, Comparable<ChronoLocalDate>, ChronoLocalDate, Temporal, TemporalAccessor, TemporalAdjuster 
public final class MinguoDate
extends Object
implements ChronoLocalDate, Serializable

Дата в системе календаря Мингуо.

Эта дата работает с использованием календаря Мингуо. Эта система календаря в основном используется в Китайской Республике, часто называемой Тайване. Даты выстроены таким образом, что 0001-01-01 (Minguo) является 1912-01-01 (ISO).

Это класс с основой на значениях; использование операций, чувствительных к идентификаторам (включая равенство ссылок (==), хэш-код идентичности или синхронизацию) над экземплярами MinguoDate может привести к непредсказуемым результатам и следует избегать. Для сравнений необходимо использовать метод equals.

Требования к реализации:
Этот класс неизменяемый и потокобезопасный.
С:
1.8
См. также:
Сериализованная форма

Методы

Модификатор и тип Метод Описание
boolean equals​(Object obj)

Сравнивает эту дату с другой датой, включая хронологию.
static MinguoDate from​(TemporalAccessor temporal)

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

Возвращает хронологию этой даты, которая является системой календаря Мингуо.
MinguoEra getEra()

Возвращает эпоху, применимую к этой дате.
int hashCode()

Хэш-код для этой даты.
int lengthOfMonth()

Возвращает длительность месяца, представленного этой датой.
MinguoDate minus​(TemporalAmount amount)

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

Получает текущую MinguoDate из системных часов в часовом поясе по умолчанию.
static MinguoDate now​(Clock clock)

Получает текущую MinguoDate из указанных часов.
static MinguoDate now​(ZoneId zone)

Получает текущую MinguoDate из системных часов в указанном часовом поясе.
static MinguoDate of​(int prolepticYear, int month, int dayOfMonth)

Получает MinguoDate, представляющий дату в системе календаря Мингуо из полей пролептического года, месяца и дня.
MinguoDate plus​(TemporalAmount amount)

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

Возвращает строковое представление объекта.
long until​(Temporal endExclusive, TemporalUnit unit)

Вычисляет временной интервал до другой даты в указанных единицах измерения.
MinguoDate with​(TemporalAdjuster adjuster)

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

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.time.chrono.ChronoLocalDate

adjustInto, atTime, compareTo, format, isAfter, isBefore, isEqual, isLeapYear, isSupported, isSupported, lengthOfYear, minus, plus, query, toEpochDay, toString, until, until, with

Методы, объявленные в интерфейсе java.time.temporal.TemporalAccessor

get, getLong, range

Методы

now

public static MinguoDate now()

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

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

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

Возвращает:
текущую дату, используя системные часы и часовой пояс по умолчанию, не null

now

public static MinguoDate now(ZoneId zone)

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

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

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

Параметры:
zone - идентификатор часового пояса для использования, не null
Возвращает:
текущую дату, используя системные часы, не null

now

public static MinguoDate now(Clock clock)

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

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

Параметры:
clock - используемые часы, не null
Возвращает:
текущую дату, не null
Выбрасывает:
DateTimeException - если текущую дату получить невозможно

of

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

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

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

Параметры:
prolepticYear - пролептический год Мингуо
month - месяц Мингуо, от 1 до 12
dayOfMonth - день месяца Мингуо, от 1 до 31
Возвращает:
дату в системе календаря Мингуо, не null
Выбрасывает:
DateTimeException - если значение любого поля находится вне диапазона или если день месяца недопустим для месяца-года

from

public static MinguoDate from(TemporalAccessor temporal)

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

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

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

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

Параметры:
temporal - временной объект для преобразования, не null
Возвращает:
дату в системе календаря Мингуо, не null
Выбрасывает:
DateTimeException - если невозможно выполнить преобразование в MinguoDate
См. также:
Chronology.date(TemporalAccessor)

getChronology

public MinguoChronology getChronology()

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

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

Определяет:
getChronology в интерфейсе ChronoLocalDate
Возвращает:
хронологию Мингуо, не null

getEra

public MinguoEra getEra()

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

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

Определяет:
getEra в интерфейсе ChronoLocalDate
Возвращает:
эру, применимую к этой дате, не null

lengthOfMonth

public int lengthOfMonth()

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

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

Определяет:
lengthOfMonth в интерфейсе ChronoLocalDate
Возвращает:
длительность месяца в днях

with

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
Определяет:
with в интерфейсе ChronoLocalDate
Определяет:
with в интерфейсе Temporal
Параметры:
adjuster - корректировщик для использования, не null
Возвращает:
объект того же типа с произведённой корректировкой, не null
Выбрасывает:
DateTimeException - если корректировку произвести невозможно
ArithmeticException - если происходит переполнение числовых значений

plus

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 не гарантирует, что вернётся та же дата-время.

Определяет:
plus в интерфейсе ChronoLocalDate
Определяет:
plus в интерфейсе Temporal
Параметры:
amount - величина для добавления, не null
Возвращает:
объект того же типа с произведённой корректировкой, не null
Выбрасывает:
DateTimeException - если добавление произвести невозможно
ArithmeticException - если происходит переполнение числовых значений

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 не гарантирует, что вернётся та же дата-время.

Определяет:
minus в интерфейсе ChronoLocalDate
Определяет:
minus в интерфейсе Temporal
Параметры:
amount - величина для вычитания, не null
Возвращает:
объект того же типа с произведённой корректировкой, не null
Выбрасывает:
DateTimeException - если вычитание произвести невозможно
ArithmeticException - если происходит переполнение числовых значений

equals

public boolean equals(Object obj)

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

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

Сравниваются только объекты типа MinguoDate, другие типы возвращают false. Чтобы сравнить даты двух экземпляров TemporalAccessor , включая даты в разных хронологиях, используйте ChronoField.EPOCH_DAY в качестве компаратора.

Определяет:
equals в интерфейсе ChronoLocalDate
Параметры:
obj - объект для проверки, null возвращает false
Возвращает:
true, если эта дата равна другой дате
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

Хэш-код для этой даты.

Определяет:
hashCode в интерфейсе ChronoLocalDate
Возвращает:
подходящий хэш-код, основанный только на хронологии и дате
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

until

public long until(Temporal endExclusive,
                  TemporalUnit unit)

Описание скопировано из интерфейса: ChronoLocalDate

Вычисляет количество времени до другой даты в указанных единицах измерения.

Это вычисляет количество времени между двумя 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 в качестве первого аргумента и преобразованного входного временного объекта в качестве второго.

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

Определено в:
until в интерфейсе ChronoLocalDate
Определено в:
until в интерфейсе Temporal
Параметры:
endExclusive - конечная дата, исключающая, которая преобразуется в ChronoLocalDate в той же хронологии, не null
unit - единица измерения количества, не null
Возвращает:
количество времени между этой датой и конечной датой

toString

public String toString()

Описание скопировано из класса: Object

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

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

getClass().getName() + '@' + Integer.toHexString(hashCode())
Определено в:
toString в интерфейсе ChronoLocalDate
Переопределяет:
toString в классе Object
Возвращает:
строковое представление объекта.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/chrono/MinguoDate.html

Spec-Zone .ru
спецификации, руководства, описания, API