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"

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(CalendarDate date) Constructor using a java.util.CalendarDate
DateType(DateType src) copy constructor
DateType(java.lang.String text, java.lang.String format, java.lang.String type) Constructor.
DateType(java.lang.String text, java.lang.String format, java.lang.String type, Calendar cal2) Constructor.

Method Summary

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)
CalendarDate	getCalendarDate() Get this as a CalendarDate
java.util.Date	getDate() Deprecated. use getCalendarDate()
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()
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
DateType	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 CalendarDateFormatter.toDateTimeStringISO
java.lang.String	toDateTimeStringISO() Get ISO formatted string
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(CalendarDate date)

Constructor using a java.util.CalendarDate

Parameters:

date - the given CalendarDate

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

DateType

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

Constructor.

Parameters:

text - string representation

format - using java.text.SimpleDateFormat, or null

type - type of date, or null

cal2 - ucar.nc2.time.Calendar of date, or null

Throws:

java.text.ParseException - if error parsing text

Method Detail

getDate

public java.util.Date getDate()

Deprecated. use getCalendarDate()

Get this as a Date. Does not handle non-standard Calendars.

Returns:

Date

getCalendarDate

public CalendarDate getCalendarDate()

Get this as a CalendarDate

Returns:

CalendarDate

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 DateType 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 CalendarDateFormatter.toDateTimeStringISO

Returns:

formatted date

toDateTimeStringISO

public java.lang.String toDateTimeStringISO()

Get ISO formatted string

Returns:

ISO 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