thredds.datatype
Class TimeDuration

java.lang.Object
  thredds.datatype.TimeDuration

public class TimeDuration
extends java.lang.Object

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

Author:

john caron

See Also:

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

Constructor Summary

TimeDuration(java.lang.String text)
Construct from 1) udunit time unit string, 2) xsd:duration syntax, 3) blank string.

TimeDuration(TimeDuration src)
Copy constructor.

TimeDuration(TimeUnit timeUnit)
Construct from a TimeUnit.

Method Summary

boolean	equals(java.lang.Object o) TimeDurations with same value in seconds are equals
java.lang.String	getText() Get the String text
TimeUnit	getTimeUnit() Get the corresponding time unit
double	getValue()
double	getValue(TimeUnit want) Get the time duration in a specified unit of time.
double	getValueInSeconds() Get the duration in seconds
int	hashCode() Override to be consistent with equals
boolean	isBlank() If this is a blank string
static void	main(java.lang.String[] args) debug
static TimeDuration	parseW3CDuration(java.lang.String text) A time span as defined in the W3C XML Schema 1.0 specification: "PnYnMnDTnHnMnS, where nY represents the number of years, nM the number of months, nD the number of days, 'T' is the date/time separator, nH the number of hours, nM the number of minutes and nS the number of seconds.
void	setValueInSeconds(double secs) Set the duration in seconds
java.lang.String	toString() Nice String

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeDuration

public TimeDuration(TimeDuration src)

Copy constructor.

Parameters:

src - copy this

TimeDuration

public TimeDuration(TimeUnit timeUnit)

Construct from a TimeUnit.

Parameters:

timeUnit - copy this

TimeDuration

public TimeDuration(java.lang.String text)
             throws java.text.ParseException

Construct from 1) udunit time unit string, 2) xsd:duration syntax, 3) blank string.

Parameters:

text - parse this text.

Throws:

java.text.ParseException - if invalid text.

Method Detail

parseW3CDuration

public static TimeDuration parseW3CDuration(java.lang.String text)
                                     throws java.text.ParseException

A time span as defined in the W3C XML Schema 1.0 specification: "PnYnMnDTnHnMnS, where nY represents the number of years, nM the number of months, nD the number of days, 'T' is the date/time separator, nH the number of hours, nM the number of minutes and nS the number of seconds. The number of seconds can include decimal digits to arbitrary precision."

Parameters:

text - parse this text, format PnYnMnDTnHnMnS

Returns:

TimeDuration

Throws:

java.text.ParseException - when text is misformed

getValue

public double getValue()

Returns:

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

getValue

public double getValue(TimeUnit want)
                throws ConversionException

Get the time duration in a specified unit of time.

Parameters:

want - in these units

Returns:

the duration in units

Throws:

ConversionException - is specified unit is not compatible with time

getValueInSeconds

public double getValueInSeconds()

Get the duration in seconds

setValueInSeconds

public void setValueInSeconds(double secs)

Set the duration in seconds

isBlank

public boolean isBlank()

If this is a blank string

getTimeUnit

public TimeUnit getTimeUnit()

Get the corresponding time unit

getText

public java.lang.String getText()

Get the String text

toString

public java.lang.String toString()

Nice String

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Override to be consistent with equals

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

TimeDurations with same value in seconds are equals

Overrides:

equals in class java.lang.Object

main

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

debug