Difference between revisions of "Numbers and text"

(Created page with "Category:Analytica User Guide <languages /> <translate> Analytica User Guide > Using Expressions > Numbers and text ==See Also== {| style="margin: 1em auto 1e...")
 
Line 3: Line 3:
 
<translate>
 
<translate>
 
[[Analytica User Guide]] > [[Using Expressions]] > [[Numbers and text]]
 
[[Analytica User Guide]] > [[Using Expressions]] > [[Numbers and text]]
 +
 +
'''Converting number to text''': If you apply the '''& '''operator or '''JoinText() '''to numbers, they convert the numbers to text values, using the number format specified for the variable or function in whose definition they appear. You can use this effect to convert (“coerce”) numbers into text values, for example:
 +
:<code>123456789 & '' &rarr; '123.5M'</code>
 +
:<code>123456789 & '' &rarr; '$123,456,789.00'</code>
 +
:<code>'The date is: ' & 38345 &rarr; The date is: Thursday, December 25, 2008'</code>
 +
 +
<tip title="Tip">The actual result depends on ''Number Format ''setting for the variable or function in whose definition the expression appears. The first example assumes the default ''Suffix ''format. The second assumes ''Fixed Point ''format, with currency and thousands separators checked, and two decimal digits. The third assumes the ''Long Date ''format. Use the '''Number format '''dialog on the '''Result '''menu to set the formats.</tip>
 +
 +
You can also control the format used when converting numbers to text with the [[Text functions|NumberToText]] function.
 +
 +
'''Converting text to number''': You can use the '''Evaluate() '''function to convert a text representation of a number into an actual number, for example:
 +
:<code>Evaluate('12350') &rarr; 12.35K</code>
 +
 +
Evaluate() can convert any number format that Analytica can handle in an expression— and no others. Thus, it can handle decimals, exponent format, dates, <code>True</code> or <code>False</code>, a <code>$</code> at the start of a number (which it ignores), and letter suffixes, like <code>K</code> and <code>M</code>.
 +
 +
An alternative method, for converting text to a number is to use the '''Coerce Number '''qualifier on a user-defined function. For example, you could define a user-defined function such as:
 +
:<code>ParseNum(X: Coerce Number) := X</code>
  
 
==See Also==
 
==See Also==
 
{| style="margin: 1em auto 1em auto;width: 100%;border:0;table-layout: fixed;" cellpadding=5
 
{| style="margin: 1em auto 1em auto;width: 100%;border:0;table-layout: fixed;" cellpadding=5
 
|- style="text-align: center"
 
|- style="text-align: center"
| [[Math functions]] <- || [[Numbers and text]] || -> [[Installation and licenses]]
+
| [[Math functions]] <- || [[Numbers and text]] || -> [[Exception values INF, NAN, and NULL]]
 
|}
 
|}
 
</translate>
 
</translate>

Revision as of 14:31, 7 September 2015


Analytica User Guide > Using Expressions > Numbers and text

Converting number to text: If you apply the & operator or JoinText() to numbers, they convert the numbers to text values, using the number format specified for the variable or function in whose definition they appear. You can use this effect to convert (“coerce”) numbers into text values, for example:

123456789 & → '123.5M'
123456789 & → '$123,456,789.00'
'The date is: ' & 38345 → The date is: Thursday, December 25, 2008'
Tip
The actual result depends on Number Format setting for the variable or function in whose definition the expression appears. The first example assumes the default Suffix format. The second assumes Fixed Point format, with currency and thousands separators checked, and two decimal digits. The third assumes the Long Date format. Use the Number format dialog on the Result menu to set the formats.

You can also control the format used when converting numbers to text with the NumberToText function.

Converting text to number: You can use the Evaluate() function to convert a text representation of a number into an actual number, for example:

Evaluate('12350') → 12.35K

Evaluate() can convert any number format that Analytica can handle in an expression— and no others. Thus, it can handle decimals, exponent format, dates, True or False, a $ at the start of a number (which it ignores), and letter suffixes, like K and M.

An alternative method, for converting text to a number is to use the Coerce Number qualifier on a user-defined function. For example, you could define a user-defined function such as:

ParseNum(X: Coerce Number) := X

See Also

Math functions <- Numbers and text -> Exception values INF, NAN, and NULL
Comments


You are not allowed to post comments.