value_format

Nutzung

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

Akzeptiert
Ein String mit Formatierung im Excel-Stil

Definition

Mit dem value_format Parameter können Sie Datenwerte in Looker mit Formaten im Excel-Stil formatieren. Sie können value_format auf folgende Arten verwenden:

  • Eigenständig auf Feldebene, um die Formatierung im Excel-Stil direkt auf eine bestimmte Dimension oder Messung 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 Messungen anwenden

Der Parameter value_format kann sowohl für Dimensionen als auch für Messungen verwendet werden. Wenn Sie die Formatierung im Excel-Stil über value_format auf Dimensionen anwenden möchten, muss der Dimensionstyp number sein. Wenn Sie die Formatierung im Excel-Stil über value_format auf Messungen anwenden möchten, muss die Messung numerisch sein und darf nicht vom Typ 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)"
}

value_format verwenden, um ein wiederverwendbares benutzerdefiniertes Format zu definieren

Informationen zur Verwendung von value_format mit named_value_format zum Definieren wiederverwendbarer Formate finden Sie auf der Dokumentationsseite des Parameters named_value_format.

Standardformatierungsoptionen

Wenn Sie eines der integrierten Wertformate von Looker anwenden möchten, können Sie aus den Formaten auswählen, die im Abschnitt Standardformatnamen auf der Dokumentationsseite des Parameters value_format_name aufgeführt sind. Auf dieser Seite finden Sie eine Anleitung zur Verwendung von value_format_name zum Anwenden integrierter Formate.

Häufige Formatierungsstrings

value_format akzeptiert einen Formatierungsstring im Excel-Stil.

Die mit dem value_format Parameter verwendete Formatierung entspricht der Formatierung, die im Werteformat Feld in Visualisierungen verwendet wird. Der value_format Parameter erfordert jedoch, dass der Formatierungsstring in doppelten Anführungszeichen steht. Informationen zu Werteformaten in Visualisierungen finden Sie auf der Dokumentationsseite Optionen für Säulendiagramme.

Den vollständigen Excel-Leitfaden zum Festlegen dieser Formate finden Sie in der jeweiligen Dokumentation. Zu diesem Zeitpunkt werden jedoch die Datumsformatierung, Farbformatierung und hexadezimale Konvertierung in Looker nicht unterstützt.

Hier sind einige der häufigsten Formatierungsoptionen aufgeführt. Beachten Sie, dass einige Sonderzeichen wie internationale Währungssymbole in doppelten Anführungszeichen stehen müssen.

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 value_format Parameter finden Sie auf der Bedingte Formatierung mit value_format Best Practices-Seite.

Häufige Herausforderungen

Verlust von Dezimalstellen beim Teilen

Eine häufige SQL-Besonderheit, die bei der Verwendung von value_format auftritt, ist die Art und Weise, wie SQL mit ganzzahligen Berechnungen umgeht. Wenn Sie 5 durch 2 teilen, erwarten die meisten Nutzer ein Ergebnis von 2,5. Viele SQL-Dialekte geben jedoch nur 2 zurück, da sie bei der Division von zwei ganzen Zahlen auch das Ergebnis als ganze Zahl angeben. Um dieses Problem zu beheben, können Sie den Zähler mit einer Dezimalzahl (z.B.1,0 oder 100,0) multiplizieren, um SQL zu zwingen, ein Dezimalergebnis zurückzugeben. 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 verwenden, um Felder in Ihren Modellen zu formatieren, wird das im Nutzerattribut number_format ausgewählte Zahlenformat zusätzlich zu dem mit value_format angewendeten Format angewendet. Ein Beispiel und weitere Informationen finden Sie auf der Dokumentationsseite Zahlenformatierung lokalisieren.