named_value_format

Nutzung

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
}

Hierarchie Modelldatei named_value_format

Standardwert Keine Akzeptiert Ein Name für das benutzerdefinierte Format sowie ein Formatierungsstring im Excel-Stil, der das Format definiert, und ein boolescher Wert für den optionalen Unterparameter strict_value_format

Definition

Mit dem Parameter named_value_format können Sie ein benutzerdefiniertes Format erstellen und speichern, das auf mehrere Dimensionen und Messwerte angewendet werden kann.

Benutzerdefinierte Formate in Looker werden in mehreren Schritten erstellt und verwendet:

1. Zuerst deklarieren Sie mit named_value_format in der Modelldatei einen Namen für das neue benutzerdefinierte Format. Dieser Name muss ein String ohne Leerzeichen sein.
2. Als Nächstes definieren Sie mit dem value_format Unterparameter unter named_value_format die gewünschte Formatierung, indem Sie einen Formatierungsstring im Excel-Stil angeben.
3. Wenden Sie dieses benutzerdefinierte Format schließlich auf Dimensionen und Messwerte an, indem Sie auf Feldebene im value_format_name Parameter darauf verweisen.

Sie können in einem Modell mehrere benutzerdefinierte Formate definieren, wie in den folgenden Beispielen gezeigt.

Häufige Formatierungsstrings für value_format

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

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

Im Folgenden sind einige der häufigsten 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)
                              #   Please 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)
                              #   Please note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Please 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%)

strict_value_format überschreibt das Nutzerattribut number_format

In der Regel wird die im Nutzerattribut number_format festgelegte Zahlenformatierung auf das mit named_value_format erstellte Format angewendet. Wenn Sie den optionalen strict_number_format Unterparameter auf yes setzen, wird die Formatierung aus number_format jedoch nicht angewendet und die Felder behalten die Formatierung aus named_value_format bei. Ein Beispiel und weitere Informationen finden Sie auf der Dokumentationsseite Zahlenformatierung lokalisieren.

Standardformatierungsoptionen

Wenn Sie eines der integrierten Werteformate 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.

Beispiele

Benutzerdefiniertes Format namens euro_in_thousands erstellen, das so aussieht: 1,23 € Tsd.

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
}

Verhindern, dass das Nutzerattribut number_formatting das Format euro_in_thousands beeinflusst:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
  strict_value_format: yes
}

Ein weiteres Beispiel finden Sie auf der Dokumentationsseite Zahlenformatierung lokalisieren.

Benutzerdefiniertes Format namens usd_in_millions erstellen, das so aussieht: 1,23 Mio.$ , und ein Format namens phone_number, das so aussieht: [phone]

named_value_format: usd_in_millions {
  value_format: "$0.000,,\" M\""
}
named_value_format: phone_number {
  value_format: "(###) ###-####"
}