net.time4j.engine

Class StartOfDay

java.lang.Object

net.time4j.engine.StartOfDay

public abstract class StartOfDay
extends Object

Defines the start of a given calendar day relative to midnight in seconds.

Specification: All subclasses must be immutable.

Since:

3.5/4.3

Author:

Meno Hochschild

Field Summary

Fields

Modifier and Type	Field and Description
static StartOfDay	EVENING Start of calendar day at 18:00 on previous day.
static StartOfDay	MIDNIGHT Default start of calendar day at midnight.
static StartOfDay	MORNING Start of calendar day at 06:00 in the morning.

Method Summary

Modifier and Type	Method and Description
abstract int	getDeviation(Calendrical<?,?> calendarDay, TZID tzid) Yields the start of given calendar day relative to midnight in seconds.
static StartOfDay	ofFixedDeviation(int deviation) Liefert the start of given calendar day relative to midnight in fixed seconds.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MIDNIGHT

public static final StartOfDay MIDNIGHT

Default start of calendar day at midnight.

EVENING

public static final StartOfDay EVENING

Start of calendar day at 18:00 on previous day.

MORNING

public static final StartOfDay MORNING

Start of calendar day at 06:00 in the morning.

Method Detail

ofFixedDeviation

public static StartOfDay ofFixedDeviation(int deviation)

Liefert the start of given calendar day relative to midnight in fixed seconds.

A negative deviation is explicitly allowed and refers to the previous calendar day.

Parameters:

deviation - the deviation of start of day relative to midnight in seconds on the local timeline

Returns:

start of day

Throws:

IllegalArgumentException - if the argument is out of range -43200 < deviation <= 43200

Since:

3.5/4.3

getDeviation

public abstract int getDeviation(Calendrical<?,?> calendarDay,
                                 TZID tzid)

Yields the start of given calendar day relative to midnight in seconds.

Parameters:

calendarDay - calendar day

tzid - timezone identifier, helps to resolve an UTC-event like sunset to a local time

Returns:

nominal deviation of start of day relative to midnight in seconds on the local timeline

Since:

3.5/4.3