JavaScript ArcGIS intl.substitute用法及代码示例

基本信息

以下是所在类或对象的基本信息。

AMD: require(["esri/intl"], (intl) => { /* code goes here */ });

ESM: import * as intl from "@arcgis/core/intl";

对象： esri/intl

自从：用于 JavaScript 4.12 的 ArcGIS API

用法说明

intl.substitute函数(或属性)的定义如下：

substitute (template, data, options) {String}

使用它来用参数 data 中的值替换 template 字符串中的键。 null 或 undefined 值不会打印在输出结果中。

可以指定来自data 的值的格式。默认情况下，这些值将根据其原生 JavaScript 类型进行格式化。

在内部 substitute 为当前语言环境创建 Intl formatter 实例。格式化程序使用options 作为缓存键进行缓存。重复使用相同的 options 对象以获得最佳性能。

参数：

类型	说明
template String	用于替换的模板字符串。
data Object	要替换的数据对象。
options intl.SubstituteOptions	可选的用于确定如何替换模板字符串中的键的选项。

类型	说明
String	格式化的字符串。

例子：

// Format a date
const data = {
  increasedValue: 500,
  time: Date.UTC(2019),
}

const dateFormatOptions = intl.convertDateFormatToIntlOptions("short-date-short-time-24");

intl.substitute("Date: {time}", data, {
  format: {
    time: {
      type: "date",
      intlOptions: dateFormatOptions
    }
  }
});

// Format a number
const data = {
  increasedValue: 500,
  time: Date.UTC(2019),
}

intl.substitute("Number: {value}", data, {
  format: {
    value: {
      type: "number",
      intlOptions: {
        maximumFractionDigits: 21
      }
    }
  }
});

const data = {
  increasedValue: 500,
  time: Date.UTC(2019),
}

intl.substitute("Median income increased by {increasedValue} in {time:yearFormat}", data, {
  format: {
    increasedValue: {
      type: "number",
      intlOptions: {
        useGrouping: true,
        currency: "EUR",
        currencyDisplay: "symbol",
        maximumFractionDigits: 2
      }
    },
    yearFormat: {
      type: "date",
      intlOptions: {
        year: "numeric"
      }
    }
  }
});

相关用法

注：本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 intl.substitute。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

基本信息

用法说明

参数：

返回：

例子：