SQL Academy
Premium
Funktionsreferenz

FORMAT

Baut einen String aus einer Vorlage und setzt Werte an die Stellen von %s, %I und %L.

PostgreSQL 17.5
FORMAT(format_string[, value, ...])

Parameter

format_stringtext
Vorlage: %s für einen Wert als Text, %I für einen Namen in doppelten Anführungszeichen, %L für einen Wert in einfachen Anführungszeichen, %% für ein Prozentzeichen
valueoptional
Einzusetzende Werte, der Reihe nach

Rückgabewert

String (text)

Beispiele

Werte in eine Vorlage einsetzen

PostgreSQL 17.5
SELECT FORMAT('Hello, %s! You have %s new messages', 'Ann', 5) AS greeting;
greeting
Hello, Ann! You have 5 new messages

Name mit Status und Ausrichtung

PostgreSQL 17.5
SELECT FORMAT('%s (%s)', member_name, status) AS member,
	FORMAT('%-10s|', status) AS padded
FROM FamilyMembers;
memberpadded
Headley Quincey (father)father |
Flavia Quincey (mother)mother |
Andie Quincey (son)son |
Lela Quincey (daughter)daughter |
Annie Quincey (daughter)daughter |
Ernest Forrest (father)father |
Constance Forrest (mother)mother |
Wednesday Addams (daughter)daughter |

NULL, ein String in Anführungszeichen und ein Name

PostgreSQL 17.5
SELECT FORMAT('%s and %s', 'a', NULL) AS with_null,
	FORMAT('%L', 'O''Neil') AS literal,
	FORMAT('%I', 'Order items') AS identifier;
with_nullliteralidentifier
a and 'O''Neil'"Order items"

Details

%s setzt NULL als leeren String ein, %L als Wort NULL. Die Breite gibst du mit einer Zahl nach % an: %-10s füllt den Wert rechts mit Leerzeichen auf 10 Zeichen auf.

In MySQL macht die Funktion FORMAT etwas anderes: Sie formatiert eine Zahl mit Tausendertrennzeichen.

Siehe auch