Input control specialized for handling date values.
This displays a text box as well as a button that displays a popup calendar.
When the user enters a value into this control, it will be converted into the closest matching date value or and invalid date message.
Setting the value property of this control, will bypass date matching.
The value of this control is always in the canonical form: YYYY-MM-DD, you can, however, display a different format by setting the format property.
The default css class used for the main element within this control. This is overridden by subclasses. parameter DOMAIN = "%ZEN";
List of localized day abbreviations shown at top of calendar. If specified, this is passed on the popup calendar. property defaultTime as %ZEN.Datatype.string(ZENEXPRESSION=1);
If specified and showTime is true, and the value supplied does not include a time portion, this will be used as the initial time displayed in the popup calendar. property firstDayOfWeek as %ZEN.Datatype.integer(MAXVAL=6,MINVAL=0) [ InitialExpression = 0 ];
Specified which day of the week (Sunday=0, Saturday = 6) is displayed as the starting day of the week. property format as %ZEN.Datatype.string(MAXLEN=3,VALUELIST=",MDY,DMY,YMD",ZENEXPRESSION=1) [ InitialExpression = "YMD" ];
This allows for customizing the calendar for locales where weeks start with other days of the week. This is passed on the popup calendar.
Optional. Specifies the display format used for this component. (Note that the internal value of this control is always YYYY-MM-DD). Possible values are: property image as %ZEN.Datatype.uri [ InitialExpression = "portal/calendar_48.gif" ];
- "YMD" - Year,Month,Day
- "MDY" - Month,Day,Year
- "DMY" - Day,Month,Year
Optional. URL of the "show calendar" icon displayed within this control. property invalidDateMessage as %ZEN.Datatype.caption [ InitialExpression = $$$Text("Invalid Date","%ZEN") ];
Localized "invalid date" message displayed by control. property maxDate as %ZEN.Datatype.string(ZENEXPRESSION=1);
Optional. If specified, this is the latest date allowed by the calendar. This is a date in the form "YYYY-MM-DD". property minDate as %ZEN.Datatype.string(ZENEXPRESSION=1);
Optional. If specified, this is the earliest date allowed by the calendar. This is a date in the form "YYYY-MM-DD". property monthList as %ZEN.Datatype.csv(ZENLOCALIZE=1);
List of localized month names shown at top of calendar. If specified, this is passed on the popup calendar. property onshowPopup as %ZEN.Datatype.eventHandler;
onshowPopup event handler: This event is fired just before the popup calendar is displayed. It provides an opportunity to pass additional settings to the popup calendar. property separator as %ZEN.Datatype.string(MAXLEN=1,VALUELIST=",-,/,., ",ZENEXPRESSION=1) [ InitialExpression = "-" ];
The argument, settings, passed to this callback, is an object (associative array). Property values within this object are passed on as setting to the calendar control.
settings['gapWidth'] = '100px';
Optional. Specifies the separator character used between date segments. Note, if time is also displayed, the time separator is always ":". property showTime as %ZEN.Datatype.boolean [ InitialExpression = 0 ];
If true, then this calendar will also display and allow the user to edit the time of day portion of a date. In this case, the value used by this control will be in xDBC timestamp format: YYYY-MM-DD HH:MM:SS property size as %ZEN.Datatype.integer(MINVAL=0) [ InitialExpression = 15 ];
Size of the input area for this control. property timeCaption as %ZEN.Datatype.caption;
Localized caption for time input box (see showTime). If specified, this is passed on the popup calendar.
Subclasses implement this in order to render the static HTML contents of a component.
Remove formatting to get logical date value.