userCurrencyFormat

userCurrencyFormat(fmt: CurrencyFormat): String;

The userCurrencyFormat method of the Decimal primitive type returns a string containing the receiver in the currency format specified in the fmt parameter.

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

The code fragment in the following example shows the use of the userCurrencyFormat method.

lblBank.caption  := app.crntInvestor.cash.userCurrencyFormat($DollarsCents);
lblWorth.caption := (totalWorth).userCurrencyFormat($DollarsCents);

When you use a format in a JADE method, prefix your user currency format name with a dollar sign ($); for example, userCurrencyFormat($MyCurrency).

You can use the defineCurrencyFormat method of the CurrencyFormat class if you want to create your own transient format objects and define a currency 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.