harmony 鸿蒙设置用户偏好（仅对系统应用开放）

2025-06-12
浏览 (5)

设置用户偏好（仅对系统应用开放）

使用场景

除区域设置和应用偏好语言设置外，系统还可以设置用户偏好，当前支持是否使用本地数字、是否使用12/24小时制两种偏好。用户偏好设置会保存到系统区域及应用偏好语言中，最终体现在用户界面的国际化特性上。

开发步骤

接口具体使用方法和说明请参考setUsingLocalDigit和set24HourClock的API文档。

导入模块。

import { i18n, intl } from '@kit.LocalizationKit';
import { BusinessError } from '@kit.BasicServicesKit';

获取应用偏好语言。

// 获取应用偏好语言
let appPreferredLanguage: string = i18n.System.getAppPreferredLanguage();

设置应用界面数字。

try {
 i18n.System.setUsingLocalDigit(true); // 使用本地数字
} catch (error) {
 let err: BusinessError = error as BusinessError;
 console.error(`call System.setUsingLocalDigit failed, error code: ${err.code}, message: ${err.message}.`);
}
let date: Date = new Date(2023, 9, 25); // 时间日期为2023.10.25
let appPreferredLanguage: string = 'ar';
let dateTimeFmt: intl.DateTimeFormat = new intl.DateTimeFormat(appPreferredLanguage);
let formattedTime: string = dateTimeFmt.format(date); // formattedTime = '٢٠٢٣/١٠/٢٥'（使用阿拉伯语本地数字表示）

设置格式化的24小时制。

try {
 i18n.System.set24HourClock(true); // 设置系统时制为24小时制
} catch (error) {
 let err: BusinessError = error as BusinessError;
 console.error(`call System.set24HourClock failed, error code: ${err.code}, message: ${err.message}.`);
}
let date: Date = new Date(2023, 9, 25, 16, 48, 0); // 时间日期为2023.10.25 16:48:00
let appPreferredLanguage: string = 'zh';
let dateTimeFmt: intl.DateTimeFormat = new intl.DateTimeFormat(appPreferredLanguage, { timeStyle: 'medium' });
let formattedTime: string = dateTimeFmt.format(date); // formattedTime = '16:48:00'