TemporalAccessor — temporal 객체 읽기 전용 접근 인터페이스

TemporalAccessor — temporal 객체 읽기 전용 접근 인터페이스

날짜, 시간, 오프셋 또는 이들의 조합 같은 temporal 객체에 대한 읽기 전용 접근을 정의하는 프레임워크 수준 인터페이스예요.

출처: Java API Reference

본문

시그니처

public interface TemporalAccessor

알려진 하위 인터페이스: ChronoLocalDate, ChronoLocalDateTime<D>, ChronoZonedDateTime<D>, Era, Temporal.

설명

이런 것이 날짜, 시간, 오프셋 객체의 기본 인터페이스 유형이에요. 필드나 쿼리로 정보를 제공할 수 있는 클래스들이 구현해요.

대부분의 날짜·시간 정보는 숫자로 표현할 수 있어요. 이들은 큰 값을 다루기 위해 long으로 숫자를 보관하는 TemporalField로 모델링돼요. 연, 월, 일은 필드의 단순한 예시이며, instant와 offset도 포함돼요. 표준 필드 집합은 ChronoField를 참고하세요.

숫자로 표현할 수 없는 두 가지 날짜·시간 정보는 크로놀로지(chronology)와 시간대(time-zone)예요. 이들은 TemporalQuery에 정의된 정적 메서드를 사용한 쿼리를 통해 접근할 수 있어요.

하위 인터페이스인 Temporal은 이 정의를 더 완전한 temporal 객체의 조정·조작을 지원하는 것으로 확장해요.

이 인터페이스는 애플리케이션 코드에서 널리 사용하면 안 되는 프레임워크 수준 인터페이스예요. 대신 애플리케이션은 LocalDate 같은 구체적인 타입의 인스턴스를 만들고 전달해야 해요. 그 이유 중 하나는 이 인터페이스의 구현이 ISO가 아닌 달력 체계에 있을 수 있기 때문이에요.

주요 메서드

  • get(TemporalField field) — 지정한 필드의 값을 int로 얻어요.
  • getLong(TemporalField field) — 지정한 필드의 값을 long으로 얻어요.
  • isSupported(TemporalField field) — 지정한 필드가 지원되는지 확인해요.
  • range(TemporalField field) — 지정한 필드의 유효 값 범위를 얻어요.
  • query(TemporalQuery<R> query) — 이 날짜-시간을 쿼리해요.

더 알아보기 (Learn more)