ucar.nc2.units

Class DateFromString

java.lang.Object

ucar.nc2.units.DateFromString

public class DateFromString
extends Object

Convenience routines for parsing a String to produce a Date.

Since:

Nov 29, 2005 4:53:46 PM

Constructor Summary

Constructors

Constructor and Description
DateFromString()

Method Summary

Modifier and Type	Method and Description
static Date	getDateUsingCompleteDateFormat(String dateString, String dateFormatString) Parse the given date string using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.
static Date	getDateUsingCompleteDateFormatWithOffset(String dateString, String dateFormatString, int startIndex) Parse the given date string (starting at the given startIndex) using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.
static Date	getDateUsingDemarkatedCount(String dateString, String dateFormatString, char demark) Parse the given date string, starting at a position given by the offset of the demark character in the dateFormatString.
static Date	getDateUsingDemarkatedMatch(String dateString, String dateFormatString, char demark) Parse the given date string (between the demarcation characters) using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.
static Date	getDateUsingRegExp(String dateString, String matchPattern, String substitutionPattern) Use regular expression capture group replacement to construct a date string and return the Date that is obtained by parseing the constructed date string using the date format string "yyyy-MM-dd'T'HH:mm".
static Date	getDateUsingRegExpAndDateFormat(String dateString, String matchPattern, String substitutionPattern, String dateFormatString) The same as getDateUsingRegExp() except the date format string to be used must be specified.
static Date	getDateUsingSimpleDateFormat(String dateString, String dateFormatString) Parse the given date string (starting at the first numeric character) using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.

Methods inherited from class java.lang.Object

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

Constructor Detail

DateFromString

public DateFromString()

Method Detail

getDateUsingCompleteDateFormat

public static Date getDateUsingCompleteDateFormat(String dateString,
                                                  String dateFormatString)

Parse the given date string using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.

Parameters:

dateString - the String to be parsed

dateFormatString - the date format String

Returns:

the Date that was parsed.

getDateUsingCompleteDateFormatWithOffset

public static Date getDateUsingCompleteDateFormatWithOffset(String dateString,
                                                            String dateFormatString,
                                                            int startIndex)

Parse the given date string (starting at the given startIndex) using the given date format string (as described in java.text.SimpleDateFormat) and return a Date. Assumes TimeZone is GMT.

Parameters:

dateString - the String to be parsed

dateFormatString - the date format String

startIndex - the index at which to start parsing the date string

Returns:

the Date that was parsed.

getDateUsingDemarkatedCount

public static Date getDateUsingDemarkatedCount(String dateString,
                                               String dateFormatString,
                                               char demark)

Parse the given date string, starting at a position given by the offset of the demark character in the dateFormatString. The rest of the dateFormatString is the date format string (as described in java.text.SimpleDateFormat).

  Example:
   dateString =        wrfout_d01_2006-07-06_080000.nc
   dateFormatString = wrfout_d01_#yyyy-MM-dd_HHmm
 

This simply counts over "wrfout_d01_" number of chars in dateString, then applies the remaining dateFormatString.

Parameters:

dateString - the String to be parsed

dateFormatString - the date format String

demark - the demarkation character

Returns:

the Date that was parsed.

getDateUsingDemarkatedMatch

public static Date getDateUsingDemarkatedMatch(String dateString,
                                               String dateFormatString,
                                               char demark)

Parse the given date string (between the demarcation characters) using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.

 Example:
  dateString =  /data/anything/2006070611/wrfout_d01_2006-07-06_080000.nc
  dateFormatString =                    #wrfout_d01_#yyyy-MM-dd_HHmm
  would extract the date 2006-07-06T08:00

  dateString =  /data/anything/2006070611/wrfout_d01_2006-07-06_080000.nc
  dateFormatString =          yyyyMMddHH#/wrfout_d01_#
  would extract the date 2006-07-06T11:00
 

Parameters:

dateString - the String to be parsed

dateFormatString - the date format String

demark - the demarkation character

Returns:

the Date that was parsed.

getDateUsingRegExp

public static Date getDateUsingRegExp(String dateString,
                                      String matchPattern,
                                      String substitutionPattern)

Use regular expression capture group replacement to construct a date string and return the Date that is obtained by parseing the constructed date string using the date format string "yyyy-MM-dd'T'HH:mm". The date string is constructed by matching the given dateString against the given regular expression matchPattern and then using the capture groups from the match to replace the capture group references, i.e., "$n", where n is an integer.

Parameters:

dateString - the String to be parsed

matchPattern - the regular expression String on which to match.

substitutionPattern - the String to use in the capture group replacement.

Returns:

the calculated Date

getDateUsingRegExpAndDateFormat

public static Date getDateUsingRegExpAndDateFormat(String dateString,
                                                   String matchPattern,
                                                   String substitutionPattern,
                                                   String dateFormatString)

The same as getDateUsingRegExp() except the date format string to be used must be specified.

Parameters:

dateString - the String to be parsed

matchPattern - the regular expression String on which to match.

substitutionPattern - the String to use in the capture group replacement.

dateFormatString - the date format string to use in the parsing of the date string.

Returns:

the calculated Date

getDateUsingSimpleDateFormat

public static Date getDateUsingSimpleDateFormat(String dateString,
                                                String dateFormatString)

Parse the given date string (starting at the first numeric character) using the given date format string (as described in java.text.SimpleDateFormat) and return a Date.

Parameters:

dateString - the String to be parsed

dateFormatString - the date format String

Returns:

the Date that was parsed.