ucar.nc2.time

Class CalendarDuration

java.lang.Object

ucar.nc2.time.CalendarDuration

@Immutable
public class CalendarDuration
extends java.lang.Object

A replacement for ucar.nc2.units.TimeDuration. incomplete. A Duration is a fixed number of seconds. I think thats wrong: a CalendarDuration should be a integer and a CalendarPeriod. Optionally, a CalendarPeriod could have an integer value. Implements the thredds "duration" XML element type: specifies a length of time. This is really the same as a ucar.nc2.units.TimeUnit, but it allows xsd:duration syntax as well as udunits syntax. It also keeps track if the text is empty.

A duration can be one of the following:

1. a valid udunits string compatible with "secs"
2. an xsd:duration type specified in the following form "PnYnMnDTnHnMnS" where:
   • P indicates the period (required)
   • nY indicates the number of years
   • nM indicates the number of months
   • nD indicates the number of days
   • T indicates the start of a time section (required if you are going to specify hours, minutes, or seconds)
   • nH indicates the number of hours
   • nM indicates the number of minutes
   • nS indicates the number of seconds

change to JSR-310 javax.time.Duration when ready relation to javax.xml.datatype ?

See Also:

"https://www.unidata.ucar.edu/projects/THREDDS/tech/catalog/InvCatalogSpec.html#durationType"

Constructor Summary

Constructors

Constructor and Description
CalendarDuration(int value, CalendarPeriod.Field timeUnit)

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
static CalendarDuration	fromUnitString(java.lang.String unitString)
CalendarPeriod.Field	getTimeUnit()
double	getValue() Get the duration in natural units, ie units of getTimeUnit()
int	hashCode()
java.lang.String	toString() String representation

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CalendarDuration

public CalendarDuration(int value,
                        CalendarPeriod.Field timeUnit)

Method Detail

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

fromUnitString

public static CalendarDuration fromUnitString(java.lang.String unitString)

getTimeUnit

public CalendarPeriod.Field getTimeUnit()

getValue

public double getValue()

Get the duration in natural units, ie units of getTimeUnit()

Returns:

the duration in natural units

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

String representation

Overrides:

toString in class java.lang.Object

Returns:

getText()