net.time4j

Enum Quarter

java.lang.Object

java.lang.Enum<Quarter>

net.time4j.Quarter

All Implemented Interfaces:

Serializable, Comparable<Quarter>, ChronoCondition<GregorianDate>

public enum Quarter
extends Enum<Quarter>
implements ChronoCondition<GregorianDate>

Represents a quarter (in most cases of a year).

Author:

Meno Hochschild

Enum Constant Summary

Enum Constants

Enum Constant and Description
Q1 First quarter with the numerical value 1.
Q2 Second quarter with the numerical value 2.
Q3 Third quarter with the numerical value 3.
Q4 Last quarter with the numerical value 4.

Method Summary

Methods

Modifier and Type	Method and Description
String	getDisplayName(Locale locale) Equivalent to the expression getDisplayName(locale, TextWidth.WIDE, OutputContext.FORMAT).
String	getDisplayName(Locale locale, TextWidth width, OutputContext context) Gets the description text dependent on the locale and style parameters.
int	getValue() Gets the corresponding numerical value.
Quarter	next() Rolls to the next quarter.
static Quarter	parse(CharSequence text, Locale locale, TextWidth width, OutputContext context) Tries to interprete given text as quarter of year.
Quarter	previous() Rolls to the previous quarter.
Quarter	roll(int quarters) Rolls by given amount of quarters.
boolean	test(GregorianDate context) Decides if given context matches this condition.
static Quarter	valueOf(int quarter) Gets the enum-constant which corresponds to the given numerical value.
static Quarter	valueOf(String name) Returns the enum constant of this type with the specified name.
static Quarter[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

Q1

public static final Quarter Q1

First quarter with the numerical value 1.

Q2

public static final Quarter Q2

Second quarter with the numerical value 2.

Q3

public static final Quarter Q3

Third quarter with the numerical value 3.

Q4

public static final Quarter Q4

Last quarter with the numerical value 4.

Method Detail

values

public static Quarter[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Quarter c : Quarter.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Quarter valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

valueOf

public static Quarter valueOf(int quarter)

Gets the enum-constant which corresponds to the given numerical value.

Parameters:

quarter - value in the range [1-4]

Returns:

enum

Throws:

IllegalArgumentException - if given argument is out of range

getValue

public int getValue()

Gets the corresponding numerical value.

Returns:

int (Q1 = 1, Q2 = 2, Q3 = 3, Q4 = 4)

next

public Quarter next()

Rolls to the next quarter.

The result is Q1 if this method is applied on Q4.

Returns:

next quarter rolling at last quarter

previous

public Quarter previous()

Rolls to the previous quarter.

The result is Q4 if this method is applied on Q1.

Returns:

previous quarter rolling at first quarter

roll

public Quarter roll(int quarters)

Rolls by given amount of quarters.

Parameters:

quarters - count of quarters (maybe negative)

Returns:

result of rolling operation

getDisplayName

public String getDisplayName(Locale locale)

Equivalent to the expression getDisplayName(locale, TextWidth.WIDE, OutputContext.FORMAT).

Parameters:

locale - language setting

Returns:

descriptive text (long form, never null)

See Also:

Quarter.getDisplayName(Locale, TextWidth, OutputContext)

getDisplayName

public String getDisplayName(Locale locale,
                    TextWidth width,
                    OutputContext context)

Gets the description text dependent on the locale and style parameters.

The second argument controls the width of description while the third argument is only relevant for languages which make a difference between stand-alone forms and embedded text forms (does not matter in English).

Parameters:

locale - language setting

width - text width

context - output context

Returns:

descriptive text for given locale and style (never null)

parse

public static Quarter parse(CharSequence text,
            Locale locale,
            TextWidth width,
            OutputContext context)
                     throws ParseException

Tries to interprete given text as quarter of year.

Parameters:

text - the text to be parsed

locale - language setting

width - expected text width

context - expected output context

Returns:

the parsed quarter of year if successful

Throws:

ParseException - if parsing fails

Since:

3.33/4.28

See Also:

Quarter.getDisplayName(Locale, TextWidth, OutputContext)

test

public boolean test(GregorianDate context)

Description copied from interface: ChronoCondition

Decides if given context matches this condition.

Due to better readability it is recommended to use following equivalent approach instead of this method::

  import static net.time4j.Weekday.SATURDAY;
  import static net.time4j.Month.JANUARY;

  PlainDate date = PlainDate.of(2014, JANUARY, 25);
  System.out.println(SATURDAY.test(date)); // direct use
  System.out.println(date.matches(SATURDAY)); // recommended callback
 

Specified by:

test in interface ChronoCondition<GregorianDate>

Parameters:

context - context as base of testing this condition

Returns:

true if given time context matches this condition else false