DateDialog

Top  Previous  Next

The DateDialog element, which consists of several basic elements and the javascripts, behaves like a single input element. The name of the element is given through name property of the outer-most element.

DateDialogX
DateDialog_pe

 

Properties

From Date

The Minimum date in "yyyy.mm.dd" format that can be selected on the dialog.

To Date

The maximum date in "yyyy.mm.dd" format that can be selected on the dialog.

Default Date

The default date in "yyyy.mm.dd" format to be used when initial value is not available.

Examples:

today
today +1d
today +1y

 

Exclude Weekends

Set this property to true to exclude the weekend days from the Day combobox to force the user to select a Week Day.

Value

The initial value. The default value of this property is set to get the initial value dynamically from the XML data node that has the same name as the elements name. Therefore for the most of the cases it is just enough to assign the name of the element the same as the data node name.

It is also possible to specify the value as a constant. Whether it is a constant or a dynamic value the format of the value must conform to the Value Format definition.

Value Format,  Submit Format

The date formats can be different from system to system. You can select one of the predefined formats for these properties or type in your custom one.

- Value Format : The format of the date value received from server.

- Submit Format : The format of the date value sent to the server.

 

Month Format

Month Combo box can be displayed in three formats:

- Long Text: January, February, etc

- Short Text: Jan, Feb, etc

- Number: 01,02,,,,12

 

Event Handlers

On Year Change

It is called when the value of Year combo is changed.

On Change

It is called when one of Day, Month or Year combos is changed.

Example:

Event Handlers | On Change : theDateIsChanged

function theDateIsChanged(dd){
 
  alert("Day      : " + dd.delm.value + "\n" +
        "Month    : " + dd.melm.value + "\n" +
        "Year     : " + dd.yelm.value + "\n" +
        "Week Day : " + dd.telm.value);
}

 

 

Validation

See the topic "Validating User's Input" in the main help file for general explanations about validation.

 

See Date Formatting Symbols

See Dynamic Values

See Localizing Validation Messages