Nutzung
Dimension: Feldname {
value_format:"$#.00;($#.00)"
}
}
Hierarchie
value_format |
Mögliche Feldtypen
Dimension, messenAkzeptiert
Ein String mit der Formatierung im Excel-Format |
Definition
Mit dem Parameter value_format
können Sie Datenwerte in Looker mithilfe von Excel-Formaten formatieren. Sie können value_format
auf folgende Weise verwenden:
- Allein und auf Feldebene, um die Excel-Stilformatierung direkt auf eine bestimmte Dimension oder einen bestimmten Messwert anzuwenden
- Als Unterparameter des Parameters
named_value_format
auf Modellebene, um ein wiederverwendbares benutzerdefiniertes Format zu erstellen, das auf mehrere Felder angewendet werden kann
value_format
direkt auf Dimensionen und Messwerte anwenden
Der Parameter value_format
kann sowohl für Dimensionen als auch für Messungen verwendet werden. Wenn Sie die Excel-Formatierung über value_format
auf Dimensionen anwenden möchten, muss der Dimensionstyp number
sein. Wenn Sie die Excel-Formatierung über value_format
auf Messwerte anwenden möchten, muss diese numerisch und nicht type: string
sein. Beispiel:
dimension: order_amount {
type: number
sql: ${TABLE}.order_amount ;;
value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
type: sum
sql: ${order_amount} ;;
value_format: "$#.00;($#.00)"
}
Mit value_format
ein wiederverwendbares benutzerdefiniertes Format definieren
Informationen dazu, wie Sie value_format
mit named_value_format
verwenden, um wiederverwendbare Formate zu definieren, finden Sie auf der Dokumentationsseite zum Parameter named_value_format
.
Standardformatierungsoptionen
Wenn Sie eines der integrierten Werteformate von Looker anwenden möchten, können Sie auf der Dokumentationsseite des value_format_name
-Parameters im Abschnitt Standardformatnamen eines der Formate auswählen. Auf dieser Seite wird beschrieben, wie Sie mit value_format_name
integrierte Formate anwenden.
Gängige Formatierungsstrings
value_format
akzeptiert einen Formatstring im Excel-Stil.
Die mit dem Parameter
value_format
verwendete Formatierung entspricht der Formatierung im Feld Wertformat in Visualisierungen. Der einzige Unterschied ist, dass der Parametervalue_format
den Formatierungsstring in doppelte Anführungszeichen setzen muss. Informationen zu den Wertformaten in Visualisierungen finden Sie auf der Dokumentationsseite zu Spaltendiagrammoptionen.
Eine ausführliche Anleitung zur Angabe dieser Formate finden Sie in der Excel-Dokumentation. Zu diesem Zeitpunkt werden jedoch die Datumsformatierung, Farbformatierung und hexadezimale Konvertierung in Looker nicht unterstützt.
Hier sind einige der gängigsten Formatierungsoptionen aufgeführt. Einige Sonderzeichen wie internationale Währungssymbole müssen in doppelte Anführungszeichen gesetzt werden.
value_format: "0" # Integer (123)
value_format: "*00#" # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
# Note \"String\" can be replaced with any other word
value_format: "0.##" # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00" # Number with exactly 2 decimals (1.23)
value_format: "*00#.00" # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0" # Number with comma between thousands (1,234)
value_format: "#,##0.00" # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
# Note division by 1 million happens automatically
value_format: "0.000,\" K\"" # Number in thousands with 3 decimals (1.234 K)
# Note division by 1 thousand happens automatically
value_format: "$0" # Dollars with 0 decimals ($123)
value_format: "$0.00" # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0" # Euros with 0 decimals (€123)
value_format: "$#,##0.00" # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
# normally, negative values wrapped in parenthesis
value_format: "0\%" # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%" # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%" # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%" # Convert to percent with 2 decimals (.01 becomes 1.00%)
Ein Beispiel für eine erweiterte bedingte Formatierung mit dem Parameter value_format
finden Sie im Hilfeartikel Bedingte Formatierung mit value_format
.
Häufige Herausforderungen
Dezimaltrennzeichen beim Trennen
Eine häufige SQL-Skurralität, die bei Verwendung von value_format
auftritt, ist die Art und Weise, wie SQL Ganzzahlen verarbeitet. Wenn man 5 durch 2 teilt, erwartet man, dass das Ergebnis 2,5 ist. Bei vielen SQL-Dialekten wird das Ergebnis jedoch nur als 2 zurückgegeben, da bei der Teilung zweier Ganzzahlen das Ergebnis als Ganzzahl zurückgegeben wird. Um das zu erreichen, können Sie den Zähler mit einer Dezimalzahl (z.B.1,0 oder 100,0) multiplizieren, um zu erzwingen, dass SQL ein Dezimalergebnis zurückgibt. Beispiel:
measure: active_users_percent {
type: number
sql: 100.000 * ${active_users} / ${users} ;;
value_format: "0.000"
}
value_format
mit dem Nutzerattribut number_format
verwenden
Wenn Sie value_format
zum Formatieren von Feldern in Ihren Modellen verwenden, wird das im Nutzerattribut number_format
ausgewählte Zahlenformat über das mit value_format
angewendete Format angewendet. Ein Beispiel und weitere Informationen finden Sie auf der Dokumentationsseite zur Lokalisierung der Zahlenformatierung.