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 :: NullWhenNumeric
Returns null when the number equals compareToValue, otherwise returns the number.
SQL :: Pow
Returns x raised to the power of y.
SQL :: Right
Returns the given number of characters from the end of the value.
SQL :: Round
Rounds a number to the given number of decimal places. Midpoint values are rounded to the nearest even number (2.5 rounds to 2).
SQL :: Scalar Functions
Scalar functions are evaluated once per row.
SQL :: Sha1
Returns the SHA-1 hash of the value's UTF-8 bytes as a lower case hex string.
SQL :: Sha256
Returns the SHA-256 hash of the value's UTF-8 bytes as a lower case hex string.
SQL :: Sha512
Returns the SHA-512 hash of the value's UTF-8 bytes as a lower case hex string.
SQL :: ShowScalarFunctions
Lists the built-in scalar functions with their parameters and descriptions.
SQL :: SubString
Returns length characters of the value, starting at the zero-based startIndex.