net.time4j.calendar.astro

Class LunarTime.Builder

java.lang.Object

net.time4j.calendar.astro.LunarTime.Builder

Enclosing class:

LunarTime

public static class LunarTime.Builder
extends Object

Helper class to construct a new instance of LunarTime.

Since:

3.38/4.33

Author:

Meno Hochschild

Method Summary

Modifier and Type	Method and Description
LunarTime.Builder	atAltitude(int altitude) Sets the altitude in meters.
LunarTime	build() Finishes the build-process.
LunarTime.Builder	easternLongitude(int degrees, int minutes, double seconds) Sets the eastern longitude in degrees, arc minutes and arc seconds.
LunarTime.Builder	northernLatitude(int degrees, int minutes, double seconds) Sets the northern latitude in degrees, arc minutes and arc seconds.
LunarTime.Builder	southernLatitude(int degrees, int minutes, double seconds) Sets the southern latitude in degrees, arc minutes and arc seconds.
LunarTime.Builder	westernLongitude(int degrees, int minutes, double seconds) Sets the western longitude in degrees, arc minutes and arc seconds.

Methods inherited from class java.lang.Object

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

Method Detail

northernLatitude

public LunarTime.Builder northernLatitude(int degrees,
                                          int minutes,
                                          double seconds)

Sets the northern latitude in degrees, arc minutes and arc seconds.

Parameters:

degrees - degrees in range 0 <= x <= 90

minutes - arc minutes in range 0 <= x < 60

seconds - arc seconds in range 0.0 <= x < 60.0

Returns:

this instance for method chaining

Throws:

IllegalArgumentException - if any parameter is out of range

IllegalStateException - if the latitude has already been set

See Also:

southernLatitude(int, int, double)

southernLatitude

public LunarTime.Builder southernLatitude(int degrees,
                                          int minutes,
                                          double seconds)

Sets the southern latitude in degrees, arc minutes and arc seconds.

Parameters:

degrees - degrees in range 0 <= x <= 90

minutes - arc minutes in range 0 <= x < 60

seconds - arc seconds in range 0.0 <= x < 60.0

Returns:

this instance for method chaining

Throws:

IllegalArgumentException - if any parameter is out of range

IllegalStateException - if the latitude has already been set

See Also:

northernLatitude(int, int, double)

easternLongitude

public LunarTime.Builder easternLongitude(int degrees,
                                          int minutes,
                                          double seconds)

Sets the eastern longitude in degrees, arc minutes and arc seconds.

Parameters:

degrees - degrees in range 0 <= x < 180

minutes - arc minutes in range 0 <= x < 60

seconds - arc seconds in range 0.0 <= x < 60.0

Returns:

this instance for method chaining

Throws:

IllegalArgumentException - if any parameter is out of range

IllegalStateException - if the longitude has already been set

See Also:

westernLongitude(int, int, double)

westernLongitude

public LunarTime.Builder westernLongitude(int degrees,
                                          int minutes,
                                          double seconds)

Sets the western longitude in degrees, arc minutes and arc seconds.

Parameters:

degrees - degrees in range 0 <= x <= 180

minutes - arc minutes in range 0 <= x < 60

seconds - arc seconds in range 0.0 <= x < 60.0

Returns:

this instance for method chaining

Throws:

IllegalArgumentException - if any parameter is out of range

IllegalStateException - if the longitude has already been set

See Also:

easternLongitude(int, int, double)

atAltitude

public LunarTime.Builder atAltitude(int altitude)

Sets the altitude in meters.

The altitude is used to model a geodetic correction as well as a refraction correction based on the simple assumption of a standard atmosphere. Users should keep in mind that the local topology with mountains breaking the horizon line and special weather conditions cannot be taken into account. If this method is not called then a default altitude of zero is assumed.

Parameters:

altitude - geographical altitude relative to sea level in meters (0 <= x < 11,0000)

Returns:

this instance for method chaining

Throws:

IllegalArgumentException - if the argument is not finite or out of range

build

public LunarTime build()

Finishes the build-process.

Returns:

new configured instance of LunarTime

Throws:

IllegalStateException - if either latitude or longitude have not yet been set

IllegalArgumentException - if the observer timezone cannot be loaded