Specifying Date/Time Picker object tag parameters

To embed an instance of the Date/Time Picker in HTML, use the object tag with type set to application/avantgo-mime-datetimepicker:

<object type="application/avantgo-mime-datetimepicker" 
    width=pixelsWide height=pixelsHigh> </object>

Where:

  • pixelsWide is the width of the Date/Time Picker area in pixels.

  • pixelsHigh is the height of the Date/Time Picker area in pixels.

For a list of parameters you can specify within the object tag, see the table below. For reference material you will need to write JavaScript or C code to use the Date/Time Picker, see M-Business Date/Time Picker API.

Table 4. Date/Time Picker object tag parameters

Specification

Description

abbreviatedMonthLabels

Shorter, abbreviated labels to be displayed for the months of the year. Default value: 'Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec'

abbreviatedWeekdayLabels

Shorter, abbreviated labels to be displayed for the days of the week. Default value: 'Sun, Mon, Tue, Wed, Thu, Fri, Sat'

datePickerArrowWidth

The width, in pixels, of the arrow.

Note: This is different from the length of the arrow.

datePickerAvgoRange

Whether the server-side date range should be enforced: true or false. When the default value, true, is selected, the user can only select a date between the years 1901 and 2037.

Note: This option does not apply to the Palm OS version. Palmas always has a date range set between the years 1904 and 2031.

datePickerBdColor

Border color for the Date Picker. Default value: Navy (000080).

datePickerCellBgColor

Background color for the Date Picker. Default value: gray (#cccccc).

datePickerCellFgColor

Foreground color for the Date Picker. Default value: black.

datePickerCellSelectBgColor

Background color for the selected date in the Date Picker. Default value: black.

datePickerCellSelectFgColor

Foreground color for the selected date in the Date Picker. Default value: white.

datePickerFontFamily

Font family for the Date Picker. Default value: sans-serif.

datePickerFontSize

Font size for the Date Picker. Default value: 9.

datePickerHeaderBgColor

Background color for the weekday names area in the Date Picker. Default value: black.

datePickerHeaderFgColor

Foreground color for the weekday names area in the Date Picker. Default value: white.

datePickerMonthBgColor

Background color for the month selector in the Date Picker. Default value: gray (#cccccc).

datePickerMonthFgColor

Foreground color for the month selector in the Date Picker. Default value: navy (#000080).

datePickerStartDayOfWeek

Start day of the week. Default value: 0 (Sunday). Possible values are:

0 (Sunday)

1 (Monday)

2 (Tuesday)

3 (Wednesday)

4 (Thursday)

5 (Friday)

6 (Saturday)

datePickerVisibility

Visibility of the Date Picker. Default value: true.

datePickerYearBgColor

Background color for the year selector in the Date Picker. Default value: gray (#cccccc).

datePickerYearFgColor

Foreground color for the year selector in the Date Picker. Default value: navy (#000080).

dateTimeValue

Specified date/time value: an integer value representing the number of seconds since Jan. 1, 1970 00:00:00.

format

Format specification for the read-only text field. See Field format specifications, for a list of specification values and their associated descriptions.

fullMonthLabels

The full labels to be displayed for the months of the year. Default value: 'January, February, March, April, May, June, July, August, September, October, November, December'

fullWeekdayLabels

The full labels to be displayed for the days of the week. Default value: 'Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday'

setCurrent

Initialize the Date/Time Picker with the current date/time: true or false. Default value: false.

setCurrentTime

Initialize the Date/Time Picker with the current time only: true or false. Default value: false.

shortWeekdayLabels

The very shortest labels to be displayed for the days of the week. Default value: 'S,M,T,W,T,F,S'

timePicker24hrFormat

Use 24-hour format to display the Time Picker (instead of am/pm), true or false. Default value: false. See Field format specifications, for a list of specification values and their associated descriptions.

timePickerAMDesignator

Designator string for a.m. times.

timePickerBdColor

Border color for the Time Picker. Default value: navy (#000080).

timePickerBgColor

Background color for the Time Picker. Default value: white.

timePickerFgColor

Foreground color for the Time Picker. Default value: black.

timePickerFontFamily

Font family for the Time Picker. Default value: sans-serif.

timePickerFontSize

Font size for the Time Picker. Default value: 9.

timePickerPMDesignator

Designator string for p.m. times.

timePickerSelectBgColor

Background color for the selected component in the Time Picker. Default value: black.

timePickerSelectFgColor

Foreground color for the selected component in the Time Picker. Default value: white.

timePickerVisibility

Visibility of the Time Picker, true or false. Default value: true.