named_value_format

Nutzung

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

Hierarchie Model File 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 Ihrer Modelldatei einen Namen für das neue benutzerdefinierte Format. Dieser Name muss ein String ohne Leerzeichen sein.
2. Als Nächstes verwenden Sie den Unterparameter value_format unter named_value_format, um die gewünschte Formatierung mit einem Formatierungsstring im Excel-Stil zu definieren.
3. Wenden Sie dieses benutzerdefinierte Format schließlich auf Dimensionen und Messwerte an, indem Sie auf Feldebene im Parameter value_format_name darauf verweisen.

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

Häufig verwendete value_format-Formatierungsstrings

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)
                              #   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

Normalerweise wird die im Nutzerattribut number_format festgelegte Zahlenformatierung auf das mit named_value_format erstellte Format angewendet. Wenn Sie den optionalen Unterparameter strict_number_format 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 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.

Beispiele

Erstellen Sie ein benutzerdefiniertes Format mit dem Namen euro_in_thousands, das so aussieht: €1.23K:

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

Verhindern, dass sich das Nutzerattribut number_formatting auf das Format euro_in_thousands auswirkt:

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

Ein weiteres Beispiel finden Sie auch auf der Dokumentationsseite Lokalisierung von Zahlenformaten.

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

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