WeekFields — 지역화된 주(week) 정의

WeekFields — 지역화된 주(week) 정의

요일, 월-주, 연-주 필드의 지역화된 정의를 제공하는 클래스예요.

출처: Java API Reference

본문

시그니처

public final class WeekFields extends Object
    implements Serializable

구현된 인터페이스: Serializable.

설명

표준 주는 7일 길이지만, 문화마다 주의 다른 측면에 대한 정의가 달라요. 이 클래스는 TemporalField 인스턴스를 제공하기 위한 목적으로 주의 정의를 나타내요.

WeekFields는 다섯 개의 필드를 제공해요 — dayOfWeek(), weekOfMonth(), weekOfYear(), weekOfWeekBasedYear(), weekBasedYear(). 이 필드들은 어떤 temporal 객체에서든 그 값에 접근할 수 있게 해 줘요.

요일, 월-주, 연-주 계산은 epoch-day와 크로놀로지에 기반한 proleptic 연도, 월-기준, 일-기준, ISO 요일에 기반해요. 크로놀로지에 따라 그 값들이 year-of-Era와 정렬되지 않을 수 있어요.

주는 다음과 같이 정의돼요

  • 첫 번째 요일 — 예를 들어 ISO-8601 표준은 월요일을 첫 번째 요일로 간주해요.
  • 첫 주의 최소 일 수 — 예를 들어 ISO-8601 표준은 첫 주가 최소 4일이 필요하다고 셉니다.

이 두 값이 함께 연도나 월을 주로 나눌 수 있게 해 줘요.

월-주 (Week of Month)

월-주 필드 하나를 사용해요. 계산은 주가 월 경계를 겹치지 않도록 보장해요. 월은 각 기간이 정의된 첫 번째 요일에 시작하는 기간들로 나뉘어요. 가장 이른 기간은 최소 일 수보다 적으면 주 0, 최소 일 수 이상이면 주 1로 불려요.

주요 메서드

  • of(DayOfWeek firstDayOfWeek, int minimalDaysInFirstWeek) — 첫 번째 요일과 첫 주 최소 일 수를 가진 WeekFields 인스턴스를 얻어요.
  • ISO — ISO-8601 정의(월요일 시작, 최소 4일)를 나타내는 상수 필드예요.
  • SUNDAY_START — 일요일 시작(미국식) 정의를 나타내는 상수 필드예요.
  • dayOfWeek() — 요일 필드를 얻어요.
  • weekOfMonth() — 월-주 필드를 얻어요.
  • weekOfYear() — 연-주 필드를 얻어요.
  • weekBasedYear() — 주 기반 연도 필드를 얻어요.
  • getFirstDayOfWeek() — 첫 번째 요일을 얻어요.
  • getMinimalDaysInFirstWeek() — 첫 주의 최소 일 수를 얻어요.

더 알아보기 (Learn more)