FormatNumeric

Table of Contents



Formats a number using a .NET numeric format string and returns the result as text.

String FormatNumeric(Numeric value, String format = 'N')

Format Description Example (1234.567)
C Currency $1,234.57
E Exponential (scientific) 1.23e+003 (E2)
F Fixed-point 1234.57 (F2)
G General 1234.567
N Number with thousands separators 1,234.57
P Percent 25.6% for 0.256 (P1)


Character Description Example (1234.567)
0 Zero placeholder 00000.0 → 01234.6
# Digit placeholder #.## → 1234.57
. Decimal point 0.00 → 1234.57
, Thousands separator #,{Function (0) does not have a defined descriptor.} → 1,235
% Percentage 0% → 123457%

Integer-only formats

Numbers are evaluated as decimals, so the integer-only formats D and X are rejected with "Format specifier was invalid".


round-pushpin Formats a value in several ways.
SELECT
    FormatNumeric(1234.567) as Default,
    FormatNumeric(1234.567, 'C') as Currency,
    FormatNumeric(1234.567, 'F2') as Fixed,
    FormatNumeric(1234.567, 'N1') as Number,
    FormatNumeric(0.256, 'P1') as Percent,
    FormatNumeric(1234.567, '#,##0.0') as Custom
FROM
    Single




SQL :: Expressions
Literals, operators, comments and variables in KBSQL.
SQL :: Floor
Returns the largest whole number that is less than or equal to the given number.
SQL :: FormatDateTime
Parses a date/time value and returns it formatted with a .NET date/time format string. See DateTime for the format specifiers.
SQL :: Guid
Returns a new random globally unique identifier.
SQL :: IfNull
Returns the given value, or the default value when the given value is null.
SQL :: IfNullNumeric
Returns the given number, or the default number when the given value is null.
SQL :: IIF
Short for "immediate if": returns whenTrue when the condition is true and whenFalse otherwise. The condition is usually one of the boolean functions such as IsEqual or IsGreater.
SQL :: IndexOf
Returns the zero-based position of the first occurrence of textToFind in textToSearch, starting the search at offset. Returns -1 when it is not found.
SQL :: IsBetween
Returns true (1) if the value is within the given range, including the range boundaries.
SQL :: IsDouble
Returns true (1) if the given value can be converted to a decimal number.