YearMonth — 연-월

YearMonth — 연-월

ISO-8601 달력 체계에서 2007-12 같은 연과 월의 조합을 나타내는 불변 클래스예요.

출처: Java API Reference

본문

시그니처

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

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

설명

YearMonth는 불변(immutable) 날짜-시간 객체로, 연과 월의 조합을 나타내요. 분기-기준 같은 연과 월에서 파생할 수 있는 모든 필드를 얻을 수 있어요.

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

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

주요 메서드

  • now() — 시스템 시계에서 현재 연-월을 얻어요.
  • of(int year, int month) — 연과 월에서 YearMonth 인스턴스를 얻어요.
  • parse(CharSequence text) — ISO-8601 텍스트에서 YearMonth 인스턴스를 얻어요.
  • atDay(int dayOfMonth) — 이 연-월을 일-기준과 결합해 LocalDate를 만들어요.
  • atEndOfMonth() — 월의 끝에 있는 LocalDate를 반환해요.
  • plusMonths(long monthsToAdd) — 월을 더한 이 연-월의 복사본을 반환해요.
  • getYear() — 연도 필드를 얻어요.
  • getMonth() — 월-기준 월 필드를 얻어요.
  • getMonthValue() — 1에서 12 사이의 월-기준 int 값을 얻어요.
  • lengthOfMonth() — 이 월의 일 수를 얻어요.
  • isLeapYear() — 이 연도가 윤년인지 확인해요.
  • isBefore(YearMonth other) / isAfter(YearMonth other) — 다른 연-월보다 이전/이후인지 확인해요.

더 알아보기 (Learn more)