Tag name: <amc:convertDateTime>

type: oracle.adf.rich.DateTime
Converts string into java.util.Date and vice versa based on the pattern and style set.

The default dateStyle is shortish. Shortish is identical to short but forces the year to be a full four digits. dateStyle defaults to shortish if it was not set.

Timezone can be set per web-app in adf-faces-config.xml configuration file. If timeZone is not set on the converter, then timezone will be defaulted to the value set in adf-faces-config.xml configuration file. If it is not set in the configuration file, then it will be defaulted to GMT.

The converter always allows a level of leniency while converting user input value to date to the following extent.

• A converter with associated pattern 'MMM' for month, when attached to any value holder, will accept values with month specified in the form 'MM' or 'M' as valid.
• Allows use of separators '-' or '.' or '/' irrespective of the separator specified in the associated pattern.
• The leniency is applicable to both 'pattern' and 'secondaryPattern'.

For example:
When pattern on the converter is set to "MMM/d/yyyy" the following inputs are tolerated as valid by the converter.

Jan/4/2004

Jan-4-2004

Jan.4.2004

01/4/2004

01-4-2004

01.4.2004

1/4/2004

1-4-2004

1.4.2004

The converter supports the same parsing/formatting conventions as the JDK SimpleDateFormat (specified using the dateStyle, timeStyle and pattern attributes) except:

• When timezone is specified to have a long display, e.g.'timeStyle=full' or a pattern with 'zzzz'. Instead of a long descriptive string, e.g. "Pacific Standard Time", the timezone will be displayed in the General Timezone format (GMT +/- offset) or RFC-822 timezones.

This converter provides a format hint for the help framework, which cannot be turned off.

This converter is automatically registered under the standard converter ID, and therefore will be used when the <f:convertDateTime> tag is used.

This converter also runs on the client (implements org.apache.myfaces.trinidad.convert.ClientConverter).

If you derive a class from amc:convertDateTime, it will not work with amc:inputDate unless you also implement ClientConverter.

<amc:inputText id="mdf5" value="2004/09/06" label="Date">
  <amc:convertDateTime pattern="yyyy/M/d" secondaryPattern="d/M/yyyy" />
</amc:inputText>

Attributes