时间日期国际化

使用场景

在不同的国家和文化中，时间和日期格式的表示方法存在差异，具体表现在日期中年月日的顺序以及时间中时分秒的分隔符。若应用中需展示时间日期，要确保界面以合适的方式显示，以便用户能够理解。

时间日期国际化包括时间日期格式化、相对时间格式化、时间段格式化。时间日期格式化是指将时间和日期转换为指定格式的字符串。相对时间格式化是指将一个时间点与另一个时间点之间的时间差转换为指定格式，例如“30秒前”、“1天后”。时间段格式化是指将一段时间转换为指定格式，例如“星期三”、“8:00 - 11:30”。

约束与限制

1. dateStyle和timeStyle需同时设置。设置timeStyle但不设置dateStyle时，只显示时间；设置dateStyle但不设置timeStyle时，只显示日期。

2. 设置dateStyle或timeStyle时，不支持设置年、月、日、时、分、秒、工作日格式；不设置dateStyle和timeStyle时，支持独立设置年、月、日、时、分、秒、工作日格式。

开发步骤

时间日期和相对时间格式化

时间日期格式化将表示时间日期的Date对象，通过DateTimeFormat类的format接口实现格式化，具体开发步骤如下。

1. 导入模块。

   import { intl } from '@kit.LocalizationKit';
   

2. 创建DateTimeFormat对象。 传入单独的区域ID或区域ID列表。如果传入列表，使用第一个有效的区域ID创建对象。如果不传入区域参数，使用系统当前的区域ID创建对象。 构造函数支持通过DateTimeOptions设置不同的时间日期格式，具体请参考表1-表10。

   let dateFormat: intl.DateTimeFormat = new intl.DateTimeFormat(locale: string|Array<string>, options?: DateTimeOptions);
   let dateFormat: intl.DateTimeFormat = new intl.DateTimeFormat(); // 不传入区域参数

1. 时间日期和相对时间格式化。 “`ts // 时间日期格式化 let formattedDate: string = dateFormat.format(date: Date);

// 相对时间格式化 let formattedDateRange: string = dateFormat.formatRange(startDate: Date, endDate: Date);

4. 获取格式化选项，查看对象的设置信息。
   ```ts
   let options: intl.DateTimeOptions = dateFormat.resolvedOptions();

时间日期格式化选项

以时间：2021年9月17日 13:04:00、2021年9月17日 00:25:00和区域ID: zh-CN、en为例，说明DateTimeOptions的取值和显示结果。

表1 日期显示格式(dateStyle)

表2 时间显示格式(timeStyle)

表3 年份显示格式(year)

表4 星期显示格式(weekday)

表5 时制格式(hourCycle)

说明

不设置dateStyle或timeStyle参数时，hourCycle不同取值的显示效果如上表格。

表6 时制格式(hourCycle)

说明

设置dateStyle或timeStyle参数时，hourCycle不同取值的显示效果如上表格。

表7 月份格式(month)

表8 时区名称的本地化表示(timeZoneName)

表9 纪元的显示格式(era)

表10 时段的显示格式(dayPeriod)

开发实例

// 导入模块
import { intl } from '@kit.LocalizationKit';

let date: Date = new Date(2021, 8, 17, 13, 4, 0); // 时间日期为2021.09.17 13:04:00
let startDate: Date = new Date(2021, 8, 17, 13, 4, 0);
let endDate: Date = new Date(2021, 8, 18, 13, 4, 0);

// 在软件上展示完整的时间信息
let fullFormat: intl.DateTimeFormat = new intl.DateTimeFormat('zh-CN', { dateStyle: 'full', timeStyle: 'full' });
let formattedDate: string = fullFormat.format(date); // formattedDate = '2021年9月17日星期五 中国标准时间 13:04:00'

// 在有限的空间展示简短的时间信息
let shortFormat: intl.DateTimeFormat = new intl.DateTimeFormat('zh-CN', { dateStyle: 'short', timeStyle: 'short' });
formattedDate = shortFormat.format(date); // formattedDate = '2021/9/17 13:04'

// 自定义年月日时分秒的显示效果
let customFormat: intl.DateTimeFormat = new intl.DateTimeFormat('zh-CN',
  {
    year: 'numeric',
    month: '2-digit',
    day: '2-digit',
    hour: '2-digit',
    minute: '2-digit',
    second: '2-digit'
  });
formattedDate = customFormat.format(date); // formattedDate = '2021/09/17 13:04:00'

// 仅显示一部分时间
let partialFormat: intl.DateTimeFormat = new intl.DateTimeFormat('zh-CN',
  {
    month: 'long',
    day: 'numeric',
    weekday: 'long'
  });
formattedDate = partialFormat.format(date); // formattedDate = '9月17日星期五'

// 自定义时制格式
let hourCycleFormat: intl.DateTimeFormat = new intl.DateTimeFormat('zh-CN',
  {
    dateStyle: 'short',
    timeStyle: 'short',
    hourCycle: 'h11'
  });
formattedDate = hourCycleFormat.format(date); // formattedDate = '2021/9/17 下午13:04'

// 面向习惯于其他数字系统的用户
let numberingSystemFormat: intl.DateTimeFormat = new intl.DateTimeFormat('zh-CN',
  {
    dateStyle: 'short',
    timeStyle: 'short',
    numberingSystem: 'arab'
  });
formattedDate = numberingSystemFormat.format(date); // formattedDate = '٢٠٢١/٩/١٧ ١٣:٠٤'

// 格式化时间段
let dateRangeFormat: intl.DateTimeFormat = new intl.DateTimeFormat('en-GB');
let formattedDateRange: string =
  dateRangeFormat.formatRange(startDate, endDate); // formattedDateRange = '17/09/2021 - 18/09/2021'

// 获取格式化选项
let dateFormat: intl.DateTimeFormat = new intl.DateTimeFormat('en-GB', { dateStyle: 'full' });
let options: intl.DateTimeOptions = dateFormat.resolvedOptions();
let dateStyle: string|undefined = options.dateStyle; // dateStyle = 'full'

相对时间格式化

格式化相对时间将表示时间日期的Date对象，通过RelativeTimeFormat类的format接口实现格式化，具体开发步骤如下：

1. 导入模块。

   import { intl } from '@kit.LocalizationKit';
   

2. 创建RelativeTimeFormat对象。 构造函数支持通过RelativeTimeFormatInputOptions设置不同的输出消息格式和国际化消息长度，具体请参考表7和表8。

   let relativeTimeFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat(locale: string|Array<string>, options?: RelativeTimeFormatInputOptions);
   

3. 格式化相对时间。value为格式化的数值，unit为格式化的单位。

   let formattedRelativeTime: string = relativeTimeFormat.format(value: number, unit: string);
   

4. 自定义相对时间的格式化。

   let parts: Array<object> = relativeTimeFormat.formatToParts(value: number, unit: string);
   

5. 获取相对时间格式化选项，查看对象的设置信息。

   let options: intl.RelativeTimeFormatInputOptions = relativeTimeFormat.resolvedOptions();
   

相对时间格式化选项

以相对时间：一天前，区域ID: fr-FR和en-GB为例，说明RelativeTimeFormatInputOptions不同的取值和显示结果。

表11 数值表示(numeric)

表12 相对时间样式(style)

开发实例

// 导入模块
import { intl } from '@kit.LocalizationKit';

// 显示相对时间
let relativeTimeFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat('en-GB');
let formattedRelativeTime: string = relativeTimeFormat.format(-1, 'day'); // formattedRelativeTime = '1 day ago'

// 口语化
let numericAutoFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat('en-GB', { numeric: 'auto' });
formattedRelativeTime = numericAutoFormat.format(-1, 'day'); // formattedRelativeTime = 'yesterday'

// 部分语言支持更为简短的显示风格
let longFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat('fr-FR'); // 默认style为long
formattedRelativeTime = longFormat.format(-1, 'day'); // formattedRelativeTime = 'il y a 1 jour'
let narrowFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat('fr-FR', { style: 'narrow' });
formattedRelativeTime = narrowFormat.format(-1, 'day'); // formattedRelativeTime = '-1 j'

// 自定义区域设置格式的相对时间格式
let partFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat('en-GB', { style: 'long' });
// parts = [{type: 'literal', value: 'in'}, {type: 'integer', value: 1, unit: 'day'}, {type: 'literal', value: 'day'}]
let parts: object[] = partFormat.formatToParts(1, 'day');

// 获取RelativeTimeFormat对象的格式化选项
let resolvedFormat: intl.RelativeTimeFormat = new intl.RelativeTimeFormat('en-GB', { numeric: 'auto' });
let options: intl.RelativeTimeFormatResolvedOptions = resolvedFormat.resolvedOptions();
let numeric: string = options.numeric; // numeric = 'auto'

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Localization Kit（本地化开发服务）

harmony 鸿蒙设置日历和历法

harmony 鸿蒙字符处理

harmony 鸿蒙概述

harmony 鸿蒙夏令时跳变

harmony 鸿蒙国际化和本地化概述

harmony 鸿蒙本地化语言与地区名称

harmony 鸿蒙区域ID与文化习惯划分

harmony 鸿蒙数字与度量衡国际化

harmony 鸿蒙电话号码格式化