ucar.nc2.units

Class DateFormatter

java.lang.Object

ucar.nc2.units.DateFormatter

public class DateFormatter
extends java.lang.Object

Date parsing and formatting. Always uses GMT. These are not thread-safe.

Author:

caron

Constructor Summary

Constructors

Constructor and Description
DateFormatter()

Method Summary

Methods

Modifier and Type	Method and Description
java.util.Date	dateOnlyFormat(java.lang.String text) Parse text in the format "yyyy-MM-dd"
java.util.Date	getISODate(java.lang.String text) Parse the text in W3C profile of ISO 8601 format.
java.lang.String	getStandardDateOnlyString(java.util.Date date) Deprecated. use toDateOnlyString
java.lang.String	getStandardDateString(java.util.Date date) Deprecated. use toDateTimeStringISO
java.lang.String	getStandardDateString2(java.util.Date date) Deprecated. use toDateTimeString
java.util.Date	isoDateNoSecsFormat(java.lang.String text) Parse text in the format "yyyy-MM-dd'T'HH:mm"
java.util.Date	isoDateTimeFormat(java.lang.String text) Parse text in the format "yyyy-MM-dd'T'HH:mm:ss"
static void	main(java.lang.String[] args) test
java.util.Date	stdDateNoSecsFormat(java.lang.String text) Parse text in the format "yyyy-MM-dd HH:mm"
java.util.Date	stdDateTimeFormat(java.lang.String text) Parse text in the format "yyyy-MM-dd HH:mm:ss"
java.lang.String	toDateOnlyString(java.util.Date date) date only format= yyyy-MM-dd
java.lang.String	toDateString(java.util.Date date) Deprecated. use toDateOnlyString
java.lang.String	toDateTimeString(java.util.Date date) "standard date format" = yyyy-MM-dd HH:mm:ssZ
java.lang.String	toDateTimeStringISO(java.util.Date date) "ISO date format" = yyyy-MM-dd'T'HH:mm:ssZ

Methods inherited from class java.lang.Object

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

Constructor Detail

DateFormatter

public DateFormatter()

Method Detail

getISODate

public java.util.Date getISODate(java.lang.String text)

Parse the text in W3C profile of ISO 8601 format.

Parameters:

text - parse this text

Returns:

equivalent Date or null if failure

See Also:

W3C profile of ISO 8601

stdDateTimeFormat

public java.util.Date stdDateTimeFormat(java.lang.String text)
                                 throws java.text.ParseException

Parse text in the format "yyyy-MM-dd HH:mm:ss"

Parameters:

text - parse this text

Returns:

equivalent Date

Throws:

java.text.ParseException - if not formatted correctly

stdDateNoSecsFormat

public java.util.Date stdDateNoSecsFormat(java.lang.String text)
                                   throws java.text.ParseException

Parse text in the format "yyyy-MM-dd HH:mm"

Parameters:

text - parse this text

Returns:

equivalent Date

Throws:

java.text.ParseException - if not formatted correctly

isoDateTimeFormat

public java.util.Date isoDateTimeFormat(java.lang.String text)
                                 throws java.text.ParseException

Parse text in the format "yyyy-MM-dd'T'HH:mm:ss"

Parameters:

text - parse this text

Returns:

equivalent Date

Throws:

java.text.ParseException - if not formatted correctly

isoDateNoSecsFormat

public java.util.Date isoDateNoSecsFormat(java.lang.String text)
                                   throws java.text.ParseException

Parse text in the format "yyyy-MM-dd'T'HH:mm"

Parameters:

text - parse this text

Returns:

equivalent Date

Throws:

java.text.ParseException - if not formatted correctly

dateOnlyFormat

public java.util.Date dateOnlyFormat(java.lang.String text)
                              throws java.text.ParseException

Parse text in the format "yyyy-MM-dd"

Parameters:

text - parse this text

Returns:

equivalent Date

Throws:

java.text.ParseException - if not formatted correctly

getStandardDateOnlyString

public java.lang.String getStandardDateOnlyString(java.util.Date date)

Deprecated. use toDateOnlyString

Return standard GMT date format; show date only, not time. Format = "yyyy-MM-dd"

toDateString

public java.lang.String toDateString(java.util.Date date)

Deprecated. use toDateOnlyString

date only format= yyyy-MM-dd

toDateOnlyString

public java.lang.String toDateOnlyString(java.util.Date date)

date only format= yyyy-MM-dd

Parameters:

date - format this date

Returns:

date formatted as date only

getStandardDateString2

public java.lang.String getStandardDateString2(java.util.Date date)

Deprecated. use toDateTimeString

Return standard formatted GMT date and time String. Format = "yyyy-MM-dd HH:mm:ss'Z'"

toDateTimeString

public java.lang.String toDateTimeString(java.util.Date date)

"standard date format" = yyyy-MM-dd HH:mm:ssZ

Parameters:

date - format this date

Returns:

date formatted as date/time

getStandardDateString

public java.lang.String getStandardDateString(java.util.Date date)

Deprecated. use toDateTimeStringISO

Return standard formatted GMT date and time String. Format = "yyyy-MM-dd'T'HH:mm:ss'Z'"

toDateTimeStringISO

public java.lang.String toDateTimeStringISO(java.util.Date date)

"ISO date format" = yyyy-MM-dd'T'HH:mm:ssZ

Parameters:

date - format this date

Returns:

date formatted as ISO date string

main

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

test