public class

DateLocaleConverter

extends BaseLocaleConverter
java.lang.Object
   ↳ org.apache.commons.beanutils.locale.BaseLocaleConverter
     ↳ org.apache.commons.beanutils.locale.converters.DateLocaleConverter
Known Direct Subclasses

Class Overview

Standard LocaleConverter implementation that converts an incoming locale-sensitive String into a java.util.Date object, optionally using a default value or throwing a ConversionException if a conversion error occurs.

Summary

[Expand]
Inherited Fields
From class org.apache.commons.beanutils.locale.BaseLocaleConverter
Public Constructors
DateLocaleConverter()
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale, boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale, String pattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale, String pattern, boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Object defaultValue)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale, String pattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale, String pattern, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
Public Methods
boolean isLenient()
Returns whether date formatting is lenient.
void setLenient(boolean lenient)
Specify whether or not date-time parsing should be lenient.
Protected Methods
Object parse(Object value, String pattern)
Convert the specified locale-sensitive input object into an output object of the specified type.
[Expand]
Inherited Methods
From class org.apache.commons.beanutils.locale.BaseLocaleConverter
From class java.lang.Object
From interface org.apache.commons.beanutils.Converter
From interface org.apache.commons.beanutils.locale.LocaleConverter

Public Constructors

public DateLocaleConverter ()

Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine and an unlocalized pattern is used for the convertion.

public DateLocaleConverter (boolean locPattern)

Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine.

Parameters
locPattern Indicate whether the pattern is localized or not

public DateLocaleConverter (Locale locale)

Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. An unlocalized pattern is used for the convertion.

Parameters
locale The locale

public DateLocaleConverter (Locale locale, boolean locPattern)

Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.

Parameters
locale The locale
locPattern Indicate whether the pattern is localized or not

public DateLocaleConverter (Locale locale, String pattern)

Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. An unlocalized pattern is used for the convertion.

Parameters
locale The locale
pattern The convertion pattern

public DateLocaleConverter (Locale locale, String pattern, boolean locPattern)

Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.

Parameters
locale The locale
pattern The convertion pattern
locPattern Indicate whether the pattern is localized or not

public DateLocaleConverter (Object defaultValue)

Create a LocaleConverter that will return the specified default value if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine and an unlocalized pattern is used for the convertion.

Parameters
defaultValue The default value to be returned

public DateLocaleConverter (Object defaultValue, boolean locPattern)

Create a LocaleConverter that will return the specified default value if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine.

Parameters
defaultValue The default value to be returned
locPattern Indicate whether the pattern is localized or not

public DateLocaleConverter (Object defaultValue, Locale locale)

Create a LocaleConverter that will return the specified default value if a conversion error occurs. An unlocalized pattern is used for the convertion.

Parameters
defaultValue The default value to be returned
locale The locale

public DateLocaleConverter (Object defaultValue, Locale locale, boolean locPattern)

Create a LocaleConverter that will return the specified default value if a conversion error occurs.

Parameters
defaultValue The default value to be returned
locale The locale
locPattern Indicate whether the pattern is localized or not

public DateLocaleConverter (Object defaultValue, Locale locale, String pattern)

Create a LocaleConverter that will return the specified default value if a conversion error occurs. An unlocalized pattern is used for the convertion.

Parameters
defaultValue The default value to be returned
locale The locale
pattern The convertion pattern

public DateLocaleConverter (Object defaultValue, Locale locale, String pattern, boolean locPattern)

Create a LocaleConverter that will return the specified default value if a conversion error occurs.

Parameters
defaultValue The default value to be returned
locale The locale
pattern The convertion pattern
locPattern Indicate whether the pattern is localized or not

Public Methods

public boolean isLenient ()

Returns whether date formatting is lenient.

Returns
  • true if the DateFormat used for formatting is lenient
See Also

public void setLenient (boolean lenient)

Specify whether or not date-time parsing should be lenient.

Parameters
lenient true if the DateFormat used for formatting should be lenient

Protected Methods

protected Object parse (Object value, String pattern)

Convert the specified locale-sensitive input object into an output object of the specified type.

Parameters
value The input object to be converted
pattern The pattern is used for the convertion
Returns
  • the converted Date value
Throws
ConversionException if conversion cannot be performed successfully
ParseException if an error occurs parsing