Calendar and Date Properties

These properties configure calendars.

For more information, see About Dates.

If you want to change the default values, enter your changes in the emxSystem.properties page object. For more information, see Editing Properties Using MQL.

Property Name Property Description Valid Values
emxFramework.Calendar.Events Defines the background color used to display non-working days in the popup date chooser. This property only affects date fields or columns defined with the Calendar Function and Calendar Program settings. The non-working days are those associated with a calendar defined for a Location related to the field/column where the date is being set.

The format for the property value is:<EVENT>|<COLOR>|selectable. The last part of the value can only be set to selectable (even though the day is defined as non-working, it can still be selected when populating fields).

For example: NON-WORKING|yellow|selectable

As installed, NON-WORKING is the only event defined. If your business processes require additional types of events (for example, you want to display holidays in a different color than weekends), you can create a custom JPO:method that returns a string of dates to the date chooser. See the Java Docs for details on the Calendar Program and Calendar Function settings for a datefield or column.

Pipe-separated event, color, selectable
emxFramework.AllowKeyableDatesAllows manual entry of a date in a date field. When true, users must select a date using the calendar tool. When false, users can manually enter dates in date fields.True or False
emxFramework.DateTime.DisplayFormatDefines the length of the time/date display for all users. The actual display format is determined by the browser language setting. For example, if the value is set to MEDIUM on a browser set to en-us, the dates display as "Jan 12, 1952". If the browser is set to a European language, the dates display as "12 Jan 1952".

Date fields for some app pages contain logic that compares the date the user enters with another date. For example, the task definition pages compare the task due date with the current date. If this property is set to SHORT, only dates between 1950 and 2049 can be entered and compared correctly on such pages. If users need to enter dates outside of this range, choose the MEDIUM format.

This table shows U.S. examples of the dates for each supported format:

Date FormatExample
SHORT12.13.52 3:30 pm
MEDIUMDec 12, 1952
LONGDecember 12, 1952
FULLTuesday, December 12 1952 AD 3:30:42 pm PST

One of these values:
  • SHORT
  • MEDIUM
  • LONG
  • FULL
emxFramework.DateTime.DisplayTimeDefines if date displays include time values. When true, the date display includes the time. When false, the date display does not include the time.

If no TimeZone preference is set, then the DateTime is shown in the browser's time zone. The time is shown in terms of GMT+/- hh:mm, (for example: Saturday, August 21, 2004 12:45:00 PM GMT-04:00). To get the time in a format like EST or PDT, set the TimeZone preference to a specific zone.

The JSP that displays the page can override this setting.

True or False
eServiceSuites.eMatrixDateFormatChanges the Java date format the system should use to read dates from the database.

If you change the values for these properties, make sure there are no trailing spaces at the end of the format. For example, if you remove the "a" at the end of the default format, remove the space that precedes it also.

Must be the same format defined in MX_NORMAL_DATETIME_FORMAT in the enovia.ini (Windows) or mxEnv.sh (UNIX) file. By default, it is the same format. See Time String Format for a definition of the required format.
Important: Only change this property value if you changed the equivalent properties in enovia.ini or mxENV.sh.
Important: For Japanese installations, you cannot use the meridian (AM/PM) variable (the a at the end of the value). We recommend this value for Japanese installations: MM/dd/yyyy HH:mm:ss. You must also make sure the MX_NORMAL_DATETIME_FORMAT property in enovia.ini or mxEnv.sh uses the equivalent setting: moy/dom/yr4 h24:min:sec.
MM/dd/yyyy HH:mm:ss a
eServiceSuites.eMatrixInputDateFormatSets the value to match the eMatrixInputDateFormat property.

When the user chooses a date/time using the Calendar chooser (the standard UI mechanism for entering dates in apps), the system converts this localized date to the format defined in this property. The system then attempts to parse the date/time using the format defined in NORMAL. If the format does not match NORMAL, the system parses the format using TERSE.

Must be the same format defined in either MX_NORMAL_DATETIME_FORMAT or MX_TERSE_DATETIME_FORMAT. By default, it is the same format as NORMAL.

Important: Only change this property value if you changed the equivalent properties in the MatrixIniDefaults program.
MM/dd/yyyy HH:mm:ss a
emxFramework.CalendarDisplay.YearsBeforeSpecifies the number of years before the current year to be included in the Year drop-down list that is displayed when a user clicks the calendar icon. Positive integer
emxFramework.CalendarDisplay.YearsAfterSpecifies the number years after the current year to be included in the Year drop-down list that is displayed when a user clicks the calendar icon.Positive integer
emxFramework.CalendarDisplay.CustomYears Specifies any years to include in the calendar drop-down not contiguous to the currently defined years.Comma-separated list of years