IsoFields

Fields and units specific to the ISO-8601 calendar system, including quarter-of-year and week-based-year.

This class defines fields and units that are specific to the ISO calendar system.

Quarter of year

The ISO-8601 standard is based on the standard civic 12 month year. This is commonly divided into four quarters, often abbreviated as Q1, Q2, Q3 and Q4.

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

Week based years

The ISO-8601 standard was originally intended as a data interchange format, defining a string format for dates and times. However, it also defines an alternate way of expressing the date, based on the concept of week-based-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.

If January 1st is Monday then week 1 starts on January 1st
If January 1st is Tuesday then week 1 starts on December 31st of the previous standard year
If January 1st is Wednesday then week 1 starts on December 30th of the previous standard year
If January 1st is Thursday then week 1 starts on December 29th of the previous standard year
If January 1st is Friday then week 1 starts on January 4th
If January 1st is Saturday then week 1 starts on January 3rd
If January 1st is Sunday then week 1 starts on January 2nd

There are 52 weeks in most week-based years, however on occasion there are 53 weeks.

For example:

Examples of Week based Years
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

Specification for implementors

This class is immutable and thread-safe.

Linear Supertypes

AnyRef, Any

Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
lazy val DAY_OF_QUARTER: TemporalField

The field that represents the day-of-quarter.
The field that represents the 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.
lazy val QUARTER_OF_YEAR: TemporalField

The field that represents the quarter-of-year.
The field that represents the 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.
lazy val QUARTER_YEARS: TemporalUnit

Unit that represents the concept of a quarter-year.
Unit that represents the concept of a quarter-year. For the ISO calendar system, it is equal to 3 months. The estimated duration of a quarter-year is one quarter of 365.2425 Days.
This unit is an immutable and thread-safe singleton.
lazy val WEEK_BASED_YEAR: TemporalField

The field that represents the week-based-year.
The field that represents the 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.
lazy val WEEK_BASED_YEARS: TemporalUnit

The unit that represents week-based-years for the purpose of addition and subtraction.
The unit that represents week-based-years for the purpose of addition and subtraction.
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.
lazy val WEEK_OF_WEEK_BASED_YEAR: TemporalField

The field that represents the week-of-week-based-year.
The field that represents the 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.
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): scala.Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): scala.Unit

Definition Classes
AnyRef
final def notifyAll(): scala.Unit

Definition Classes
AnyRef
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def toString(): String

Definition Classes
AnyRef → Any
final def wait(): scala.Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): scala.Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): scala.Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

Related Doc: package temporal

object IsoFields

Quarter of year

Week based years

Specification for implementors

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: Any): Boolean

lazy val DAY_OF_QUARTER: TemporalField

lazy val QUARTER_OF_YEAR: TemporalField

lazy val QUARTER_YEARS: TemporalUnit

lazy val WEEK_BASED_YEAR: TemporalField

lazy val WEEK_BASED_YEARS: TemporalUnit

lazy val WEEK_OF_WEEK_BASED_YEAR: TemporalField

final def asInstanceOf[T0]: T0

def clone(): AnyRef

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): scala.Unit

final def getClass(): Class[_]

def hashCode(): Int

final def isInstanceOf[T0]: Boolean

final def ne(arg0: AnyRef): Boolean

final def notify(): scala.Unit

final def notifyAll(): scala.Unit

final def synchronized[T0](arg0: ⇒ T0): T0

def toString(): String

final def wait(): scala.Unit

final def wait(arg0: Long, arg1: Int): scala.Unit

final def wait(arg0: Long): scala.Unit

Inherited from AnyRef

Inherited from Any

Ungrouped