国际化（Intl）

说明： 从 API Version 6 开始支持。

导入模块

import intl from '@ohos.intl';

权限

无

Locale

属性

constructor

constructor(locale: string, options?:options)

创建区域对象

• 参数：

  参数名	类型	必填	说明
  locale	string	是	包含区域设置信息的字符串，包括语言以及可选的脚本和区域。
  options	options	否	用于创建区域对象的选项。

• 示例：

  var locale = new Locale("zh-CN");

toString

toString(): string

将区域信息转换为字符串

• 返回值：

  类型	说明
  string	字符串形式的区域信息

• 示例：

  var locale = new Locale("zh-CN");
  locale.toString();

maximize

maximize(): Locale

最大化区域信息，若缺少脚本与地区信息，则补齐。

• 返回值：

  类型	说明
  Locale	最大化后的区域对象

• 示例：

  var locale = new Locale("zh-CN");
  locale.maximize();

minimize

minimize(): Locale

最小化区域信息，若包含脚本与地区信息，则去除。

• 返回值：

  类型	说明
  Locale	最小化后的区域对象

• 示例：

  var locale = new Locale("zh-CN");
  locale.minimize();

DateTimeFormat

constructor

constructor(locale: string, options?:DateTimeOptions)

创建时间日期格式化对象。

• 参数：

  参数名	类型	必填	说明
  locale	string	是	包含区域设置信息的字符串，包括语言以及可选的脚本和区域。
  options	DateTimeOptions	否	用于创建时间日期格式化的选项。

• 示例：

  var datefmt= new DateTimeFormat("zh-CN", { dateStyle: 'full', timeStyle: 'medium' });

constructor

constructor(locales: Array<string>, options?:DateTimeOptions)

创建时间日期格式化对象。

• 参数：

  参数名	类型	必填	说明
  locales	Array<string>	是	包含区域设置信息的字符串的数组。
  options	DateTimeOptions	否	用于创建时间日期格式化的选项。

• 示例：

  var datefmt= new DateTimeFormat(["ban", "zh"], { dateStyle: 'full', timeStyle: 'medium' });

format

format(date: Date): string;

格式化时间日期字符串。

• 参数：

  参数名	类型	必填	说明
  date	Date	是	时间日期对象。

• 返回值：

  类型	说明
  string	格式化后的时间日期字符串

• 示例：

  var date = new Date(2021, 11, 17, 3, 24, 0);
  var datefmt = new Intl.DateTimeFormat("en-GB");
  datefmt.format(date);

formatRange

formatRange(fromDate: Date, toDate: Date): string;

格式化时间日期段字符串。

• 参数：

  参数名	类型	必填	说明
  startDate	Date	是	起始的时间日期
  endDate	Date	是	结束的时间日期

• 返回值：

  类型	说明
  string	格式化后的时间日期段字符串

• 示例：

  var startDate = new Date(2021, 11, 17, 3, 24, 0);
  var endDate = new Date(2021, 11, 18, 3, 24, 0);
  var datefmt = new Intl.DateTimeFormat("en-GB");
  datefmt.formatRange(startDate, endDate);

resolvedOptions

resolvedOptions(): DateTimeOptions

获取DateTimeFormat 对象的格式化选项。

• 返回值：

  类型	说明
  DateTimeOptions	DateTimeFormat 对象的格式化选项。

• 示例：

  var datefmt = new Intl.DateTimeFormat("en-GB");
  datefmt.resolvedOptions();

NumberFormat

constructor

constructor(locale: string, options?:NumberOptions)

创建数字格式化对象。

参数：

• 示例：

  var numfmt = new Intl.NumberFormat("en-GB", {style:'decimal', notation:"scientific"});

constructor

constructor(locales: Array<string>, options?:NumberOptions)

创建数字格式化对象。

• 参数：

  参数名	类型	必填	说明
  locales	Array<string>	是	包含区域设置信息的字符串的数组。
  options	NumberOptions	否	用于创建数字格式化的选项。

• 示例：

  var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});

format

format(number: number): string;

格式化数字字符串。

• 参数：

  参数名	类型	必填	说明
  number	number	是	数字对象

• 返回值：

  类型	说明
  string	格式化后的数字字符串

• 示例：

  var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
  numfmt.format(1223);

resolvedOptions

resolvedOptions(): NumberOptions

获取NumberFormat 对象的格式化选项。

• 返回值：

  类型	说明
  NumberOptions	NumberFormat 对象的格式化选项。

• 示例：

  var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
  numfmt.resolvedOptions();

DateTimeOptions

表示时间日期格式化选项。

属性

NumberOptions

表示设备支持的能力。

属性