ZonedDateTime.With 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| 속성 | Description |
|---|---|
| With(ITemporalField, Int64) |
지정된 필드가 새 값으로 설정된 이 날짜-시간의 복사본을 반환합니다. |
| With(ITemporalAdjuster) |
이 날짜-시간의 조정된 복사본을 반환합니다. |
With(ITemporalField, Int64)
지정된 필드가 새 값으로 설정된 이 날짜-시간의 복사본을 반환합니다.
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
매개 변수
- field
- ITemporalField
null이 아닌 결과에 설정할 필드입니다.
- newValue
- Int64
결과에서 필드의 새 값
반품
Null이 아닌 지정된 필드 집합을 사용하여 이를 기반으로 하는 ZonedDateTime
- 특성
설명
지정된 필드가 새 값으로 설정된 이 날짜-시간의 복사본을 반환합니다. 지정된 필드에 대한 값이 변경된 상태에서 이 값에 따라 ZonedDateTime을 반환합니다. 연도, 월 또는 월과 같은 지원되는 필드를 변경하는 데 사용할 수 있습니다. 필드가 지원되지 않거나 다른 이유로 인해 값을 설정할 수 없는 경우 예외가 throw됩니다. 경우에 따라 지정된 필드를 변경하면 월을 1월 31일에서 2월로 변경하면 해당 월의 날짜가 유효하지 않을 수 있습니다. 이와 같은 경우 필드는 날짜를 확인할 책임이 있습니다. 일반적으로 이 예제에서는 2월의 마지막 유효 날짜인 이전 유효 날짜를 선택합니다. 필드가 ChronoField인 경우 조정이 여기에 구현됩니다. INSTANT_SECONDS 필드는 지정된 인스턴트를 사용하여 날짜-시간을 반환합니다. 영역 및 나노 초는 변경되지 않습니다. 결과에는 새 인스턴트 및 원래 영역에서 파생된 오프셋이 있습니다. 새 인스턴트 값이 유효한 범위를 벗어나면 DateTimeException이 throw됩니다. OFFSET_SECONDS 필드는 일반적으로 무시됩니다. ZonedDateTime의 오프셋은 주로 표준 시간대에 의해 제어됩니다. 따라서 로컬 날짜-시간 및 영역에 대해 유효한 오프셋이 하나만 있기 때문에 오프셋을 변경하는 것은 일반적으로 의미가 없습니다. 영역이 지정된 날짜-시간이 일광 절약 시간이 겹치는 경우 오프셋을 사용하여 두 개의 유효한 오프셋 사이를 전환합니다. 다른 모든 경우에는 오프셋이 무시됩니다. 새 오프셋 값이 유효한 범위를 벗어나면 DateTimeException이 throw됩니다. 지원되는 다른 필드는 LocalDateTime의 일치 메서드에 따라 동작합니다. 영역은 계산의 일부가 아니며 변경되지 않습니다. 다시 ZonedDateTime으로 변환할 때 로컬 날짜-시간이 겹치는 경우 가능한 경우 오프셋이 유지되고, 그렇지 않으면 이전 오프셋이 사용됩니다. 간격이 있는 경우 간격의 길이에 따라 현지 날짜-시간이 앞으로 조정됩니다. 다른 모든 ChronoField 인스턴스는 UnsupportedTemporalTypeException을 throw합니다. 필드가 ChronoField가 아니면 TemporalField.adjustInto(Temporal, long)를 호출하여 이 메서드의 결과를 인수로 전달합니다. 이 경우 필드는 인스턴트 조정 여부와 방법을 결정합니다. 이 인스턴스는 변경할 수 없으며 이 메서드 호출의 영향을 받지 않습니다.
에 대한 java.time.ZonedDateTime.withJava 참조
적용 대상
With(ITemporalAdjuster)
이 날짜-시간의 조정된 복사본을 반환합니다.
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.ZonedDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.ZonedDateTime
매개 변수
- adjuster
- ITemporalAdjuster
null이 아닌 사용할 조정자
반품
Null이 아닌 조정을 사용하여 이를 기반으로 하는 ZonedDateTime
- 특성
설명
이 날짜-시간의 조정된 복사본을 반환합니다. 이렇게 하면 날짜-시간이 조정된 ZonedDateTime이 반환됩니다. 조정은 지정된 조정자 전략 개체를 사용하여 이루어집니다. 조정자의 설명서를 읽고 조정자가 어떤 조정을 할 것인지 이해합니다. 간단한 조정자는 연도 필드와 같은 필드 중 하나를 설정하기만 하면 됩니다. 더 복잡한 조정자는 날짜를 월의 마지막 날로 설정할 수 있습니다. TemporalAdjusters에서 일반적인 조정을 선택할 수 있습니다. 여기에는 "월의 마지막 날" 및 "다음 수요일"을 찾는 것이 포함됩니다. 또한 주요 날짜-시간 클래스는 Month 및 MonthDay와 같은 TemporalAdjuster 인터페이스를 구현합니다. 조정자는 월 및 윤년의 다양한 길이와 같은 특별한 경우를 처리할 책임이 있습니다. 예를 들어 이 코드는 7월 마지막 날의 날짜를 반환합니다. LocalDate 및 LocalTime 클래스는 TemporalAdjuster를 구현하므로 이 메서드를 사용하여 날짜, 시간 또는 오프셋을 변경할 수 있습니다. ZoneOffset은 TemporalAdjuster도 구현합니다. 그러나 일반적으로 인수로 사용하면 아무런 효과가 없습니다. ZonedDateTime의 오프셋은 주로 표준 시간대에 의해 제어됩니다. 따라서 로컬 날짜-시간 및 영역에 대해 유효한 오프셋이 하나만 있기 때문에 오프셋을 변경하는 것은 일반적으로 의미가 없습니다. 영역이 지정된 날짜-시간이 일광 절약 시간이 겹치는 경우 오프셋을 사용하여 두 개의 유효한 오프셋 사이를 전환합니다. 다른 모든 경우에는 오프셋이 무시됩니다. 이 메서드의 결과는 지정된 조정자에서 TemporalAdjuster.adjustInto(Temporal) 메서드를 호출하여 인수로 전달하여 가져옵니다. 이 인스턴스는 변경할 수 없으며 이 메서드 호출의 영향을 받지 않습니다.
에 대한 java.time.ZonedDateTime.withJava 참조