net.time4j

Enum Meridiem

java.lang.Object

java.lang.Enum<Meridiem>

net.time4j.Meridiem

All Implemented Interfaces:

Serializable, Comparable<Meridiem>, ChronoCondition<WallTime>

public enum Meridiem
extends Enum<Meridiem>
implements ChronoCondition<WallTime>

Represents the half day relative to noon.

Author:

Meno Hochschild

Enum Constant Summary

Enum Constants

Enum Constant and Description
AM Marks the wall time from midnight (at start of day) until before noon (ante meridiem).
PM Marks the wall time at or after noon (post meridiem).

Method Summary

Methods

Modifier and Type	Method and Description
String	getDisplayName(Locale locale) Gets a descriptive text in given language.
static Meridiem	ofHour(int hour) Calculates the meridiem value dependent on given hour of day.
boolean	test(WallTime context) Decides if given context matches this condition.
static Meridiem	valueOf(String name) Returns the enum constant of this type with the specified name.
static Meridiem[]	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

AM

public static final Meridiem AM

Marks the wall time from midnight (at start of day) until before noon (ante meridiem).

The numerical value is 0.

PM

public static final Meridiem PM

Marks the wall time at or after noon (post meridiem).

The numerical value is 1.

Method Detail

values

public static Meridiem[] 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 (Meridiem c : Meridiem.values())
    System.out.println(c);

Returns:

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

valueOf

public static Meridiem 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

ofHour

public static Meridiem ofHour(int hour)

Calculates the meridiem value dependent on given hour of day.

Parameters:

hour - ISO-hour in the range 0 <= hour <= 24

Returns:

half of day (ante meridiem or post meridiem)

Throws:

IllegalArgumentException - if the hour is out of range

See Also:

PlainTime.AM_PM_OF_DAY

getDisplayName

public String getDisplayName(Locale locale)

Gets a descriptive text in given language.

Parameters:

locale - language of text to be printed

Returns:

localized text in given language

test

public boolean test(WallTime 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<WallTime>

Parameters:

context - context as base of testing this condition

Returns:

true if given time context matches this condition else false