DateTimeFormatter.WithChronology(IChronology) Метод

Определение

Пространство имен:

Java.Time.Format

Сборка:

Mono.Android.dll

Возвращает копию этого модуля форматирования с новым переопределением хронологии.

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);

[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

Параметры

chrono

IChronology

новая хронология, значение NULL, если переопределение не переопределяется

Возвращаемое значение

DateTimeFormatter

форматировщик на основе этого модуля форматирования с запрошенной переопределением хронологии, а не null

Атрибуты

RegisterAttribute

Комментарии

Возвращает копию этого модуля форматирования с новым переопределением хронологии.

При этом возвращается форматировщик с аналогичным состоянием этого модуля форматирования, но с переопределением набора хронологии. По умолчанию метод форматирования не переопределяет хронологию, возвращая значение NULL.

Если добавляется переопределение, то будет затронута любая дата форматирования или синтаксического анализа.

При форматировании, если темпоральный объект содержит дату, она будет преобразована в дату в хронологии переопределения. Определяется ли темпоральная дата путем запроса ChronoField#EPOCH_DAY EPOCH_DAY поля. Любое время или пояс будут сохранены без переопределения.

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

При синтаксическом анализе следует учитывать два разных случая. Если хронология была проанализирована непосредственно из текста, возможно, потому что DateTimeFormatterBuilder#appendChronologyId() она была использована, то этот переопределение хронологии не имеет никакого эффекта. Если зона не была проанализирована, эта переопределение хронологии будет использоваться для интерпретации ChronoField значений в дату в соответствии с правилами разрешения даты хронологии.

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

Java документации по java.time.format.DateTimeFormatter.withChronology(java.time.chrono.Chronology).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".