• Home
• Prado
• Web
• UI
• WebControls
• TDatePicker

PHP Class Prado\Web\UI\WebControls\TDatePicker

TDatePicker displays a text box for date input purpose. When the text box receives focus, a calendar will pop up and users can pick up from it a date that will be automatically entered into the text box. The format of the date string displayed in the text box is determined by the DateFormat property. Valid formats are the combination of the following tokens, Character Format Pattern (en-US) ----------------------------------------- d day digit dd padded day digit e.g. 01, 02 M month digit MM padded month digit MMMM localized month name, e.g. March, April yy 2 digit year yyyy 4 digit year ----------------------------------------- TDatePicker has four Mode to show the date picker popup. # Basic -- Only shows a text input, focusing on the input shows the date picker. This way you can access the popup using only the keyboard. Note that because of this, TAB-bing through this control will automatically select the current date if no previous date was selected. If you close the popup (eg. pressing the ESC key) you'll need to un-focus and re-focus the control again for the popup to reappear. # Clickable -- Only shows a text input, clicking on the input shows the date picker. This mode solves the two small problems of the Basic mode. It was first introduced in Prado 3.2. # Button -- Shows a button next to the text input, clicking on the button shows the date, button text can be by the ButtonText property # ImageButton -- Shows an image next to the text input, clicking on the image shows the date picker, image source can be change through the ButtonImageUrl property. The CssClass property can be used to override the css class name for the date picker panel. CalendarStyle property sets the packages styles available. E.g. default. The InputMode property can be set to "TextBox" or "DropDownList" with default as "TextBox". In DropDownList mode, in addition to the popup date picker, three drop down list (day, month and year) are presented to select the date . The PositionMode property can be set to "Top" or "Bottom" with default as "Bottom". It specifies the position of the calendar popup, relative to the input field. Datei anzeigen Open project: pradosoft/prado Class Usage Examples

Public Methods

Method	Description
getButtonImageUrl ( ) : string
getButtonText ( ) : string
getCalendarStyle ( ) : string
getClientSide ( ) : TDatePickerClientScript	Gets the TDatePickerClientScript to set the TDatePicker event handlers.
getCulture ( ) : string	Gets the current culture.
getData ( ) : integer	Returns the timestamp selected by the user.
getDate ( ) : string
getDateFormat ( ) : string
getFirstDayOfWeek ( ) : integer
getFromYear ( ) : integer
getInputMode ( ) : TDatePickerInputMode
getMode ( ) : TDatePickerMode
getPositionMode ( ) : TDatePickerPositionMode
getShowCalendar ( ) : boolean
getTimeStamp ( ) : integer
getUpToYear ( ) : integer
getValidationPropertyValue ( ) : integer	Returns the value to be validated.
loadPostData ( $key, $values ) : boolean	Loads user input data. Override parent implementation, when InputMode is DropDownList call getDateFromPostData to get date data.
onPreRender ( $param )	Publish the date picker Css asset files.
render ( $writer )	Renders body content.
setAutoPostBack ( $value )	AutoPostBack is not supported.
setButtonImageUrl ( $value )
setButtonText ( $value )
setCalendarStyle ( $value )
setCulture ( $value )	Sets the culture/language for the date picker.
setData ( $value )	Sets the timestamp represented by this control.
setDate ( $value )
setDateFormat ( $value )	Sets the format of the date string.
setFirstDayOfWeek ( $value )	Set the first day of week, with 0 as Sunday, 1 as Monday, etc.
setFromYear ( $value )
setInputMode ( $value )
setMode ( $value )
setPositionMode ( $value )
setShowCalendar ( $value )	Sets whether to pop up the calendar window when the control receives focus
setTimeStamp ( $value )	Sets the date for the date picker using timestamp.
setUpToYear ( $value )

Protected Methods

Method	Description
addAttributesToRender ( $writer )	Add the client id to the input textbox, and register the client scripts.
createClientScript ( ) : TDatePickerClientScript
getAssetUrl ( $file = '' ) : string
getCulturalOptions ( ) : array	Get javascript localization options, e.g. month and weekday names.
getCurrentCulture ( ) : string
getDateFromPostData ( $key, $values ) : array	Loads date from drop down list data.
getDatePickerButtonID ( ) : string	Gets the ID for the date picker trigger button.
getDatePickerOptions ( ) : array	Get javascript date picker options.
getDropDownDayOptions ( ) : array
getLocalizedCalendarInfo ( ) : DateTimeFormatInfo
getLocalizedMonthNames ( $info ) : array	Returns the localized month names that depends on the month format pattern.
getTimeStampFromText ( ) : integer	Gets the date from the text input using TSimpleDateFormatter
hasDayPattern ( )
publishCalendarStyle ( ) : string	Publish the calendar style Css asset file.
registerCalendarClientScriptPre ( )	Registers the javascript code to initialize the date picker.
renderButtonDatePicker ( $writer ) : THtmlWriter	Adds an additional button such that when clicked it shows the date picker.
renderCalendarDayOptions ( $writer, $selected = null )	Renders the day drop down list options.
renderCalendarMonthOptions ( $writer, $selected = null )	Renders the month drop down list options.
renderCalendarSelections ( $writer, $date )	Renders the calendar drop down list depending on the DateFormat pattern.
renderCalendarYearOptions ( $writer, $selected = null )	Renders the year drop down list options.
renderClientControlScript ( $writer )
renderDatePickerButtons ( $writer )	Renders the date picker popup buttons.
renderDropDownListCalendar ( $writer )	Renders the drop down list date picker.
renderImageButtonDatePicker ( $writer ) : THtmlWriter	Adds an additional image button such that when clicked it shows the date picker.

Private Methods

Method	Description
renderDropDownListOptions ( $writer, $options, $selected = null )	Renders a drop down lists.

Method Details