Freigeben über


STR (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Analyseendpunkt in Microsoft FabricLagerhaus in Microsoft FabricSQL-Datenbank in Microsoft Fabric

Konvertiert numerische Daten in Zeichenfolgen. Die Zeichendaten sind rechtsbündig und weisen eine angegebene Länge und Dezimalgenauigkeit auf.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

float_expression

Ein Ausdruck des ungefähren numerischen Datentyps (Float) mit einem Dezimalkomma.

length

Die Gesamtlänge, einschließlich Dezimalkomma, Vorzeichen, Ziffern und Leerzeichen. Der Standardwert ist 10.

decimal

Die Anzahl der Stellen rechts neben dem Dezimalkomma. decimal muss kleiner als oder gleich 16 sein. Wenn das Dezimalzeichen mehr als 16 ist, wird das Ergebnis an 16 Stellen rechts neben dem Dezimalkomma abgeschnitten.

Rückgabetypen

varchar

Bemerkungen

Falls angegeben, sollten die Werte für die Parameter length und decimal der STR-Funktion positiv sein. Die Zahl wird standardmäßig, oder wenn der Dezimalstellenparameter 0 beträgt, auf eine ganze Zahl gerundet. Die angegebene Länge sollte größer oder gleich dem Teil der Zahl vor dem Dezimalpunkt plus dem Vorzeichen (falls vorhanden) sein. Ein kurzer float_expression-Ausdruck wird in der angegebenen Länge rechtsbündig ausgerichtet, während ein langer float_expression-Ausdruck auf die angegebene Anzahl der Dezimalstellen gekürzt wird. Beispielsweise ergibt STR(12, 10) den Wert 12. Dieser Wert wird im Resultset rechtsbündig ausgerichtet. Bei STR(1223, 2) wird das Resultset jedoch auf gekürzt. Zeichenfolgenfunktionen können geschachtelt werden.

Hinweis

Wenn Sie Daten in das Unicodeformat konvertieren wollen, verwenden Sie STR innerhalb einer CONVERT- oder CAST-Konvertierungsfunktion.

Beispiele

Im folgenden Beispiel wird ein Ausdruck, der aus fünf Ziffern und einem Dezimaltrennzeichen besteht, in eine Zeichenfolge mit sechs Stellen konvertiert. Die Stellen hinter dem Dezimalpunkt werden auf eine Dezimalstelle gerundet.

SELECT STR(123.45, 6, 1);  
GO  

Hier sehen Sie das Ergebnis.

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

Falls der Ausdruck die angegebene Länge überschreitet, wird die Zeichenfolge ** in der festgelegten Länge zurückgegeben.

SELECT STR(123.45, 2, 2);  
GO  

Hier sehen Sie das Ergebnis.

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

Auch wenn numerische Daten innerhalb von STR geschachtelt sind, werden als Ergebnis Zeichendaten mit dem angegebenen Format zurückgegeben.

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

Hier sehen Sie das Ergebnis.

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