ucar.nc2.time

Class CalendarDateFormatter

java.lang.Object

ucar.nc2.time.CalendarDateFormatter

@ThreadSafe
public class CalendarDateFormatter
extends Object

Threadsafe static routines for date formatting. Replacement for ucar.nc2.units.DateFormatter

Since:

7/9/11

Author:

John

Field Summary

Fields

Modifier and Type	Field and Description
static String	isodatePatternString

Constructor Summary

Constructors

Constructor and Description
CalendarDateFormatter()

Method Summary

Methods

Modifier and Type	Method and Description
static CalendarDate	isoStringToCalendarDate(Calendar calt, String iso) Convert an ISO formatted String to a CalendarDate.
static Date	isoStringToDate(String iso)
static void	main(String[] arg)
static Date	parseISODate(String iso) Deprecated. As of 4.3.10 use isoStringToDate(String) instead
static String	toDateString(CalendarDate cd)
static String	toDateStringPresent()
static String	toDateTimeString(CalendarDate cd)
static String	toDateTimeString(Date date)
static String	toDateTimeStringISO(CalendarDate cd)
static String	toDateTimeStringISO(Date d)
static String	toDateTimeStringPresent()

Methods inherited from class java.lang.Object

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

Field Detail

isodatePatternString

public static final String isodatePatternString

See Also:

Constant Field Values

Constructor Detail

CalendarDateFormatter

public CalendarDateFormatter()

Method Detail

toDateTimeStringISO

public static String toDateTimeStringISO(CalendarDate cd)

toDateTimeStringISO

public static String toDateTimeStringISO(Date d)

toDateTimeString

public static String toDateTimeString(CalendarDate cd)

toDateTimeStringPresent

public static String toDateTimeStringPresent()

toDateString

public static String toDateString(CalendarDate cd)

toDateStringPresent

public static String toDateStringPresent()

toDateTimeString

public static String toDateTimeString(Date date)

parseISODate

@Deprecated
public static Date parseISODate(String iso)

Deprecated. As of 4.3.10 use isoStringToDate(String) instead

Old version using DateFormatter

Parameters:

iso - ISO 8601 date String

Returns:

equivilent Date

isoStringToCalendarDate

public static CalendarDate isoStringToCalendarDate(Calendar calt,
                                   String iso)
                                            throws IllegalArgumentException

Convert an ISO formatted String to a CalendarDate.

Parameters:

calt - calendar, may be null for default calendar (Calendar.getDefault())

iso - ISO 8601 date String

possible forms for W3C profile of ISO 8601
        Year:
         YYYY (eg 1997)
      Year and month:
         YYYY-MM (eg 1997-07)
      Complete date:
         YYYY-MM-DD (eg 1997-07-16)
      Complete date plus hours and minutes:
         YYYY-MM-DDThh:mmTZD (eg 1997-07-16T19:20+01:00)
      Complete date plus hours, minutes and seconds:
         YYYY-MM-DDThh:mm:ssTZD (eg 1997-07-16T19:20:30+01:00)
      Complete date plus hours, minutes, seconds and a decimal fraction of a second
         YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45+01:00)

   where:
        YYYY = four-digit year
        MM   = two-digit month (01=January, etc.)
        DD   = two-digit day of month (01 through 31)
        hh   = two digits of hour (00 through 23) (am/pm NOT allowed)
        mm   = two digits of minute (00 through 59)
        ss   = two digits of second (00 through 59)
        s    = one or more digits representing a decimal fraction of a second
        TZD  = time zone designator (Z or +hh:mm or -hh:mm)
   except:
       You may use a space instead of the 'T'
       The year may be preceeded by a '+' (ignored) or a '-' (makes the date BCE)
       The date part uses a '-' delimiter instead of a fixed number of digits for each field
       The time part uses a ':' delimiter instead of a fixed number of digits for each field
   

Returns:

CalendarDate using default calendar

Throws:

IllegalArgumentException - if the String is not a valid ISO 8601 date

See Also:

"http://www.w3.org/TR/NOTE-datetime"

isoStringToDate

public static Date isoStringToDate(String iso)
                            throws IllegalArgumentException

Throws:

IllegalArgumentException

main

public static void main(String[] arg)