Difference between revisions of "SsParseNum"

Revision as of 11:47, 17 December 2020

This feature uses JavaScript syntax

Overview

To convert a number from a formatted string (containing symbols like "$" or "%") to a number using JavaScript you can use a function called ssParseNum.

Syntax

ssParseNum( value, emptyok );

Where:

Examples

ssParseNum($5,000.50);

Will return: 5000.5

If you wish to display a ratio of two fields that are set to have currency formatting, you should convert the values to numbers using ssParseNum:

ssParseNum([field1])/ssParseNum([field2])

Requirements

This function is part of the sstools.js library and needs to be added to Browser Script custom fields or on template pages, sign-up pages etc. using the following syntax:

<SCRIPT type="text/javascript" language="javascript" src="/sstools.js"></SCRIPT>

When Using "Show Currency Format in Edit Mode"

When using the "Show Currency Format in Edit Mode" setting for custom fields, the following syntax must be used:

ssParseNumFromCurrency(value,getLocalestrByCurrency(code),1,emptyok); (getLocalestrByCurrency will get the "default" locale of the currency code, e.g. CAD will result in en-CA, NOT fr-CA)

OR

ssParseNumFromCurrency(value,locale,1,emptyok); (if you know the locale of the formatted currency, e.g. da-DK or fr-FR or fr-CA etc)

Where:

Example:

ssParseNumFromCurrency([YER Total revenue],getLocalestrByCurrency("CAD"),1,true) - ssParseNumFromCurrency([YER Total expenses],getLocalestrByCurrency("CAD"),1,true)

or

ssParseNumFromCurrency([YER Total revenue],"fr-CA",1,true) - ssParseNumFromCurrency([YER Total expenses],"fr-CA",1,true)  

See Also

• Custom Field Type: Special – Calculated Value
• SsFormatCurrency