Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class IsoChronology extends Chronology implements Serializable
Эта хронология определяет правила календарной системы ISO. Эта календарная система основана на стандарте ISO 8601, который является фактическим мировым календарем.
Поля определяются следующим образом:
Модификатор и Тип | Поле и Описание |
---|---|
static IsoChronology |
ЭКЗЕМПЛЯР
Экземпляр Singleton хронологии ISO.
|
Модификатор и Тип | Метод и Описание |
---|---|
LocalDate |
date(Era era, int yearOfEra, int month, int dayOfMonth)
Получает ISO локальная дата с эры, года эры, месяца-летнего и дневных-месячного полей.
|
LocalDate |
date(int prolepticYear, int month, int dayOfMonth)
Получает ISO локальная дата из преждевременно-летнего, месяц-летнего и дневные-месячного поля.
|
LocalDate |
date(TemporalAccessor temporal)
Получает ISO локальная дата из другого разового датой объекта.
|
LocalDate |
dateEpochDay(long epochDay)
Получает ISO локальная дата из дневного эпохой.
|
LocalDate |
dateNow()
Получает текущий ISO локальная дата из системных часов в часовом поясе значения по умолчанию.
|
LocalDate |
dateNow(Clock clock)
Получает текущий ISO локальная дата из указанных часов.
|
LocalDate |
dateNow(ZoneId zone)
Получает текущий ISO локальная дата из системных часов в указанном часовом поясе.
|
LocalDate |
dateYearDay(Era era, int yearOfEra, int dayOfYear)
Получает ISO локальная дата с эры, года эры и дневных-летнего полей.
|
LocalDate |
dateYearDay(int prolepticYear, int dayOfYear)
Получает ISO локальная дата из преждевременно-летних полей и дневных-летнего полей.
|
Эра |
eraOf(int eraValue)
Создает объект эры хронологии из числового значения.
|
List<Era> |
eras()
Получает список эр для хронологии.
|
Строка |
getCalendarType()
Получает тип календаря базовой календарной системы - 'iso8601'.
|
Строка |
getId()
Получает ID хронологии - 'ISO'.
|
boolean |
isLeapYear(long prolepticYear)
Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
|
LocalDateTime |
localDateTime(TemporalAccessor temporal)
Получает ISO, локальный разовый датой от другого разового датой объекта.
|
int |
prolepticYear(Era era, int yearOfEra)
Вычисляет преждевременно-летнее, данное эру и год эры.
|
ValueRange |
range(ChronoField field)
Получает диапазон допустимых значений для указанного поля.
|
LocalDate |
resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)
Решения проанализированы
ChronoField значения в дату во время парсинга. |
ZonedDateTime |
zonedDateTime(Instant instant, ZoneId zone)
Получает ISO, зонируемый разовый датой в этой хронологии от
Instant . |
ZonedDateTime |
zonedDateTime(TemporalAccessor temporal)
Получает ISO, зонируемый разовый датой от другого разового датой объекта.
|
compareTo, equals, from, getAvailableChronologies, getDisplayName, hashCode, of, ofLocale, toString, writeReplace
public static final IsoChronology INSTANCE
public String getId()
ID однозначно определяет Chronology
. Это может привыкнуть к поиску Chronology
использование Chronology.of(String)
.
getId
в class Chronology
getCalendarType()
public String getCalendarType()
Тип календаря является идентификатором, определенным Языком разметки Данных Локали Unicode (LDML) спецификация. Это может привыкнуть к поиску Chronology
использование Chronology.of(String)
. Это может также использоваться в качестве части локали, доступной через Locale.getUnicodeLocaleType(String)
с ключом 'приблизительно'.
getCalendarType
в class Chronology
getId()
public LocalDate date(Era era, int yearOfEra, int month, int dayOfMonth)
date
в class Chronology
era
- эра ISO, не нульyearOfEra
- год эры ISOmonth
- месяц-летнего ISOdayOfMonth
- день-месячного ISODateTimeException
- если неспособный создать датуClassCastException
- если тип era
не IsoEra
public LocalDate date(int prolepticYear, int month, int dayOfMonth)
Это эквивалентно LocalDate.of(int, int, int)
.
date
в class Chronology
prolepticYear
- преждевременно-летний ISOmonth
- месяц-летнего ISOdayOfMonth
- день-месячного ISODateTimeException
- если неспособный создать датуpublic LocalDate dateYearDay(Era era, int yearOfEra, int dayOfYear)
dateYearDay
в class Chronology
era
- эра ISO, не нульyearOfEra
- год эры ISOdayOfYear
- день-летнего ISODateTimeException
- если неспособный создать датуpublic LocalDate dateYearDay(int prolepticYear, int dayOfYear)
Это эквивалентно LocalDate.ofYearDay(int, int)
.
dateYearDay
в class Chronology
prolepticYear
- преждевременно-летний ISOdayOfYear
- день-летнего ISODateTimeException
- если неспособный создать датуpublic LocalDate dateEpochDay(long epochDay)
Это эквивалентно LocalDate.ofEpochDay(long)
.
dateEpochDay
в class Chronology
epochDay
- день эпохиDateTimeException
- если неспособный создать датуpublic LocalDate date(TemporalAccessor temporal)
Это эквивалентно LocalDate.from(TemporalAccessor)
.
date
в class Chronology
temporal
- разовый датой объект преобразовать, не нульDateTimeException
- если неспособный создать датуChronoLocalDate.from(TemporalAccessor)
public LocalDateTime localDateTime(TemporalAccessor temporal)
Это эквивалентно LocalDateTime.from(TemporalAccessor)
.
localDateTime
в class Chronology
temporal
- разовый датой объект преобразовать, не нульDateTimeException
- если неспособный создать разовое датойChronoLocalDateTime.from(TemporalAccessor)
public ZonedDateTime zonedDateTime(TemporalAccessor temporal)
Это эквивалентно ZonedDateTime.from(TemporalAccessor)
.
zonedDateTime
в class Chronology
temporal
- разовый датой объект преобразовать, не нульDateTimeException
- если неспособный создать разовое датойChronoZonedDateTime.from(TemporalAccessor)
public ZonedDateTime zonedDateTime(Instant instant, ZoneId zone)
Instant
. Это эквивалентно ZonedDateTime.ofInstant(Instant, ZoneId)
.
zonedDateTime
в class Chronology
instant
- момент, чтобы создать разовое датой из, не нульzone
- часовой пояс, не нульDateTimeException
- если результат превышает поддерживаемый диапазонpublic LocalDate dateNow()
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
dateNow
в class Chronology
DateTimeException
- если неспособный создать датуpublic LocalDate dateNow(ZoneId zone)
Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
dateNow
в class Chronology
zone
- зональный ID, чтобы использовать, не нульDateTimeException
- если неспособный создать датуpublic LocalDate dateNow(Clock clock)
Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
dateNow
в class Chronology
clock
- часы, чтобы использовать, не нульDateTimeException
- если неспособный создать датуpublic boolean isLeapYear(long prolepticYear)
Этот метод применяет текущие правила в течение многих високосных годов через целую временную шкалу. Вообще, год является високосным годом, если это является делимым четыре без остатка. Однако, годы, делимые 100, не високосные годы, за исключением лет, делимых 400, которые являются.
Например, 1904 является високосным годом, это является делимым 4. 1900 не был високосным годом, поскольку это является делимым 100, однако 2000 был високосным годом, поскольку это является делимым 400.
Вычисление является преждевременным - применение тех же самых правил в далекое будущее и далеко мимо. Это исторически неточно, но корректно для стандарта ISO 8601.
isLeapYear
в class Chronology
prolepticYear
- ISO преждевременный год, чтобы проверитьpublic int prolepticYear(Era era, int yearOfEra)
Chronology
Это комбинирует эру и год эры в единственное преждевременно-летнее поле.
Если хронология делает активное использование эр, такой как JapaneseChronology
тогда год эры будет проверен против эры. Для других хронологий проверка допустимости является дополнительной.
prolepticYear
в class Chronology
era
- эра корректного типа для хронологии, не нульyearOfEra
- год эры хронологииpublic Era eraOf(int eraValue)
Chronology
Эра является, концептуально, крупнейшим подразделением временной шкалы. У большинства календарных систем есть единственная эпоха, делящая временную шкалу на две эры. Однако, у некоторых есть многократные эры, такой как один для господства каждого лидера. Точное значение определяется хронологией согласно следующим ограничениям.
У эры в использовании 01.01.1970 должно быть значение 1. У более поздних эр должны быть последовательно более высокие значения. У более ранних эр должны быть последовательно нижние значения. Каждая хронология должна обратиться к перечислимому или подобному одиночному элементу, чтобы обеспечить значения эры.
Этот метод возвращает одноэлементную эру корректного типа для указанного значения эры.
eraOf
в class Chronology
eraValue
- значение эрыpublic List<Era> eras()
Chronology
У большинства календарных систем есть эра, в пределах которой у года есть значение. Если календарная система не поддерживает понятие эр, пустой список должен быть возвращен.
eras
в class Chronology
public LocalDate resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)
ChronoField
значения в дату во время парсинга. Больше всего TemporalField
реализации разрешаются, используя метод решения на поле. В отличие от этого, ChronoField
class определяет поля, у которых только есть значение относительно хронологии. Также, ChronoField
поля даты разрешаются здесь в контексте определенной хронологии.
ChronoField
экземпляры на календарной системе ISO разрешаются следующим образом.
EPOCH_DAY
- Если существующий, это преобразовывается в a LocalDate
все другие поля даты тогда перепроверяются против даты PROLEPTIC_MONTH
- Если существующий, то это разделяется на YEAR
и MONTH_OF_YEAR
. Если режим строг или умен тогда, поле проверяется. YEAR_OF_ERA
и ERA
- Если оба присутствуют, то они объединяются, чтобы сформировать a YEAR
. В снисходительном режиме, YEAR_OF_ERA
диапазон не проверяется в умном и строгом режиме, который это. ERA
проверяется для диапазона во всех трех режимах. Если только YEAR_OF_ERA
присутствует, и режим умен или снисходителен, тогда текущая эра (CE/AD) принимается. В строгом режиме никакой ers не принимается и YEAR_OF_ERA
оставляется нетронутым. Если только ERA
присутствует, тогда это оставляют нетронутым. YEAR
, MONTH_OF_YEAR
и DAY_OF_MONTH
- Если все три присутствуют, то они объединяются, чтобы сформировать a LocalDate
. Во всех трех режимах, YEAR
проверяется. Если режим умен или строг, то месяц и день проверяются со днем, проверенным от 1 до 31. Если режим снисходителен, то дата объединяется способом, эквивалентным созданию даты первого января в требуемом году, то, добавляя различие в месяцах, то различие в днях. Если режим умен, и день-месячного больше чем максимум для месячного годом, то день-месячного корректируется к прошлому дню-месячного. Если режим строг, то эти три поля должны сформировать допустимую дату. YEAR
и DAY_OF_YEAR
- Если оба присутствуют, то они объединяются, чтобы сформировать a LocalDate
. Во всех трех режимах, YEAR
проверяется. Если режим снисходителен, то дата объединяется способом, эквивалентным созданию даты первого января в требуемом году, то, добавляя различие в днях. Если режим умен или строг, то эти два поля должны сформировать допустимую дату. YEAR
, MONTH_OF_YEAR
, ALIGNED_WEEK_OF_MONTH
и ALIGNED_DAY_OF_WEEK_IN_MONTH
- Если все четыре присутствуют, то они объединяются, чтобы сформировать a LocalDate
. Во всех трех режимах, YEAR
проверяется. Если режим снисходителен, то дата объединяется способом, эквивалентным созданию даты первого января в требуемом году, то, добавляя различие в месяцах, то различие в неделях, то в днях. Если режим умен или строг, то все четыре поля проверяются к их внешним диапазонам. Дата тогда объединяется способом, эквивалентным созданию даты в первый день требуемого года и месяца, затем добавляя количество в неделях и днях, чтобы достигнуть их значений. Если режим строг, дата дополнительно проверяется, чтобы проверить, что дневная и недельная корректировка не изменяла месяц. YEAR
, MONTH_OF_YEAR
, ALIGNED_WEEK_OF_MONTH
и DAY_OF_WEEK
- Если все четыре присутствуют, то они объединяются, чтобы сформировать a LocalDate
. Подход является тем же самым как описано выше в течение многих лет, месяцев и недель в ALIGNED_DAY_OF_WEEK_IN_MONTH
. День-недельного корректируется как следующее или тот же самый день-недельного соответствия однажды годы, месяцы и недели были обработаны. YEAR
, ALIGNED_WEEK_OF_YEAR
и ALIGNED_DAY_OF_WEEK_IN_YEAR
- Если все три присутствуют, то они объединяются, чтобы сформировать a LocalDate
. Во всех трех режимах, YEAR
проверяется. Если режим снисходителен, то дата объединяется способом, эквивалентным созданию даты первого января в требуемом году, то, добавляя различие в неделях, то в днях. Если режим умен или строг, то все три поля проверяются к их внешним диапазонам. Дата тогда объединяется способом, эквивалентным созданию даты в первый день требуемого года, затем добавляя количество в неделях и днях, чтобы достигнуть их значений. Если режим строг, дата дополнительно проверяется, чтобы проверить, что дневная и недельная корректировка не изменяла год. YEAR
, ALIGNED_WEEK_OF_YEAR
и DAY_OF_WEEK
- Если все три присутствуют, то они объединяются, чтобы сформировать a LocalDate
. Подход является тем же самым как описано выше в течение многих лет и недель в ALIGNED_DAY_OF_WEEK_IN_YEAR
. День-недельного корректируется как следующее или тот же самый день-недельного соответствия однажды годы, и недели были обработаны. resolveDate
в class Chronology
fieldValues
- карта полей к значениям, которые могут быть обновлены, не нульresolverStyle
- требуемый тип решения, не нульDateTimeException
- если дата не может быть разрешена, обычно из-за конфликта во входных данныхpublic ValueRange range(ChronoField field)
Chronology
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
Этот метод возвратит результат, поддерживает ли хронология поле.
range
в class Chronology
field
- поле, чтобы получить диапазон для, не нуль
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92