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




Home
The home page
SQL :: Abs
Returns the absolute value of a number.
SQL :: Ceil
Returns the smallest whole number that is greater than or equal to the given number.
SQL :: Checksum
Returns a simple 16-bit checksum (0 to 65535) of the value's ASCII bytes. It is fast but not collision resistant; use Sha256 when the value must be unique.
SQL :: Coalesce
Returns the first of the given values that is not null. Accepts any number of values.
SQL :: Concat
Concatenates all of the given values that are not null. Accepts any number of values. The + operator can also be used to concatenate, but a null on either side of + makes the whole result null.
SQL :: DateAdd
Adds offset intervals to a date/time value and returns the new date/time. Use a negative offset to subtract. Interval names are not case-sensitive.
SQL :: DateDiff
Returns the number of intervals between two date/time values (date2 minus date1). See DateAdd for the interval names.
SQL :: DateTime
Returns the server's current local date and time, formatted with the optional .NET date/time format string.
SQL :: DateTimeUTC
Returns the current UTC date and time, formatted with the optional .NET date/time format string. See DateTime for the format specifiers.