public final class IsoFields extends Object
This class defines fields and units that are specific to the ISO calendar system.
January, February and March are in Q1. April, May and June are in Q2. July, August and September are in Q3. October, November and December are in Q4.
The complete date is expressed using three fields:
DAY_OF_QUARTER
- the day within the quarter, from 1 to 90, 91 or 92
QUARTER_OF_YEAR
- the week within the week-based-year
YEAR
- the standard ISO year
The date is expressed using three fields:
DAY_OF_WEEK
- the standard field defining the
day-of-week from Monday (1) to Sunday (7)
WEEK_OF_WEEK_BASED_YEAR
- the week within the week-based-year
WEEK_BASED_YEAR
- the week-based-year
The week-based-year itself is defined relative to the standard ISO proleptic year. It differs from the standard year in that it always starts on a Monday.
The first week of a week-based-year is the first Monday-based week of the standard ISO year that has at least 4 days in the new year.
There are 52 weeks in most week-based years, however on occasion there are 53 weeks.
For example:
Date | Day-of-week | Field values |
---|---|---|
2008-12-28 | Sunday | Week 52 of week-based-year 2008 |
2008-12-29 | Monday | Week 1 of week-based-year 2009 |
2008-12-31 | Wednesday | Week 1 of week-based-year 2009 |
2009-01-01 | Thursday | Week 1 of week-based-year 2009 |
2009-01-04 | Sunday | Week 1 of week-based-year 2009 |
2009-01-05 | Monday | Week 2 of week-based-year 2009 |
This class is immutable and thread-safe.
Modifier and Type | Field and Description |
---|---|
static TemporalField |
DAY_OF_QUARTER
The field that represents the day-of-quarter.
|
static TemporalField |
QUARTER_OF_YEAR
The field that represents the quarter-of-year.
|
static TemporalUnit |
QUARTER_YEARS
Unit that represents the concept of a quarter-year.
|
static TemporalField |
WEEK_BASED_YEAR
The field that represents the week-based-year.
|
static TemporalUnit |
WEEK_BASED_YEARS
The unit that represents week-based-years for the purpose of addition and subtraction.
|
static TemporalField |
WEEK_OF_WEEK_BASED_YEAR
The field that represents the week-of-week-based-year.
|
public static final TemporalField DAY_OF_QUARTER
This field allows the day-of-quarter value to be queried and set. The day-of-quarter has values from 1 to 90 in Q1 of a standard year, from 1 to 91 in Q1 of a leap year, from 1 to 91 in Q2 and from 1 to 92 in Q3 and Q4.
The day-of-quarter can only be calculated if the day-of-year, month-of-year and year are available.
When setting this field, the value is allowed to be partially lenient, taking any value from 1 to 92. If the quarter has less than 92 days, then day 92, and potentially day 91, is in the following quarter.
This unit is an immutable and thread-safe singleton.
public static final TemporalField QUARTER_OF_YEAR
This field allows the quarter-of-year value to be queried and set. The quarter-of-year has values from 1 to 4.
The day-of-quarter can only be calculated if the month-of-year is available.
This unit is an immutable and thread-safe singleton.
public static final TemporalField WEEK_OF_WEEK_BASED_YEAR
This field allows the week of the week-based-year value to be queried and set.
This unit is an immutable and thread-safe singleton.
public static final TemporalField WEEK_BASED_YEAR
This field allows the week-based-year value to be queried and set.
This unit is an immutable and thread-safe singleton.
public static final TemporalUnit WEEK_BASED_YEARS
This allows a number of week-based-years to be added to, or subtracted from, a date.
The unit is equal to either 52 or 53 weeks.
The estimated duration of a week-based-year is the same as that of a standard ISO
year at 365.2425 Days
.
The rules for addition add the number of week-based-years to the existing value for the week-based-year field. If the resulting week-based-year only has 52 weeks, then the date will be in week 1 of the following week-based-year.
This unit is an immutable and thread-safe singleton.
public static final TemporalUnit QUARTER_YEARS
365.2425 Days
.
This unit is an immutable and thread-safe singleton.
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT internal-0