Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces-EE ACE Components
Tag dateTimeEntry

The DateTime Entry is a component that allows the user to configure and input a date and/or time in various ways.

For more information, see the DateTimeEntry Wiki Documentation.

Client Events
Name | Description | Supported classes for argument
dateSelect | Fired when a date is selected from the calendar (default event). | org.icefaces.ace.event.DateSelectEvent
dateTextChange | Fired when date text is changed and input field loses focus. | org.icefaces.ace.event.DateTextChangeEvent

Client events can be used with Client Behaviors and the ace:ajax tag.

Tag Information
Tag Class | org.icefaces.ace.component.datetimeentry.DateTimeEntryTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
accesskey | no | true | `java.lang.String` | Access key that, when pressed, transfers focus to this component when it's in popup mode.
binding | no | true | `javax.el.ValueExpression` | Using an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
buttonText | no | true | `java.lang.String` | The text to display on the trigger button. Use in conjunction with the showOn option set to "button" or "both". Default = "".
converter | no | true | `javax.faces.convert.Converter` | Converter is an interface describing a Java class that can perform Object-to-String and String-to-Object conversions between model data objects and a String representation of those objects that is suitable for rendering.
converterMessage | no | true | `java.lang.String` | If present, will be used as the text of the converter message, replacing any message that comes from the converter.
disableHoverStyling | no | true | `boolean` | Set to true to disable hover styling to improve performance. Default = 'false'.
disabled | no | true | `boolean` | If true then this date time entry will be disabled and can not be entered. Default = 'false'.
effect | no | true | `java.lang.String` | Name of the animation used to show/hide the calendar. Use "show", "slideDown", "fadeIn", any of the show/hide jQuery UI effects, or "" for no animation. Default = 'show'.
effectDuration | no | true | `java.lang.String` | Control the speed at which the calendar appears, it may be a time in milliseconds or a string representing one of the three predefined speeds ("slow", "normal", "fast"). Default = 'normal'.
id | no | true | `java.lang.String` | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediate | no | true | `boolean` | A flag indicating that conversion and validation of this component's value should occur during Apply Request Values phase instead of Process Validations phase. Default = 'false'.
indicatorPosition | no | true | `java.lang.String` | Position of input-required or input-optional indicator relative to input field or label. Supported values are "left/right/top/bottom/labelLeft/labelRight/none". Default is "labelRight" if labelPosition is "inField", "right" otherwise.
label | no | true | `java.lang.String` | A localized user presentable name for this component.
labelPosition | no | true | `java.lang.String` | Position of label relative to input field. Supported values are "left/right/top/bottom/inField/none". Default is "none".
leftMonthOffset | no | true | `int` | Zero-based offset indicating which month should be displayed in the leftmost position. Default = '0'.
lenientParsing | no | true | `boolean` | With lenient parsing, the Java date parser may use heuristics to interpret inputs that do not precisely match this date's format. With strict parsing, inputs must match this date's format. Ignored if the converter attribute is used to do format conversion. Default = 'true'.
locale | no | true | `java.lang.Object` | Locale to be used for labels and conversion. Locale string or java.util.Locale object. Default is locale of view root.
maxHour | no | true | `int` | Set the hour range. Default = '23'.
maxMinute | no | true | `int` | Set the minute range. Default = '59'.
maxSecond | no | true | `int` | Set the second range. Default = '59'.
maxdate | no | true | `java.lang.Object` | Set a maximum selectable date. Date string or java.util.Date object. Default is no limit. This attribute is ignored if 'selectableDateRanges' is specified.
maxlength | no | true | `int` | The maximum number of characters that may be entered in this field.
minHour | no | true | `int` | Set the hour range. Default = '0'.
minMinute | no | true | `int` | Set the minute range. Default = '0'.
minSecond | no | true | `int` | Set the second range. Default = '0'.
mindate | no | true | `java.lang.Object` | Set a minimum selectable date. Date string or java.util.Date object. Default is no limit. This attribute is ignored if 'selectableDateRanges' is specified.
navigator | no | true | `boolean` | Enables month/year navigator.
optionalIndicator | no | true | `java.lang.String` | Indicator indicating that the user is NOT required to provide a submitted value for this input component.
pages | no | true | `int` | Enables multiple page rendering. Default = '1'.
pattern | no | true | `java.lang.String` | DateFormat pattern for localization. See the DateTimeEntry Wiki Documentation for limitations. Ignored if the converter attribute is used to do format conversion. Default = 'MM/dd/yyyy'.
popupIcon | no | true | `java.lang.String` | The URL for the popup button image. Default is the file "META-INF/resources/icefaces.ace/datetimeentry/calendar_icon.png" in the components jar. showOn attribute must be set to "button" or "both".
popupIconOnly | no | true | `boolean` | When enabled, popup icon is rendered without it appearing on a button. Default: "false".
readOnlyInputText | no | true | `boolean` | Makes input text of a popup calendar readonly.
readonly | no | true | `boolean` | If true then this date time entry will be read-only and can not be entered.
renderAsPopup | no | true | `boolean` | Whether to render the calendar inline or as a popup. Default = 'false'.
rendered | no | true | `boolean` | Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
required | no | true | `boolean` | A flag indicating whether the user required to provide a non-empty submitted value for this component. Default = 'false'.
requiredIndicator | no | true | `java.lang.String` | Indicator indicating that the user is required to provide a submitted value for this input component.
requiredMessage | no | true | `java.lang.String` | If present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used.
selectOtherMonths | no | true | `boolean` | Enables selection of days belonging to other months.
selectableDateRanges | no | true | `java.lang.Object` | Specifies a number of ranges of selectable dates. The value can be a number of date strings separated by commas, a List of Date objects or an Array of Date objects. These dates are taken in pairs to delimit a range; the first date in the pair is the start date, and the second date in the pair is the end date of that range. These dates are inclusive. If the first date of the pair is null, the empty string, or an invalid date, then the range will be considered to be from any date in the past up to its end date. Likewise, if the second date of the pair is null, an empty string, or an invalid date, then the range will be considered to be from its start date to any date in the future thereafter. If the dates are specified as strings, they are parsed according to the 'pattern' attribute of this component. Dates are taken literally, as they appear in the calendar, without regard for time zones. This attribute takes precedence over the 'mindate' and 'maxdate' attributes. This attribute is only used to specify date ranges, not date-time ranges.
showButtonPanel | no | true | `java.lang.Boolean` | Whether to show the panel containing today button and close button for popup. Default is false without time component and true with time component.
showOn | no | true | `java.lang.String` | Have the calendar appear automatically when the field receives focus ("focus"), appear only when a button (specified by popupIcon attribute) is clicked ("button"), or appear when either event takes place ("both"). Default = 'focus'.
showOtherMonths | no | true | `boolean` | Displays days belonging to other months.
showWeek | no | true | `boolean` | Displays the week number next to each week.
singleSubmit | no | true | `boolean` | When singleSubmit is true, changing the value of this component will submit and execute this component only (equivalent to <f:ajax execute="@this" render="@all">). When singleSubmit is false, no submit will occur. <ace:ajax> submit events have precedence over singleSubmit. Default = 'false'.
size | no | true | `int` | The number of characters used to determine the width of the input field in a popup calendar. Default is the maximum possible size of a date formatted by the date pattern.
stepHour | no | true | `int` | Increment/decrement steps when hour slider is dragged. Default = '1'.
stepMinute | no | true | `int` | Increment/decrement steps when minute slider is dragged. Default = '1'.
stepSecond | no | true | `int` | Increment/decrement steps when second slider is dragged. Default = '1'.
style | no | true | `java.lang.String` | style will be rendered on a root element of this component
styleClass | no | true | `java.lang.String` | style class will be rendered on a root element of this component
tabindex | no | true | `java.lang.String` | Position of the text field in the tabbing order for the current page. This value must be an integer between 0 and 32767.
timeOnly | no | true | `boolean` | Specifies whether to display/input time only. Default = 'false'.
timeZone | no | true | `java.lang.Object` | String or a java.util.TimeZone instance to specify the timezone used for date conversion, defaults to TimeZone.getDefault()
title | no | true | `java.lang.String` | Advisory title information about markup elements generated for this component.
todayNowButtonsAlsoSelect | no | true | `boolean` | The Today (or Now) button can be set to navigate the popup to the current month without selecting date/time, or select the date/time as well. Default = 'false'.
validator | no | true | `javax.el.MethodExpression` | MethodExpression representing a validator method that will be called during Process Validations to perform correctness checks on the value of this component. The expression must evaluate to a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.
validatorMessage | no | true | `java.lang.String` | If present, will be used as the text of the validator message, replacing any message that comes from the validator.
value | no | true | `java.lang.Object` | The current value of the simple component. The value to be rendered.
valueChangeListener | no | true | `javax.el.MethodExpression` | MethodExpression representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a `ValueChangeEvent` parameter, with a return type of void, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing what the new value is, but this can be useful in cases where a notification is needed that "this value changed".
widgetVar | no | true | `java.lang.String` | Name of the client side widget.
yearRange | no | true | `java.lang.String` | Control the range of years displayed in the year drop-down: either relative to today's year (-nn:+nn), relative to the currently selected year (c-nn:c+nn), absolute (nnnn:nnnn), or combinations of these formats (nnnn:-nn). Default = 'c-10:c+10'.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.