STR (Transact-SQL)

Синтаксис

STR (float_expression [ , length [ ,decimal ] ] )

Аргументы

• float_expression
  Выражение приближенного числового (float) типа данных с десятичной запятой.

• length
  Общая длина. Она включает десятичную запятую, знак, цифры и пробелы. Значение по умолчанию 10.

• decimal
  Количество знаков справа от десятичной запятой. Аргумент decimal должен быть меньше или равен 16. Если значение decimal больше 16, то результат усекается до шестнадцати знаков после запятой.

Типы возвращаемых данных

varchar

Замечания

Если указано, то значения для параметров length и decimal в функции STR должны быть положительными. Число округляется до целого или по умолчанию, или если десятичный параметр равен 0. Указанная длина должна быть больше или равна части числа до запятой плюс знак числа (если имеется). Короткое выражение float_expression выравнивается справа до указанной длины, а длинное float_expression усекается до заданного количества цифр после запятой. Например, значением выражения STR(12**,10) будет 12. Выравнивается в результирующем наборе вправо. Однако STR(1223,**2) усекает результирующий набор до **. Строковые функции могут быть вложенными.

Примечание
Чтобы преобразовать данные в кодировку Юникод, используйте функцию STR внутри функций преобразования CONVERT или CAST.

Примеры

В следующем примере выражение, состоящее из пяти знаков и десятичной запятой, преобразуется в шестизначную символьную строку. Дробная часть числа округляется до одного десятичного знака.

SELECT STR(123.45, 6, 1);
GO

Ниже приводится результирующий набор.

------
 123.5

(1 row(s) affected)

Когда выражение превышает заданную длину, строка возвращает ** для указанной длины.

SELECT STR(123.45, 2, 2);
GO

Ниже приводится результирующий набор.

--

(1 row(s) affected)

Даже когда в STR вложены числовые данные, результатом являются символьные данные с указанным форматом.

SELECT STR (FLOOR (123.45), 8, 3;)
GO

Ниже приводится результирующий набор.

--------
 123.000

(1 row(s) affected)

См. также

Справочник