Package org.shredzone.commons.suncalc.util

Class BaseBuilder<T>

java.lang.Object

org.shredzone.commons.suncalc.util.BaseBuilder<T>

Type Parameters:

T - Type of the final builder

All Implemented Interfaces:

Cloneable, GenericParameter<T>, LocationParameter<T>, TimeParameter<T>

public class BaseBuilder<T>
extends Object
implements GenericParameter<T>, LocationParameter<T>, TimeParameter<T>, Cloneable

A base implementation of LocationParameter and TimeParameter.

For internal use only.

Constructor Summary

Constructors

Constructor	Description
BaseBuilder()

Method Summary

Modifier and Type	Method	Description
T	copy()	Creates a copy of the current parameters.
double	getHeight()	Returns the height, in meters above sea level.
JulianDate	getJulianDate()	Returns the JulianDate to be used.
double	getLatitude()	Returns the latitude.
double	getLatitudeRad()	Returns the latitude.
double	getLongitude()	Returns the longitude.
double	getLongitudeRad()	Returns the longitude.
T	height(double h)	Sets the height.
T	latitude(double lat)	Sets the latitude.
T	longitude(double lng)	Sets the longitude.
T	midnight()	Sets the time to the start of the current date ("last midnight").
T	now()	Sets the current date and time.
T	on(int year, int month, int date, int hour, int minute, int second)	Sets date and time.
T	on(Instant instant)	Uses the given Instant instance.
T	on(LocalDate date)	Uses the given LocalDate instance, and assumes midnight.
T	on(LocalDateTime dateTime)	Uses the given LocalDateTime instance.
T	on(ZonedDateTime dateTime)	Uses the given ZonedDateTime instance.
T	plusDays(int days)	Adds a number of days to the current date.
T	sameLocationAs(LocationParameter<?> l)	Uses the same location as given in the LocationParameter at this moment.
T	sameTimeAs(TimeParameter<?> t)	Uses the same time as given in the TimeParameter.
T	timezone(ZoneId tz)	Sets the given ZoneId.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.shredzone.commons.suncalc.param.LocationParameter

at, at, latitude, longitude

Methods inherited from interface org.shredzone.commons.suncalc.param.TimeParameter

localTime, on, on, on, timezone, timezone, today, tomorrow, utc

Constructor Details

BaseBuilder

public BaseBuilder()

Method Details

on

public T on(ZonedDateTime dateTime)

Description copied from interface: TimeParameter

Uses the given ZonedDateTime instance.

Specified by:

on in interface TimeParameter<T>

Parameters:

dateTime - ZonedDateTime to be used.

Returns:

itself

on

public T on(LocalDateTime dateTime)

Description copied from interface: TimeParameter

Uses the given LocalDateTime instance.

Specified by:

on in interface TimeParameter<T>

Parameters:

dateTime - LocalDateTime to be used.

Returns:

itself

on

public T on(LocalDate date)

Description copied from interface: TimeParameter

Uses the given LocalDate instance, and assumes midnight.

Specified by:

on in interface TimeParameter<T>

Parameters:

date - LocalDate to be used.

Returns:

itself

on

public T on(Instant instant)

Description copied from interface: TimeParameter

Uses the given Instant instance.

Specified by:

on in interface TimeParameter<T>

Parameters:

instant - Instant to be used.

Returns:

itself

on

public T on(int year,
 int month,
 int date,
 int hour,
 int minute,
 int second)

Description copied from interface: TimeParameter

Sets date and time. Note that also seconds can be passed in for convenience, but the results are not that accurate.

Specified by:

on in interface TimeParameter<T>

Parameters:

year - Year

month - Month (1 = January, 2 = February, ...)

date - Day of month

hour - Hour of day

minute - Minute

second - Second

Returns:

itself

now

public T now()

Description copied from interface: TimeParameter

Sets the current date and time. This is the default.

Specified by:

now in interface TimeParameter<T>

Returns:

itself

plusDays

public T plusDays(int days)

Description copied from interface: TimeParameter

Adds a number of days to the current date.

Specified by:

plusDays in interface TimeParameter<T>

Parameters:

days - Number of days to add

Returns:

itself

midnight

public T midnight()

Description copied from interface: TimeParameter

Sets the time to the start of the current date ("last midnight").

Specified by:

midnight in interface TimeParameter<T>

Returns:

itself

timezone

public T timezone(ZoneId tz)

Description copied from interface: TimeParameter

Sets the given ZoneId. The local time is retained, so the parameter order is not important.

Specified by:

timezone in interface TimeParameter<T>

Parameters:

tz - ZoneId to be used.

Returns:

itself

latitude

public T latitude(double lat)

Description copied from interface: LocationParameter

Sets the latitude.

Specified by:

latitude in interface LocationParameter<T>

Parameters:

lat - Latitude, in degrees.

Returns:

itself

longitude

public T longitude(double lng)

Description copied from interface: LocationParameter

Sets the longitude.

Specified by:

longitude in interface LocationParameter<T>

Parameters:

lng - Longitude, in degrees.

Returns:

itself

height

public T height(double h)

Description copied from interface: LocationParameter

Sets the height.

Specified by:

height in interface LocationParameter<T>

Parameters:

h - Height, in meters above sea level. Default: 0.0 m. Negative values are silently changed to the acceptable minimum of 0.0 m.

Returns:

itself

sameTimeAs

public T sameTimeAs(TimeParameter<?> t)

Description copied from interface: TimeParameter

Uses the same time as given in the TimeParameter.

Changes to the source parameter will not affect this parameter, though.

Specified by:

sameTimeAs in interface TimeParameter<T>

Parameters:

t - TimeParameter to be used.

Returns:

itself

sameLocationAs

public T sameLocationAs(LocationParameter<?> l)

Description copied from interface: LocationParameter

Uses the same location as given in the LocationParameter at this moment.

Changes to the source parameter will not affect this parameter, though.

Specified by:

sameLocationAs in interface LocationParameter<T>

Parameters:

l - LocationParameter to be used.

Returns:

itself

copy

public T copy()

Description copied from interface: GenericParameter

Creates a copy of the current parameters. The copy can be changed independently.

Specified by:

copy in interface GenericParameter<T>

getLongitude

public double getLongitude()

Returns the longitude.

Returns:

Longitude, in degrees.

getLatitude

public double getLatitude()

Returns the latitude.

Returns:

Latitude, in degrees.

getLongitudeRad

public double getLongitudeRad()

Returns the longitude.

Returns:

Longitude, in radians.

getLatitudeRad

public double getLatitudeRad()

Returns the latitude.

Returns:

Latitude, in radians.

getHeight

public double getHeight()

Returns the height, in meters above sea level.

Returns:

Height, meters above sea level

getJulianDate

public JulianDate getJulianDate()

Returns the JulianDate to be used.

Returns:

JulianDate