ucar.nc2.units

Class DateUnit

java.lang.Object

ucar.nc2.units.DateUnit

public class DateUnit
extends java.lang.Object

Handles udunits dates, represented as "n units of time since reference date" eg "1203 days since 1970-01-01 00:00:00".

This is a wrapper around ucar.units package. It tracks the value, the base time unit, and the date origin seperately.

Constructor Summary

Constructors

Constructor and Description
DateUnit(double value, java.lang.String timeUnitString, java.util.Date since) Constructor that takes a value, timeUnitString, and a Date since
DateUnit(java.lang.String text) Constructor.

Method Summary

Modifier and Type	Method and Description
static DateUnit	factory(java.lang.String text)
java.util.Date	getDate() Get the equivalent java.util.Date.
java.util.Date	getDateOrigin() Get the origin Date.
static java.util.Date	getStandardDate(java.lang.String text) Create a java.util.Date from this udunits String.
static java.util.Date	getStandardOrISO(java.lang.String text) Create a java.util.Date from a udunit or ISO String.
TimeUnit	getTimeUnit() For udunit dates, get the time unit.
java.lang.String	getTimeUnitString() For udunit dates, get the time unit only, as a String, eg "secs" or "days"
java.lang.String	getUnitsString() The udunits string, but no value, ie its a base unit.
static DateUnit	getUnixDateUnit()
static void	main(java.lang.String[] args)
CalendarDate	makeCalendarDate(double val) Get the equivalent CalendarDate.
java.util.Date	makeDate(double val) Create a Date from this base unit and the given value.
java.lang.String	makeStandardDateString(double value) Make a standard GMT string representation from this unit and given value.
double	makeValue(java.util.Date date) Create the equivalent value from this base unit and the given Date.
static CalendarDate	parseCalendarDate(java.lang.String text)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

DateUnit

public DateUnit(java.lang.String text)
         throws java.lang.Exception

Constructor.

Parameters:

text - udunits String, eg 3 secs since 1991-01-01T03:12

Throws:

java.lang.Exception - if malformed String.

DateUnit

public DateUnit(double value,
                java.lang.String timeUnitString,
                java.util.Date since)
         throws java.lang.Exception

Constructor that takes a value, timeUnitString, and a Date since

Parameters:

value - number of time units

timeUnitString - eg "secs"

since - date since, eg "secs since 1970-01-01T00:00:00Z"

Throws:

java.lang.Exception - if not valid time unit.

Method Detail

getStandardDate

public static java.util.Date getStandardDate(java.lang.String text)

Create a java.util.Date from this udunits String.

Parameters:

text - a udunit string.

[number] (units) since [-]Y[Y[Y[Y]]]-MM-DD[(T| )hh[:mm[:ss[.sss*]]][ [+|-]hh[[:]mm]]]

Returns:

Date or null if not date unit.

getStandardOrISO

public static java.util.Date getStandardOrISO(java.lang.String text)

Create a java.util.Date from a udunit or ISO String.

Parameters:

text - a udunit or ISO string.

Returns:

Date or null if not date unit.

See Also:

getStandardDate(java.lang.String), DateFormatter.getISODate(java.lang.String)

parseCalendarDate

public static CalendarDate parseCalendarDate(java.lang.String text)

getUnixDateUnit

public static DateUnit getUnixDateUnit()

factory

public static DateUnit factory(java.lang.String text)

getDateOrigin

public java.util.Date getDateOrigin()

Get the origin Date.

Returns:

Date or null if not a time unit.

getTimeUnitString

public java.lang.String getTimeUnitString()

For udunit dates, get the time unit only, as a String, eg "secs" or "days"

Returns:

time unit as a string

getTimeUnit

public TimeUnit getTimeUnit()

For udunit dates, get the time unit.

Returns:

time unit

getDate

public java.util.Date getDate()

Get the equivalent java.util.Date.

Returns:

Date or null if failure

makeCalendarDate

public CalendarDate makeCalendarDate(double val)

Get the equivalent CalendarDate.

Returns:

CalendarDate or null if failure

makeDate

public java.util.Date makeDate(double val)

Create a Date from this base unit and the given value.

Parameters:

val - value in the units of this base unit, eg sec since base date

Returns:

Date .

makeValue

public double makeValue(java.util.Date date)

Create the equivalent value from this base unit and the given Date. Inverse of makeDate.

Parameters:

date - to convert.

Returns:

value in units of this base unit.

makeStandardDateString

public java.lang.String makeStandardDateString(double value)

Make a standard GMT string representation from this unit and given value.

Parameters:

value - of time in these units.

Returns:

String or null if not time unit.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getUnitsString

public java.lang.String getUnitsString()

The udunits string, but no value, ie its a base unit.

Returns:

the udunits base string

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception