| Apache Struts 2 Documentation > Home > Guides > Tag Developers Guide > Struts Tags > Tag Reference > UI Tag Reference > datepicker |
| Please make sure you have read the Tag Syntax document and understand how tag attribute syntax works. |
Renders datepicker element.
A stand-alone DatePicker widget that makes it easy to select a date, or increment by week, month, and/or year.
Dates attributes passed in the `RFC 3339` format:Renders datepicker element.
Format supported by this component are:-| Format | Description |
| #dd | Display day in two digits format |
| #d | Try to display day in one digit format, if cannot use 2 digit format |
| #MM | Display month in two digits format |
| #M | Try to display month in one digits format, if cannot use 2 digit format |
| #yyyy | Display year in four digits format |
| #yy | Display the last two digits of the yaer |
| #y | Display the last digits of the year |
Name |
Required |
Default |
Evaluated |
Type |
Description |
|---|---|---|---|---|---|
| accesskey | false | true | String | Set the html accesskey attribute on rendered html element | |
| adjustWeeks | false | false | true | Boolean | If true, weekly size of calendar changes to acomodate the month if false, 42 day format is used |
| cssClass | false | true | String | The css class to use for element | |
| cssStyle | false | true | String | The css style definitions for element ro use | |
| dayWidth | false | narrow | true | String | How to render the names of the days in the header(narrow, abbr or wide) |
| disabled | false | true | String | Set the html disabled attribute on rendered html element | |
| displayWeeks | false | 6 | true | Integer | Total weeks to display |
| endDate | false | 2941-10-12 | true | Date | Last available date in the calendar set |
| id | false | true | String | id for referencing element. For UI and form tags it will be used as HTML id attribute | |
| key | false | true | String | Set the key (name, value, label) for this particular component | |
| label | false | true | String | Label expression used for rendering a element specific label | |
| labelposition | false | true | String | Define label position of form element (top/left) | |
| language | false | brower's specified preferred language | true | String | Language to display this widget in |
| name | false | true | String | The name to set for element | |
| onblur | false | true | String | Set the html onblur attribute on rendered html element | |
| onchange | false | true | String | Set the html onchange attribute on rendered html element | |
| onclick | false | true | String | Set the html onclick attribute on rendered html element | |
| ondblclick | false | true | String | Set the html ondblclick attribute on rendered html element | |
| onfocus | false | true | String | Set the html onfocus attribute on rendered html element | |
| onkeydown | false | true | String | Set the html onkeydown attribute on rendered html element | |
| onkeypress | false | true | String | Set the html onkeypress attribute on rendered html element | |
| onkeyup | false | true | String | Set the html onkeyup attribute on rendered html element | |
| onmousedown | false | true | String | Set the html onmousedown attribute on rendered html element | |
| onmousemove | false | true | String | Set the html onmousemove attribute on rendered html element | |
| onmouseout | false | true | String | Set the html onmouseout attribute on rendered html element | |
| onmouseover | false | true | String | Set the html onmouseover attribute on rendered html element | |
| onmouseup | false | true | String | Set the html onmouseup attribute on rendered html element | |
| onselect | false | true | String | Set the html onselect attribute on rendered html element | |
| required | false | false | true | Boolean | If set to true, the rendered element will indicate that input is required |
| requiredposition | false | true | String | Define required position of required form element (left|right) | |
| startDate | false | 1492-10-12 | true | Date | First available date in the calendar set |
| staticDisplay | false | false | true | Boolean | Disable all incremental controls, must pick a date in the current display |
| tabindex | false | true | String | Set the html tabindex attribute on rendered html element | |
| template | false | true | String | The template (other than default) to use for rendering the element | |
| templateDir | false | true | String | The template directory. | |
| theme | false | true | String | The theme (other than default) to use for rendering the element | |
| title | false | true | String | Set the html title attribute on rendered html element | |
| tooltip | false | true | String | Set the tooltip of this particular component | |
| tooltipConfig | false | true | String | Set the tooltip configuration | |
| value | false | true | String | Preset the value of input element. | |
| weekStartsOn | false | 0 | true | Integer | Adjusts the first day of the week 0==Sunday..6==Saturday |
Example 1:
<s:datepicker name="order.date" label="Order Date" />
Example 2:
<s:datepicker name="delivery.date" label="Delivery Date" format="#yyyy-#MM-#dd" />
The css could be changed by using the following :-
<s:datepicker name="birthday" label="Birthday" templateCss="...." />