## com.google.gwt.user.datepicker.client
Class DateBox.DefaultFormat

    java.lang.Object
      com.google.gwt.user.datepicker.client.DateBox.DefaultFormat

All Implemented Interfaces:
  DateBox.Format

Enclosing class:
  DateBox

    public static class DateBox.DefaultFormat

extends java.lang.Object
implements DateBox.Format

Default `DateBox.Format` class. The date is first parsed using the `DateTimeFormat` supplied by the user, or `DateTimeFormat.getMediumDateFormat()` by default.

If that fails, we then try to parse again using the default browser date parsing.

If that fails, the `dateBoxFormatError` css style is applied to the `DateBox`. The style will be removed when either a successful `parse(DateBox,String, boolean)` is called or `format(DateBox,Date)` is called.

Use a different `DateBox.Format` instance to change that behavior.

Constructor Summary
`DateBox.DefaultFormat()` Creates a new default format instance.
`DateBox.DefaultFormat(DateTimeFormat dateTimeFormat)` Creates a new default format instance.

Method Summary
`java.lang.String` | `format(DateBox box, java.util.Date date)` Formats the provided date.
`DateTimeFormat` | `getDateTimeFormat()` Gets the date time format.
`java.util.Date` | `parse(DateBox dateBox, java.lang.String dateText, boolean reportError)` Parses the provided string as a date.
`void` | `reset(DateBox dateBox, boolean abandon)` If the format did any modifications to the date box's styling, reset them now.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### DateBox.DefaultFormat

    public DateBox.DefaultFormat()

  Creates a new default format instance.

### DateBox.DefaultFormat

    public DateBox.DefaultFormat(DateTimeFormat dateTimeFormat)

  Creates a new default format instance.

  Parameters:
    `dateTimeFormat` - the `DateTimeFormat` to use with this `DateBox.DefaultFormat`.

Method Detail

### format

    public java.lang.String format(DateBox box,
                                   java.util.Date date)

  Description copied from interface: `DateBox.Format`
  Formats the provided date. Note, a null date is a possible input.

  Specified by:
    `format` in interface `DateBox.Format`
  Parameters:
    `box` - the date box you are formatting
    `date` - the date to format
  Returns:
    the formatted date as a string

### getDateTimeFormat

    public DateTimeFormat getDateTimeFormat()

  Gets the date time format.

  Returns:
    the date time format

### parse

    public java.util.Date parse(DateBox dateBox,
                                java.lang.String dateText,
                                boolean reportError)

  Description copied from interface: `DateBox.Format`
  Parses the provided string as a date.

  Specified by:
    `parse` in interface `DateBox.Format`
  Parameters:
    `dateBox` - the date box
    `dateText` - the string representing a date
    `reportError` - should the formatter indicate a parse error to the user?
  Returns:
    the date created, or null if there was a parse error

### reset

    public void reset(DateBox dateBox,
                      boolean abandon)

  Description copied from interface: `DateBox.Format`
  If the format did any modifications to the date box's styling, reset them now.

  Specified by:
    `reset` in interface `DateBox.Format`
  Parameters:
    `dateBox` - the date box
    `abandon` - true when the current format is being replaced by another