value_format_name

Nutzung

view: view_name {
  dimension: field_name {
    value_format_name: format_name
  }
}
Hierarchie
value_format_name
Mögliche Feldtypen
Dimension, Messwert

Akzeptiert
Eines der Standardwertformate, die auf dieser Dokumentationsseite aufgeführt sind, oder der Name eines Formats, das Sie mit dem Parameter named_value_format erstellt haben

Definition

Mit dem Parameter value_format_name können Sie Datenwerte mit in Looker integrierten Formaten oder mit Ihren eigenen benutzerdefinierten, wiederverwendbaren Formaten formatieren. Wenn Sie ein Excel-Format direkt auf ein eindeutiges Feld anwenden möchten, verwenden Sie stattdessen value_format.

Der Parameter value_format_name kann sowohl für Dimensionen als auch für Messwerte verwendet werden. Beispiel:

measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}

Standardformatnamen

Looker hat die Standardformate, die in den folgenden Tabellen aufgeführt sind. Wenn Sie eines der Standardformate verwenden, rundet Looker auf oder ab, um Ziffern zu entfernen, anstatt Werte abzuschneiden. Wenn für einen Messwert ein Standardformatname verwendet wird, erfolgt die Rundung nach der Aggregation des Messwerts.

Mit dem Parameter named_value_format können Sie auch eigene benannte Formate erstellen.

Numerische Formate

Die Standardformate für numerische Feldtypen sind in der folgenden Tabelle aufgeführt. Sie beginnen mit dem zugrunde liegenden Wert „1234.56789“:

Name Beispiel
decimal_0 1.235
decimal_1 1.234,6
decimal_2 1.234,57
decimal_3 1.234,568
decimal_4 1.234,5679
usd_0 1.235 $
usd 1.234,57 $
gbp_0 1.235 £
gbp 1.234,57 £
eur_0 1.235 €
eur 1.234,57 €
id 1235

Bei numerischen Feldtypen sollte id nur für Zahlen mit maximal 16 Ziffern verwendet werden. Bei mehr als 16 Ziffern kann id Ergebnisse runden. Bei Zahlen mit mehr als 16 Ziffern müssen Sie sie als String umwandeln und id für den String-Feldtyp verwenden.

Prozentuale Formate

Bei Prozentformaten wird der zugrunde liegende Dezimalwert mit 100 multipliziert, um einen Prozentsatz zu erhalten. Die folgenden Beispiele beginnen mit dem zugrunde liegenden Wert „0.123456“:

Name Beispiel
percent_0 12 %
percent_1 12,3%
percent_2 12,35%
percent_3 12,346%
percent_4 12,3456%

Wichtige Punkte

Damit value_format_name auf ein Feld angewendet werden kann, muss der Parameter type für dieses Feld definiert sein.

Häufige Herausforderungen

value_format_name mit dem Nutzerattribut number_format verwenden

Wenn Sie value_format_name verwenden, um Felder in Ihren Modellen zu formatieren, wird das im Nutzerattribut number_format ausgewählte Zahlenformat zusätzlich zum mit value_format_name angegebenen Format angewendet. Ein Beispiel und weitere Informationen finden Sie auf der Dokumentationsseite Zahlenformatierung lokalisieren.