Convert Date/Time sub tag

Convert Date/Time sub tag

The <f:convertDateTime> tag defines how a string is converted to a Java™ value and vice versa.

Parent tags

This tag is used as a child of the following tags:

<h:inputText>

<h:inputMiniCalendar>

<h:outputText>

Rendering

This component has no visual rendering. No HTML is rendered.

Properties and All Attributes views

The Properties view for a component shows the most common set of attributes you can set on a component, and, depending on the component, you might also see options for adding controls, actions, or other components. To open the Properties view, click

Window | Show View | Properties.

These common attributes for the Convert Date/Time sub tag:

The All Attributes view shows a table of all the attributes you can set on a component, which includes those attributes you can access from the Properties view. To switch to the All Attributes view, click the
All Attributes icon in the upper right corner of the Properties view.

Table 1. Convert Date/Time attributes

Attribute name

Description

dateStyle

Predefined formatting style which determines how the date component of a date string is to be formatted and parsed. Applied only if type is "date" or "both".

locale

Locale whose predefined styles for dates and times are used during formatting or parsing. If not specified, the locale returned by FacesContext.getViewRoot().getLocale() is used.

pattern

Becomes active if you select a custom type number field. Custom formatting pattern which determines how the string should be parsed.

timeStyle

Predefined formatting style which determines how the time component of a date string is to be formatted and parsed. Applied only if type is "time" or "both".

timeZone

Time zone in which to interpret any time information in the date String. Value must be either a VB expression that evaluates to a java.util.TimeZone instance, or a String that is a timezone ID as described in the javadocs for java.util.TimeZone.getTimeZone().

type

The type of the dialog box. A modal dialog box blocks input (keyboard or mouse) to the window under the dialog ( fill out the dialog and press OK or CANCEL before you may do anything else in the page). A modeless dialog box does not block input to the window "under" the dialog.

Note: More than one modeless dialog box may be displayed at a time. If more than one modal dialog box is displayed at a time, the boxes stack on top of each other and only the top dialog is active.

Attribute name	Description
dateStyle	Predefined formatting style which determines how the date component of a date string is to be formatted and parsed. Applied only if type is "date" or "both".
locale	Locale whose predefined styles for dates and times are used during formatting or parsing. If not specified, the locale returned by FacesContext.getViewRoot().getLocale() is used.
pattern	Becomes active if you select a custom type number field. Custom formatting pattern which determines how the string should be parsed.
timeStyle	Predefined formatting style which determines how the time component of a date string is to be formatted and parsed. Applied only if type is "time" or "both".
timeZone	Time zone in which to interpret any time information in the date String. Value must be either a VB expression that evaluates to a java.util.TimeZone instance, or a String that is a timezone ID as described in the javadocs for java.util.TimeZone.getTimeZone().
type	The type of the dialog box. A modal dialog box blocks input (keyboard or mouse) to the window under the dialog ( fill out the dialog and press OK or CANCEL before you may do anything else in the page). A modeless dialog box does not block input to the window "under" the dialog. Note: More than one modeless dialog box may be displayed at a time. If more than one modal dialog box is displayed at a time, the boxes stack on top of each other and only the top dialog is active.