Class DateLocaleConverter
java.lang.Object
org.apache.commons.beanutils.locale.BaseLocaleConverter
org.apache.commons.beanutils.locale.converters.DateLocaleConverter
- All Implemented Interfaces:
Converter
,LocaleConverter
- Direct Known Subclasses:
SqlDateLocaleConverter
,SqlTimeLocaleConverter
,SqlTimestampLocaleConverter
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.
- Version:
- $Id$
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final String
Default Pattern Characters(package private) boolean
Should the date conversion be lenient?private final org.apache.commons.logging.Log
All logging goes through this loggerFields inherited from class org.apache.commons.beanutils.locale.BaseLocaleConverter
locale, locPattern, pattern, useDefault
-
Constructor Summary
ConstructorsConstructorDescriptionCreate aLocaleConverter
that will throw aConversionException
if a conversion error occurs.DateLocaleConverter
(boolean locPattern) Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.DateLocaleConverter
(Object defaultValue) Create aLocaleConverter
that will return the specified default value if a conversion error occurs.DateLocaleConverter
(Object defaultValue, boolean locPattern) Create aLocaleConverter
that will return the specified default value if a conversion error occurs.DateLocaleConverter
(Object defaultValue, Locale locale) Create aLocaleConverter
that will return the specified default value if a conversion error occurs.DateLocaleConverter
(Object defaultValue, Locale locale, boolean locPattern) Create aLocaleConverter
that will return the specified default value if a conversion error occurs.DateLocaleConverter
(Object defaultValue, Locale locale, String pattern) Create aLocaleConverter
that will return the specified default value if a conversion error occurs.DateLocaleConverter
(Object defaultValue, Locale locale, String pattern, boolean locPattern) Create aLocaleConverter
that will return the specified default value if a conversion error occurs.DateLocaleConverter
(Locale locale) Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.DateLocaleConverter
(Locale locale, boolean locPattern) Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.DateLocaleConverter
(Locale locale, String pattern) Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.DateLocaleConverter
(Locale locale, String pattern, boolean locPattern) Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs. -
Method Summary
Modifier and TypeMethodDescriptionprivate String
convertLocalizedPattern
(String localizedPattern, Locale locale) Convert a pattern from a localized format to the default format.private String
convertPattern
(String pattern, String fromChars, String toChars) Converts a Pattern from one character set to another.private static String
This method is called at class initialization time to define the value for constant member DEFAULT_PATTERN_CHARS.boolean
Returns whether date formatting is lenient.protected Object
Convert the specified locale-sensitive input object into an output object of the specified type.void
setLenient
(boolean lenient) Specify whether or not date-time parsing should be lenient.Methods inherited from class org.apache.commons.beanutils.locale.BaseLocaleConverter
convert, convert, convert, convert
-
Field Details
-
log
private final org.apache.commons.logging.Log logAll logging goes through this logger -
isLenient
boolean isLenientShould the date conversion be lenient? -
DEFAULT_PATTERN_CHARS
Default Pattern Characters
-
-
Constructor Details
-
DateLocaleConverter
public DateLocaleConverter()Create aLocaleConverter
that will throw aConversionException
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. -
DateLocaleConverter
public DateLocaleConverter(boolean locPattern) Create aLocaleConverter
that will throw aConversionException
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
-
DateLocaleConverter
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs. An unlocalized pattern is used for the convertion.- Parameters:
locale
- The locale
-
DateLocaleConverter
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.- Parameters:
locale
- The localelocPattern
- Indicate whether the pattern is localized or not
-
DateLocaleConverter
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs. An unlocalized pattern is used for the convertion.- Parameters:
locale
- The localepattern
- The convertion pattern
-
DateLocaleConverter
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.- Parameters:
locale
- The localepattern
- The convertion patternlocPattern
- Indicate whether the pattern is localized or not
-
DateLocaleConverter
Create aLocaleConverter
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
-
DateLocaleConverter
Create aLocaleConverter
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 returnedlocPattern
- Indicate whether the pattern is localized or not
-
DateLocaleConverter
Create aLocaleConverter
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 returnedlocale
- The locale
-
DateLocaleConverter
Create aLocaleConverter
that will return the specified default value if a conversion error occurs.- Parameters:
defaultValue
- The default value to be returnedlocale
- The localelocPattern
- Indicate whether the pattern is localized or not
-
DateLocaleConverter
Create aLocaleConverter
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 returnedlocale
- The localepattern
- The convertion pattern
-
DateLocaleConverter
Create aLocaleConverter
that will return the specified default value if a conversion error occurs.- Parameters:
defaultValue
- The default value to be returnedlocale
- The localepattern
- The convertion patternlocPattern
- Indicate whether the pattern is localized or not
-
-
Method Details
-
isLenient
public boolean isLenient()Returns whether date formatting is lenient.- Returns:
- true if the
DateFormat
used for formatting is lenient - See Also:
-
setLenient
public void setLenient(boolean lenient) Specify whether or not date-time parsing should be lenient.- Parameters:
lenient
- true if theDateFormat
used for formatting should be lenient- See Also:
-
parse
Convert the specified locale-sensitive input object into an output object of the specified type.- Specified by:
parse
in classBaseLocaleConverter
- Parameters:
value
- The input object to be convertedpattern
- The pattern is used for the convertion- Returns:
- the converted Date value
- Throws:
ConversionException
- if conversion cannot be performed successfullyParseException
- if an error occurs parsing
-
convertLocalizedPattern
Convert a pattern from a localized format to the default format.- Parameters:
localizedPattern
- The pattern in 'local' symbol formatlocale
- The locale- Returns:
- pattern in 'default' symbol format
-
convertPattern
Converts a Pattern from one character set to another.
-
initDefaultChars
This method is called at class initialization time to define the value for constant member DEFAULT_PATTERN_CHARS. All other methods needing this data should just read that constant.
-