value_format

Nutzung

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

Akzeptiert
Ein String mit Formatierung im Excel-Stil

Definition

Mit dem Parameter value_format können Sie Datenwerte in Looker mit Excel-ähnlichen Formaten formatieren. Sie haben die folgenden Möglichkeiten, value_format zu verwenden:

  • Auf Feldebene, um die Formatierung im Excel-Stil 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 Messwerte 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 der Messwert numerisch und 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 zum Definieren eines wiederverwendbaren benutzerdefinierten Formats verwenden

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

Standardformatierungsoptionen

Wenn Sie eines der integrierten Wertformate von Looker verwenden möchten, können Sie eines der Formate 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äufig verwendete Formatierungsstrings

value_format akzeptiert einen Formatierungsstring im Excel-Stil.

Die Formatierung, die mit dem Parameter value_format verwendet wird, entspricht der Formatierung im Feld Wertformat in Visualisierungen. Allerdings muss der Formatierungsstring für den Parameter value_format in doppelte Anführungszeichen eingeschlossen werden. Informationen zu Wertformaten in Visualisierungen finden Sie auf der Dokumentationsseite Optionen für Säulendiagramme.

Eine vollständige Anleitung zum Angeben dieser Formate finden Sie in der Excel-Dokumentation. Zu diesem Zeitpunkt werden jedoch die Datumsformatierung, Farbformatierung und hexadezimale Konvertierung in Looker nicht unterstützt.

Nachfolgend 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 die erweiterte bedingte Formatierung mit dem Parameter value_format finden Sie auf der Seite Best Practices für die bedingte Formatierung mit value_format.

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 Ganzzahlberechnungen umgeht. Wenn Sie 5 durch 2 teilen, erwarten die meisten Menschen das Ergebnis 2,5. In vielen SQL-Dialekten wird das Ergebnis jedoch als „2“ zurückgegeben, da bei der Division von zwei Ganzzahlen auch das Ergebnis als Ganzzahl angegeben wird. Um dieses Problem zu beheben, können Sie den Zähler mit einer Dezimalzahl (z.B.1,0 oder 100,0) multiplizieren, damit 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 zusätzlich zum mit value_format angewendeten Format angewendet. Ein Beispiel und weitere Informationen finden Sie auf der Dokumentationsseite Zahlenformatierung lokalisieren.