Wertformat

Nutzung

view: view_name {
Dimension: Feldname {
value_format:"$#.00;($#.00)"
}
}
Hierarchie
view
Feldtyp
value_format
Mögliche Feldtypen
Dimension, messen

Akzeptiert
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 Parameter value_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.