ICEfaces 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
NameDescriptionSupported classes for argument
dateSelectFired when a date is selected from the calendar (default event).org.icefaces.ace.event.DateSelectEvent
dateTextChangeFired 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 Classorg.icefaces.ace.component.datetimeentry.DateTimeEntryTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingnofalsejavax.el.ValueExpressionUsing an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
buttonTextnofalsejava.lang.StringThe text to display on the trigger button. Use in conjunction with the showOn option set to "button" or "both". Default = "".
converternofalsejavax.faces.convert.ConverterConverter 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.
converterMessagenofalsejava.lang.StringIf present, will be used as the text of the converter message, replacing any message that comes from the converter.
disableHoverStylingnofalsebooleanSet to true to disable hover styling to improve performance. Default = 'false'.
disablednofalsebooleanIf true then this date time entry will be disabled and can not be entered. Default = 'false'.
effectnofalsejava.lang.StringName 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'.
effectDurationnofalsejava.lang.StringControl 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'.
idnofalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatenofalsebooleanA 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'.
indicatorPositionnofalsejava.lang.StringPosition 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.
labelnofalsejava.lang.StringA localized user presentable name for this component.
labelPositionnofalsejava.lang.StringPosition of label relative to input field. Supported values are "left/right/top/bottom/inField/none". Default is "none".
leftMonthOffsetnofalseintZero-based offset indicating which month should be displayed in the leftmost position. Default = '0'.
lenientParsingnofalsebooleanWith 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'.
localenofalsejava.lang.ObjectLocale to be used for labels and conversion. Locale string or java.util.Locale object. Default is locale of view root.
maxHournofalseintSet the hour range. Default = '23'.
maxMinutenofalseintSet the minute range. Default = '59'.
maxSecondnofalseintSet the second range. Default = '59'.
maxdatenofalsejava.lang.ObjectSet a maximum selectable date. Date string or java.util.Date object. Default is no limit.
maxlengthnofalseintThe maximum number of characters that may be entered in this field.
minHournofalseintSet the hour range. Default = '0'.
minMinutenofalseintSet the minute range. Default = '0'.
minSecondnofalseintSet the second range. Default = '0'.
mindatenofalsejava.lang.ObjectSet a minimum selectable date. Date string or java.util.Date object. Default is no limit.
navigatornofalsebooleanEnables month/year navigator.
optionalIndicatornofalsejava.lang.StringIndicator indicating that the user is NOT required to provide a submitted value for this input component.
pagesnofalseintEnables multiple page rendering. Default = '1'.
patternnofalsejava.lang.StringDateFormat 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'.
popupIconnofalsejava.lang.StringThe 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".
popupIconOnlynofalsebooleanWhen enabled, popup icon is rendered without it appearing on a button. Default: "false".
readOnlyInputTextnofalsebooleanMakes input text of a popup calendar readonly.
readonlynofalsebooleanIf true then this date time entry will be read-only and can not be entered.
renderAsPopupnofalsebooleanWhether to render the calendar inline or as a popup. Default = 'false'.
renderednofalsebooleanReturn true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
requirednofalsebooleanA flag indicating whether the user required to provide a non-empty submitted value for this component. Default = 'false'.
requiredIndicatornofalsejava.lang.StringIndicator indicating that the user is required to provide a submitted value for this input component.
requiredMessagenofalsejava.lang.StringIf present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used.
selectOtherMonthsnofalsebooleanEnables selection of days belonging to other months.
showButtonPanelnofalsejava.lang.BooleanWhether to show the panel containing today button and close button for popup. Default is false without time component and true with time component.
showOnnofalsejava.lang.StringHave 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'.
showOtherMonthsnofalsebooleanDisplays days belonging to other months.
showWeeknofalsebooleanDisplays the week number next to each week.
singleSubmitnofalsebooleanWhen 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'.
sizenofalseintThe 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.
stepHournofalseintIncrement/decrement steps when hour slider is dragged. Default = '1'.
stepMinutenofalseintIncrement/decrement steps when minute slider is dragged. Default = '1'.
stepSecondnofalseintIncrement/decrement steps when second slider is dragged. Default = '1'.
stylenofalsejava.lang.Stringstyle will be rendered on a root element of this component
styleClassnofalsejava.lang.Stringstyle class will be rendered on a root element of this component
tabindexnofalsejava.lang.StringPosition of the text field in the tabbing order for the current page. This value must be an integer between 0 and 32767.
timeOnlynofalsebooleanSpecifies whether to display/input time only. Default = 'false'.
timeZonenofalsejava.lang.ObjectString or a java.util.TimeZone instance to specify the timezone used for date conversion, defaults to TimeZone.getDefault()
validatornofalsejavax.el.MethodExpressionMethodExpression 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.
validatorMessagenofalsejava.lang.StringIf present, will be used as the text of the validator message, replacing any message that comes from the validator.
valuenofalsejava.lang.ObjectThe current value of the simple component. The value to be rendered.
valueChangeListenernofalsejavax.el.MethodExpressionMethodExpression 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".
widgetVarnofalsejava.lang.StringName of the client side widget.
yearRangenofalsejava.lang.StringControl 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.


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.