Package 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
    Description
    DateFromString()
     

  • Method Summary

    Modifier and Type
    Method
    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 Details

    • DateFromString

      public DateFromString()

  • Method Details

    • 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.

    • 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.

    • 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.

    • 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