Year — 연도

Year — 연도

ISO-8601 달력 체계에서 2007 같은 연도를 나타내는 불변 클래스예요.

출처: Java API Reference

본문

시그니처

public final class Year extends Object
    implements Temporal, TemporalAdjuster, Comparable<Year>, Serializable

구현된 인터페이스: Serializable, Comparable<Year>, Temporal, TemporalAccessor, TemporalAdjuster.

설명

Year는 불변(immutable) 날짜-시간 객체로, 연도를 나타내요. 연도에서 파생할 수 있는 모든 필드를 얻을 수 있어요.

참고로 ISO 크로놀로지의 연도는 현대 연도에서만 그레고리-율리우스 체계의 연도와 정렬돼요. 러시아 일부 지역은 1920년까지 현대 그레고리/ISO 규칙으로 전환하지 않았어요. 따라서 역사적 연도는 주의해서 다뤄야 해요.

이 클래스는 월, 일, 시간, 시간대를 저장하거나 나타내지 않아요. 예를 들어 "2007"이라는 값을 Year에 저장할 수 있어요.

이 클래스가 나타내는 연도는 ISO-8601 표준을 따르고 proleptic 번호 체계를 사용해요. 1년 앞에는 0년, 그 앞에는 -1년이 있어요.

이 클래스는 값 기반(value-based) 클래스예요. 프로그래머는 서로 같은 인스턴스를 교환 가능하게 취급해야 하며, 동기화에 인스턴스를 사용하면 안 돼요. 비교에는 equals 메서드를 사용해야 해요.

주요 메서드

  • now() — 시스템 시계에서 현재 연도를 얻어요.
  • of(int isoYear) — ISO 연도에서 Year 인스턴스를 얻어요.
  • parse(CharSequence text) — ISO-8601 텍스트에서 Year 인스턴스를 얻어요.
  • getValue() — 연도를 얻어요.
  • isLeap() — 이 연도가 ISO proleptic 체계의 윤년인지 확인해요.
  • isLeap(long year) — 지정한 연도가 윤년인지 확인하는 정적 메서드예요.
  • atDay(int dayOfYear) — 이 연도를 일-기준과 결합해 LocalDate를 만들어요.
  • atMonth(int month) — 이 연도를 월과 결합해 YearMonth를 만들어요.
  • plusYears(long yearsToAdd) — 연도를 더한 이 연도의 복사본을 반환해요.
  • length() — 이 연도의 일 수를 얻어요.
  • adjustInto(Temporal temporal) — 지정한 temporal 객체가 이 연도를 갖도록 조정해요.

더 알아보기 (Learn more)