STR (Transact-SQL)
Возвращает символьные данные, преобразованные из числовых данных.
.gif "Значок ссылки на раздел")
Синтаксис
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) усекает результирующий набор до **. Строковые функции могут быть вложенными.
.gif "Примечание") Примечание |
|---|
Чтобы преобразовать данные в кодировку Юникод, используйте функцию 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)