org.das2.datum

Class MonthDatumRange

java.lang.Object

org.das2.datum.DatumRange

org.das2.datum.MonthDatumRange

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable

public class MonthDatumRange
extends DatumRange
implements java.io.Serializable

DatumRange implementation that preserves month and year boundaries in the next() and previous() implementations. For example,

   dr= MonthDatumRange( [ 1999, 01, 01, 00, 00, 00, 0 ], [ 1999, 02, 01, 00, 00, 00, 0 ] )
   dr.toString() → "Jan 1999"
   dr= dr.next()
   dr.toString() → "Feb 1999"  ; a normal datumRange would simply advance 31 days.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
MonthDatumRange(int[] start, int[] end) create the MonthDatumRange with the decomposed times.
MonthDatumRange(int[] start, int[] end, Units u) create the MonthDatumRange with the decomposed times.

Method Summary

Modifier and Type	Method and Description
DatumRange	convertTo(Units u) return this DatumRange in new units.
boolean	equals(java.lang.Object o) returns true if the two endpoints are equal.
int	hashCode()
DatumRange	next() returns the next DatumRange covering the space defined by Units.
DatumRange	previous() returns the previous DatumRange covering the space defined by Units.

Methods inherited from class org.das2.datum.DatumRange

compareTo, contains, contains, getUnits, include, intersection, intersects, max, middle, min, newDatumRange, newRange, newRange, newRange, rescale, toString, union, width, zoomOut

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MonthDatumRange

public MonthDatumRange(int[] start,
                       int[] end,
                       Units u)

create the MonthDatumRange with the decomposed times.

Parameters:

start - a seven element array of [ yr, mn, day, hr, mn, sec, nano ]

end - a seven element array of [ yr, mn, day, hr, mn, sec, nano ]

u - the units for storing the Datums.

MonthDatumRange

public MonthDatumRange(int[] start,
                       int[] end)

create the MonthDatumRange with the decomposed times.

Parameters:

start - a seven element array of [ yr, mn, day, hr, mn, sec, nano ]

end - a seven element array of [ yr, mn, day, hr, mn, sec, nano ]

Method Detail

next

public DatumRange next()

Description copied from class: DatumRange

returns the next DatumRange covering the space defined by Units. Typically, this will be a range with a min equal to this datum's max, and the same width. Some implementations of DatumRange may return a range with a different width than this DatumRange's width, for example, when advancing month-by-month with a MonthDatumRange. When there is no next interval, then this same range will be returned.

Overrides:

next in class DatumRange

Returns:

the next DatumRange covering the space defined by Units.

previous

public DatumRange previous()

Description copied from class: DatumRange

returns the previous DatumRange covering the space defined by Units. See next(). When there is no previous interval, then this same range will be returned.

Overrides:

previous in class DatumRange

Returns:

the previous DatumRange covering the space defined by Units

convertTo

public DatumRange convertTo(Units u)

Description copied from class: DatumRange

return this DatumRange in new units. Note this may cause some functions of a DatumRange to change, such as the next() for a MonthDatumRange, but implementations should attempt to preserve type.

Overrides:

convertTo in class DatumRange

Parameters:

u - the new units.

Returns:

the DatumRange in the new units.

equals

public boolean equals(java.lang.Object o)

Description copied from class: DatumRange

returns true if the two endpoints are equal.

Overrides:

equals in class DatumRange

hashCode

public int hashCode()

Overrides:

hashCode in class DatumRange