ucar.nc2.units

Class DateType

java.lang.Object

ucar.nc2.units.DateType

public class DateType
extends java.lang.Object

Implements the thredds "dateType" and "dateTypeFormatted" XML element types. This is mostly a general way to specify dates in a string. It allows a date to mean "present". "Present" always sorts after any date, including dates in the future. It allows an optional attribute called "type" which is an enumeration like "created", "modified", etc taken from Dublin Core vocabulary.

A DateType can be specified in the following ways:

1. an xsd:date, with form "CCYY-MM-DD"
2. an xsd:dateTime with form "CCYY-MM-DDThh:mm:ss"
3. a valid udunits date string
4. the string "present"

Author:

john caron

See Also:

THREDDS dateType

Constructor Summary

Constructors

Constructor and Description
DateType() no argument constructor for beans
DateType(boolean isPresent, java.util.Date date) Constructor using a java.util.Date
DateType(DateType src) copy constructor
DateType(java.lang.String text, java.lang.String format, java.lang.String type) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
DateType	add(TimeDuration d)
DateType	add(TimeUnit d)
boolean	after(java.util.Date d) Is this date after the given date.
boolean	before(java.util.Date d) Is this date before the given date.
boolean	before(DateType d) Is this date before the given date.
boolean	equals(java.lang.Object o)
java.util.Date	getDate() Get this as a Date
java.lang.String	getFormat() Get the SimpleDateFormat format for parsing the text.
java.lang.String	getText() Get a text representation.
java.lang.String	getType() Get the type of Date.
int	hashCode()
static java.lang.String	hiddenProperties() For bean editing, public by accident.
boolean	isBlank() Was blank text passed to the constructor.
boolean	isPresent() Does this represent the present time.
static void	main(java.lang.String[] args) test
void	setDate(java.util.Date date) Set the Date.
void	setType(java.lang.String type) Set the type of Date.
DateType	subtract(TimeDuration d)
DateType	subtract(TimeUnit d)
java.lang.String	toDateString() Same as DateFormatter.toDateOnlyString()
java.lang.String	toDateTimeString() Same as DateFormatter.toDateTimeString()
java.lang.String	toDateTimeStringISO() Same as DateFormatter.toDateTimeStringISO()
java.lang.String	toString() String representation

Methods inherited from class java.lang.Object

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

Constructor Detail

DateType

public DateType(boolean isPresent,
        java.util.Date date)

Constructor using a java.util.Date

Parameters:

isPresent - if true, this represents the "present time"

date - the given date

DateType

public DateType()

no argument constructor for beans

DateType

public DateType(DateType src)

copy constructor

Parameters:

src - copy from here

DateType

public DateType(java.lang.String text,
        java.lang.String format,
        java.lang.String type)
         throws java.text.ParseException

Constructor.

Parameters:

text - string representation

format - using java.text.SimpleDateFormat, or null

type - type of date, or null

Throws:

java.text.ParseException - if error parsing text

Method Detail

hiddenProperties

public static java.lang.String hiddenProperties()

For bean editing, public by accident.

getDate

public java.util.Date getDate()

Get this as a Date

Returns:

Date

setDate

public void setDate(java.util.Date date)

Set the Date. isPresent is set to false.

Parameters:

date - set to this Date

isPresent

public boolean isPresent()

Does this represent the present time.

Returns:

true if present time.

isBlank

public boolean isBlank()

Was blank text passed to the constructor.

Returns:

true if blank text passed to the constructor.

getText

public java.lang.String getText()

Get a text representation.

Returns:

text representation

getFormat

public java.lang.String getFormat()

Get the SimpleDateFormat format for parsing the text.

Returns:

SimpleDateFormat format, or null

getType

public java.lang.String getType()

Get the type of Date.

Returns:

type of Date, or null

setType

public void setType(java.lang.String type)

Set the type of Date.

Parameters:

type - type of Date

before

public boolean before(java.util.Date d)

Is this date before the given date. if isPresent, always false.

Parameters:

d - test against this date

Returns:

true if this date before the given date

before

public boolean before(DateType d)

Is this date before the given date. if d.isPresent, always true, else if this.isPresent, false.

Parameters:

d - test against this date

Returns:

true if this date before the given date

after

public boolean after(java.util.Date d)

Is this date after the given date. if isPresent, always true.

Parameters:

d - test against this date

Returns:

true if this date after the given date

toDateString

public java.lang.String toDateString()

Same as DateFormatter.toDateOnlyString()

Returns:

formatted date

toDateTimeString

public java.lang.String toDateTimeString()

Same as DateFormatter.toDateTimeString()

Returns:

formatted date

toDateTimeStringISO

public java.lang.String toDateTimeStringISO()

Same as DateFormatter.toDateTimeStringISO()

Returns:

formatted date

toString

public java.lang.String toString()

String representation

Overrides:

toString in class java.lang.Object

Returns:

getText()

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

add

public DateType add(TimeDuration d)

add

public DateType add(TimeUnit d)

subtract

public DateType subtract(TimeDuration d)

subtract

public DateType subtract(TimeUnit d)

main

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

test