formats

Beschreibung

Optional. Definiert die Liste der Zahlenformate

Verwendung

formats?: array;

Parameter

Die Eigenschaft formats ist ein Array von Zahlenformat-Objekten, von denen jedes einen Satz von Eigenschaften enthält:

• id - die ID eines Formats, das verwendet wird, um ein Format für eine Zelle mit der Methode setFormat() festzulegen
• mask - eine Maske für ein Zahlenformat
• name - der Name eines Formats, der in den Dropdown-Listen der Symbolleiste und des Menüs angezeigt wird
• example - ein Beispiel, das zeigt, wie eine formatierte Zahl aussieht. Die Zahl 2702.31 wird als Standardwert für Formatbeispiele verwendet

Standardkonfiguration

Die standardmäßigen Zahlenformate sind folgende:

defaultFormats = [
    { name: "Common", id: "common", mask: "", example: "1500.31" },
    { name: "Number", id: "number", mask: "#,##0.00", example: "1,500.31" },
    { name: "Percent", id: "percent", mask: "#,##0.00%", example: "1,500.31%" },
    { name: "Currency", id: "currency", mask: "$#,##0.00", example: "$1,500.31" },
    { name: "Date", id: "date", mask: "mm-dd-yy", example: "28/12/2021" },
    { 
        name: "Time",
           id: "time",
           mask: hh:mm:ss am/pm || hh:mm:ss, // depending on the timeFormat config
           example: "13:30:00"
    },
    { name: "Text", id: "text", mask: "@", example: "'1500.31'" }
];

Beispiel

const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
    formats: [
        {
            name: "U.S. Dollar",
            id: "currency",
            mask: "$#,##0.00"
        },
        {
            name: "Euro",
            id: "euro",
            mask: "[$€]#.##0,00",
            example: "1000.50"
        },
        {
            name: "Swiss franc",
            id: "franc",
            mask: "[$CHF ]#.##0,00"
        }
    ],
    // weitere Konfigurationsparameter
});

Changelog:

• Das Format "Time" wurde in v4.3 hinzugefügt
• Das Format "Date" wurde in v4.2 hinzugefügt
• Das Format "Text" wurde in v4.0 hinzugefügt

Verwandte Artikel:

• Zahlenformatierung
• Formatanpassung