다음을 통해 공유


DateTimeFormatter.WithZone(ZoneId) 메서드

정의

새 재정의 영역이 있는 이 포맷터의 복사본을 반환합니다.

[Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithZone (Java.Time.ZoneId? zone);
[<Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithZone : Java.Time.ZoneId -> Java.Time.Format.DateTimeFormatter

매개 변수

zone
ZoneId

새 재정의 영역, 재정의가 없으면 null

반환

null이 아닌 요청된 재정의 영역이 있는 이 포맷터를 기반으로 하는 포맷터

특성

설명

새 재정의 영역이 있는 이 포맷터의 복사본을 반환합니다.

이렇게 하면 이 포맷터와 상태가 비슷하지만 재정의 영역이 설정된 포맷터가 반환됩니다. 기본적으로 포맷터는 재정의 영역이 없으므로 null을 반환합니다.

재정의가 추가되면 형식이 지정되거나 구문 분석된 모든 인스턴트가 영향을 받습니다.

서식을 지정할 때 temporal 개체에 인스턴트가 포함된 경우 재정의 영역을 사용하여 영역화된 날짜-시간으로 변환됩니다. temporal이 인스턴트인지 여부는 필드를 쿼리하여 ChronoField#INSTANT_SECONDS INSTANT_SECONDS 결정됩니다. 입력에 연대가 있는 경우 재정의되지 않는 한 유지됩니다. 입력에 같은 연대가 Instant없으면 ISO 연대가 사용됩니다.

temporal 개체에 인스턴트가 포함되지 않지만 오프셋이 포함되어 있으면 추가 검사가 수행됩니다. 정규화된 재정의 영역이 temporal의 오프셋과 다른 오프셋이면 throw DateTimeException 됩니다. 다른 모든 경우에서 재정의 영역은 날짜/시간을 변경하지 않고 이전 영역을 대체하여 temporal에 추가됩니다.

구문 분석할 때 고려해야 할 두 가지 개별 사례가 있습니다. 영역이 사용되었기 때문에 DateTimeFormatterBuilder#appendZoneId() 텍스트에서 직접 구문 분석된 경우 이 재정의 영역은 아무런 영향을 주지 않습니다. 구문 분석된 영역이 없는 경우 이 재정의 영역은 인스턴스 및 날짜 시간을 빌드하는 데 사용할 수 있는 구문 분석 결과에 포함됩니다.

이 인스턴스는 변경할 수 없으며 이 메서드 호출의 영향을 받지 않습니다.

에 대한 java.time.format.DateTimeFormatter.withZone(java.time.ZoneId)Java 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

적용 대상