public abstract class AbstractCalendarValidator extends AbstractFormatValidator
Abstract class for Date/Time/Calendar validation.
This is a base class for building Date / Time Validators using format parsing.
Constructor and Description |
---|
AbstractCalendarValidator(boolean strict,
int dateStyle,
int timeStyle)
Construct an instance with the specified strict,
time and date style parameters.
|
Modifier and Type | Method and Description |
---|---|
protected int |
compare(Calendar value,
Calendar compare,
int field)
Compares a calendar value to another, indicating whether it is
equal, less then or more than at a specified level.
|
protected int |
compareQuarters(Calendar value,
Calendar compare,
int monthOfFirstQuarter)
Compares a calendar's quarter value to another, indicating whether it is
equal, less then or more than the specified quarter.
|
protected int |
compareTime(Calendar value,
Calendar compare,
int field)
Compares a calendar time value to another, indicating whether it is
equal, less then or more than at a specified level.
|
protected String |
format(Object value,
Format formatter)
Format a value with the specified
DateFormat . |
String |
format(Object value,
Locale locale,
TimeZone timeZone)
Format an object into a
String using
the specified Locale. |
String |
format(Object value,
String pattern,
Locale locale)
Format an object using the specified pattern and/or
Locale . |
String |
format(Object value,
String pattern,
Locale locale,
TimeZone timeZone)
Format an object using the specified pattern and/or
Locale . |
String |
format(Object value,
String pattern,
TimeZone timeZone)
Format an object into a
String using
the specified pattern. |
String |
format(Object value,
TimeZone timeZone)
Format an object into a
String using
the default Locale. |
protected Format |
getFormat(Locale locale)
Returns a
DateFormat for the specified Locale. |
protected Format |
getFormat(String pattern,
Locale locale)
Returns a
DateFormat for the specified pattern
and/or Locale . |
boolean |
isValid(String value,
String pattern,
Locale locale)
Validate using the specified
Locale . |
protected Object |
parse(String value,
String pattern,
Locale locale,
TimeZone timeZone)
Checks if the value is valid against a specified pattern.
|
protected abstract Object |
processParsedValue(Object value,
Format formatter)
Process the parsed value, performing any further validation
and type conversion required.
|
public AbstractCalendarValidator(boolean strict, int dateStyle, int timeStyle)
strict
- true
if strict
Format
parsing should be used.dateStyle
- the date style to use for Locale validation.timeStyle
- the time style to use for Locale validation.public boolean isValid(String value, String pattern, Locale locale)
Validate using the specified Locale
.
isValid
in class AbstractFormatValidator
value
- The value validation is being performed on.pattern
- The pattern used to format the value.locale
- The locale to use for the Format, defaults to the defaulttrue
if the value is valid.public String format(Object value, TimeZone timeZone)
Format an object into a String
using
the default Locale.
value
- The value validation is being performed on.timeZone
- The Time Zone used to format the date,
system default if null (unless value is a Calendar
.String
.public String format(Object value, String pattern, TimeZone timeZone)
Format an object into a String
using
the specified pattern.
value
- The value validation is being performed on.pattern
- The pattern used to format the value.timeZone
- The Time Zone used to format the date,
system default if null (unless value is a Calendar
.String
.public String format(Object value, Locale locale, TimeZone timeZone)
Format an object into a String
using
the specified Locale.
value
- The value validation is being performed on.locale
- The locale to use for the Format.timeZone
- The Time Zone used to format the date,
system default if null (unless value is a Calendar
.String
.public String format(Object value, String pattern, Locale locale)
Format an object using the specified pattern and/or
Locale
.
format
in class AbstractFormatValidator
value
- The value validation is being performed on.pattern
- The pattern used to format the value.locale
- The locale to use for the Format.String
.public String format(Object value, String pattern, Locale locale, TimeZone timeZone)
Format an object using the specified pattern and/or
Locale
.
value
- The value validation is being performed on.pattern
- The pattern used to format the value.locale
- The locale to use for the Format.timeZone
- The Time Zone used to format the date,
system default if null (unless value is a Calendar
.String
.protected String format(Object value, Format formatter)
Format a value with the specified DateFormat
.
format
in class AbstractFormatValidator
value
- The value to be formatted.formatter
- The Format to use.protected Object parse(String value, String pattern, Locale locale, TimeZone timeZone)
Checks if the value is valid against a specified pattern.
value
- The value validation is being performed on.pattern
- The pattern used to validate the value against, or the
default for the Locale
if null
.locale
- The locale to use for the date format, system default if null.timeZone
- The Time Zone used to parse the date, system default if null.null
if invalid.protected abstract Object processParsedValue(Object value, Format formatter)
Process the parsed value, performing any further validation and type conversion required.
processParsedValue
in class AbstractFormatValidator
value
- The parsed object created.formatter
- The Format used to parse the value with.null
if invalid.protected Format getFormat(String pattern, Locale locale)
Returns a DateFormat
for the specified pattern
and/or Locale
.
getFormat
in class AbstractFormatValidator
pattern
- The pattern used to validate the value against or
null
to use the default for the Locale
.locale
- The locale to use for the currency format, system default if null.DateFormat
to created.protected Format getFormat(Locale locale)
Returns a DateFormat
for the specified Locale.
locale
- The locale a DateFormat
is required for,
system default if null.DateFormat
to created.protected int compare(Calendar value, Calendar compare, int field)
Compares a calendar value to another, indicating whether it is equal, less then or more than at a specified level.
value
- The Calendar value.compare
- The Calendar
to check the value against.field
- The field level to compare to - e.g. specifying
Calendar.MONTH
will compare the year and month
portions of the calendar.protected int compareTime(Calendar value, Calendar compare, int field)
Compares a calendar time value to another, indicating whether it is equal, less then or more than at a specified level.
value
- The Calendar value.compare
- The Calendar
to check the value against.field
- The field level to compare to - e.g. specifying
Calendar.MINUTE
will compare the hours and minutes
portions of the calendar.protected int compareQuarters(Calendar value, Calendar compare, int monthOfFirstQuarter)
Compares a calendar's quarter value to another, indicating whether it is equal, less then or more than the specified quarter.
value
- The Calendar value.compare
- The Calendar
to check the value against.monthOfFirstQuarter
- The month that the first quarter starts.Copyright © 2002–2020 The Apache Software Foundation. All rights reserved.