benanntes_Wertformat

Nutzung

Name_Wert_Format: desired_name {
Wertformat: „Excel-Formatierungsstring“
strict_value_format: Ja | Nein
}

Hierarchie Modelldatei named_value_format

Standardwert Keine Akzeptiert Ein Name für Ihr benutzerdefiniertes Format und ein Formatstring im Excel-Stil, der das Format und einen booleschen Wert für den optionalen Unterparameter strict_value_format definiert

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. Verwenden Sie zuerst named_value_format in der Modelldatei, um einen Namen für das neue benutzerdefinierte Format zu deklarieren. Dieser Name muss ein String ohne Leerzeichen sein.
2. Als Nächstes definieren Sie die gewünschte Formatierung mit dem Unterparameter value_format unter named_value_format. Geben Sie dazu einen Excel-Formatstring an.
3. Wenden Sie abschließend dieses benutzerdefinierte Format auf Dimensionen und Messwerte an, indem Sie es im Feld value_format_name auf Feldebene referenzieren.

Sie können in einem Modell mehr als ein benutzerdefiniertes Format definieren, wie in den Beispielen unten gezeigt.

Häufig verwendete value_format-Formatierungsstrings

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.

Nachfolgend sind einige der gängigsten Formatierungsoptionen aufgeführt. Einige Sonderzeichen, z. B. 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 number_format-Nutzerattribut festgelegte Zahlenformatierung auf das mit named_value_format erstellte Format angewendet. Wenn Sie jedoch den optionalen Unterparameter strict_number_format auf yes setzen, wird die Formatierung von number_format nicht angewendet und die Felder von named_value_format bleiben erhalten. Ein Beispiel und weitere Informationen finden Sie auf der Dokumentationsseite zur Lokalisierung der Zahlenformatierung.

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 eine Auswahl treffen. Auf dieser Seite wird beschrieben, wie Sie mit value_format_name integrierte Formate anwenden.

Beispiele

Erstellen Sie ein benutzerdefiniertes Format mit dem Namen euro_in_thousands 1,23 €:

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

Verhindern Sie, 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 zur Lokalisierung der Zahlenformatierung.

Erstellen Sie ein benutzerdefiniertes Format mit dem Namen 1,23 Mio.$ und ein Format mit dem Namen phone_number und dem Format [phone]:

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