userFormat

userFormat(fmt: TimeFormat): String;

The userFormat method of the Time primitive type returns a string containing the receiver in the specified time format.

To define your time formats, use the Schema menu Format command from the Schema Browser.

When you use a format in a JADE method, prefix your user time format name with a dollar sign ($); for example, userFormat($MyTime).

You can use the defineTimeFormat method of the TimeFormat class if you want to create your own transient format objects and define a time format that dynamically overrides the format for the locale at run time. (For details, see Chapter 1 of the JADE Encyclopaedia of Classes.)

If you do not define the EnhancedLocaleSupport parameter in the [JadeEnvironment] section of the JADE initialization file on the database node or you set it to false, inconsistent results could be returned to the application server when running in JADE thin client mode and there are locale overrides, as all overrides on the application server are suppressed if enhanced locale support is not enabled. Formatting of locale data is done on the application server, based on the locale of the corresponding presentation client.

The code fragments in the following examples show the use of the userFormat method.

tblTime.text := p.name & " (" &
                p.startTime.userFormat($HourMin) & "-" &
                p.endTime.userFormat($HourMin) & " )";
if counter > 0 then
    igfFrame.myOutline.IGOutline.addXLabel(time.userFormat
             ($PlainTime));
endif;