ucar.nc2.units
Class DateFormatter

java.lang.Object
  extended by 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
DateFormatter()
           
 
Method Summary
 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
equals, 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