org.apache.groovy.dateutil.extensions

## Class DateUtilStaticExtensions

- java.lang.Object
- - org.apache.groovy.dateutil.extensions.DateUtilStaticExtensions

-     public class DateUtilStaticExtensions
      extends Object

  This class defines new groovy static methods which appear on normal JDK Date and Calendar classes inside the Groovy environment.

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `DateUtilStaticExtensions()`

  - ### Method Summary

    All Methods Static Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `static Date` | `parse(Date self, String format, String input)` Parse a String into a Date instance using the given pattern.
    `static Date` | `parse(Date self, String format, String input, TimeZone zone)` Parse a String into a Date instance using the given pattern and TimeZone.
    `static Date` | `parseToStringDate(Date self, String dateToString)` Parse a String matching the pattern EEE MMM dd HH:mm:ss zzz yyyy containing US-locale-constants only (e.g.

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### DateUtilStaticExtensions

          public DateUtilStaticExtensions()

  - ### Method Detail

    - #### parse

          public static Date parse(Date self,
                                   String format,
                                   String input)
                            throws ParseException

      Parse a String into a Date instance using the given pattern. This convenience method acts as a wrapper for `SimpleDateFormat`.

      Note that a new SimpleDateFormat instance is created for every invocation of this method (for thread safety).

      Parameters:
        `self` - placeholder variable used by Groovy categories; ignored for default static methods
        `format` - pattern used to parse the input string.
        `input` - String to be parsed to create the date instance
      Returns:
        a new Date instance representing the parsed input string
      Throws:
        `ParseException` - if there is a parse error
      Since:
        1.5.7
      See Also:
        `DateFormat.parse(java.lang.String)`

    - #### parse

          public static Date parse(Date self,
                                   String format,
                                   String input,
                                   TimeZone zone)
                            throws ParseException

      Parse a String into a Date instance using the given pattern and TimeZone. This convenience method acts as a wrapper for `SimpleDateFormat`.

      Note that a new SimpleDateFormat instance is created for every invocation of this method (for thread safety).

      Parameters:
        `self` - placeholder variable used by Groovy categories; ignored for default static methods
        `format` - pattern used to parse the input string.
        `input` - String to be parsed to create the date instance
        `zone` - TimeZone to use when parsing
      Returns:
        a new Date instance representing the parsed input string
      Throws:
        `ParseException` - if there is a parse error
      Since:
        2.4.1
      See Also:
        `DateFormat.parse(java.lang.String)`

    - #### parseToStringDate

          public static Date parseToStringDate(Date self,
                                               String dateToString)
                                        throws ParseException

      Parse a String matching the pattern EEE MMM dd HH:mm:ss zzz yyyy containing US-locale-constants only (e.g. Sat for Saturdays). Such a string is generated by the toString method of `Date`

      Note that a new SimpleDateFormat instance is created for every invocation of this method (for thread safety).

      Parameters:
        `self` - placeholder variable used by Groovy categories; ignored for default static methods
        `dateToString` - String to be parsed to create the date instance. Must match the pattern EEE MMM dd HH:mm:ss zzz yyyy with US-locale symbols
      Returns:
        a new Date instance representing the parsed input string
      Throws:
        `ParseException` - if there is a parse error
      Since:
        1.8.4