STR (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

Devolve dados de caracteres convertidos a partir de dados numéricos. Os dados dos caracteres são justificados à direita, com um comprimento e precisão decimal especificados.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

float_expression
É uma expressão de tipo de dado numérico aproximado (float) com ponto decimal.

length
É o comprimento total. Isto inclui ponto decimal, signo, dígitos e espaços. O padrão é 10.

decimal
É o número de lugares à direita da vírgula decimal. O decimal deve ser menor ou igual a 16. Se o decimal for superior a 16, o resultado é truncado para dezasseis lugares à direita do ponto decimal.

Tipos de devolução

Varchar

Observações

Se fornecida, os valores para comprimento e parâmetros decimais para STR devem ser positivos. O número é arredondado para um inteiro por defeito ou se o parâmetro decimal for 0. O comprimento especificado deve ser maior ou igual à parte do número anterior ao ponto decimal mais o sinal do número (se existir). Um float_expression curto é justificado à direita no comprimento especificado, e um float_expression longo é truncado ao número especificado de casas decimais. Por exemplo, STR(12, 10) produz o resultado de 12. Isto é justificado à direita no conjunto de resultados. No entanto, STR(1223, 2) trunca o conjunto de resultados para **. As funções de cadeia podem ser aninhadas.

Observação

Para converter para dados Unicode, use STR dentro de uma função de conversão CONVERT ou CAST .

Examples

O exemplo seguinte converte uma expressão composta por cinco dígitos e um ponto decimal numa cadeia de caracteres de seis posições. A parte fracionária do número é arredondada para uma casa decimal.

SELECT STR(123.45, 6, 1);  
GO  

Aqui está o conjunto de resultados.

------  
 123.5  
  
(1 row(s) affected)  

Quando a expressão excede o comprimento especificado, a cadeia retorna ** para o comprimento especificado.

SELECT STR(123.45, 2, 2);  
GO  

Aqui está o conjunto de resultados.

--  
**  
  
(1 row(s) affected)  

Mesmo quando os dados numéricos estão aninhados dentro STRde , o resultado são dados de caracteres com o formato especificado.

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

Aqui está o conjunto de resultados.

--------  
 123.000  
  
(1 row(s) affected)  

Ver também

CAST e CONVERT (Transact-SQL)
FORMATO (Transact-SQL)
Funções de cadeia de caracteres (Transact-SQL)