Need a special offer?Find out if your project fits.
+
All documentation
API reference
  • API Reference for older versions
  • setFormat

    setFormat(format: FormatObject, measureName: String, aggregation: String)

    [starting from version: 1.4]

    Sets the default number format or a number format for the specified measure.

    Learn more about number formatting.

    Use the refresh() API call after setting a format to redraw the component and see changes.

    Parameters

    Parameter/Type Description
    format
    FormatObject
    Contains the number format parameters.
    To override the default number format, set the format.name property to an empty string ("").
    measureName
    String
    optional The measure's unique name. Specify this property to apply a format to a specific measure.
    Must be used with the aggregation parameter unless the measure is calculated.
    When overriding the default format, skip the measureName.
    aggregation
    String
    optional The measure’s aggregation. Must be used with the measureName.
    If the measure is calculated, skip the aggregation.

    Examples

    1) How to override a default number format at runtime:

    let format = {
      name: "",
      decimalPlaces: 0,
      thousandsSeparator: ","
    };
    flexmonster.setFormat(format);
    flexmonster.refresh();

    Try how the sample works on JSFiddle.

    2) How to change a currency symbol for a specific measure:

    let format = flexmonster.getFormat("Price", "sum");
    format.name = "PriceFormat";
    format.currencySymbol = "$";
    //format.currencySymbol = "£" // pound sterling
    //format.currencySymbol = "€" // euro
    //format.currencySymbol = "¥" // yen
    flexmonster.setFormat(format, "Price", "sum");
    flexmonster.refresh();

    Open the example on JSFiddle.

    See also

    getFormat
    FormatObject
    refresh
    Number formatting tutorial