STR (Transact-SQL)

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Управляемый экземпляр SQL Azure Конечная точка аналитики аналитики Synapse Analytics Analytics (PDW)SQL Analyticsв Microsoft FabricХранилище в Microsoft Fabric

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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

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

десятичное
Количество знаков справа от десятичной запятой. Значение 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)

См. также

CAST и CONVERT (Transact-SQL)
FORMAT (Transact-SQL)
Строковые функции (Transact-SQL)