HarmonyOS 鸿蒙Next中I18n.getTimeZone()接口支持的系统时区有那些，有没有文档

HarmonyOS 鸿蒙Next中I18n.getTimeZone()接口支持的系统时区有那些，有没有文档 I18n.getTimeZone()接口

支持的系统时区有那些，有没有文档

4 回复

1、通过【getTimeZone(zoneID?: string): TimeZone】获取时区ID对应的时区对象。

import { i18n } from '@kit.LocalizationKit';
let timezone: i18n.TimeZone = i18n.getTimeZone('Asia/Shanghai');

2、通过【getTimeZone()】获取日历对象的时区ID。

import { i18n } from '@kit.LocalizationKit';
let calendar: i18n.Calendar = i18n.getCalendar('zh-Hans');
calendar.setTimeZone('Asia/Shanghai');
let timezone: string = calendar.getTimeZone(); // timezone = 'Asia/Shanghai'
时区 ID 对应地区 / 说明 时区偏移（标准时） 夏令时支持 鸿蒙开发常用场景
Asia/Shanghai 中国全境（含港澳台），中国标准时间（CST） UTC+8 不支持 国内应用默认时区、面向中文用户
America/New_York 美国东部（纽约、华盛顿等），北美东部时间 UTC-5 支持（UTC-4） 面向北美东部用户的跨地区应用
Europe/London 英国伦敦及西欧部分地区，格林威治标准时间（GMT） UTC 支持（UTC+1） 面向欧洲西部用户的跨地区应用
Asia/Tokyo 日本全境，日本标准时间（JST） UTC+9 不支持 面向日本用户的应用，适配简单
Asia/Kolkata 印度全境，印度标准时间（IST） UTC+5:30 不支持 面向印度用户的应用，需处理 30 分钟偏移

相关文档：

更多关于HarmonyOS 鸿蒙Next中I18n.getTimeZone()接口支持的系统时区有那些，有没有文档的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


通过i18n.TimeZone.getAvailableIDs()方法可获取完整的时区标识符列表：

import { i18n } from '@kit.LocalizationKit';
let timezoneIds = i18n.TimeZone.getAvailableIDs();
timezoneIds.forEach(id => {
  console.log("时区ID：" + id);
});

文档地址

https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-i18n#getdisplaycountry9

HarmonyOS Next的I18n.getTimeZone()接口支持IANA时区数据库标准，包含全球主要时区标识（如Asia/Shanghai、America/New_York等）。具体时区列表可查阅华为开发者文档站点的“国际化开发指南”章节，其中“时区与本地化”部分提供了完整的支持时区对照表。文档路径：Developer.Huawei.com → HarmonyOS开发文档 → 应用开发 → 国际化 → 时区管理。

HarmonyOS Next的I18n.getTimeZone()接口支持IANA时区数据库（tz database）中的标准时区标识，包括：

主要时区示例：

  • Asia/Shanghai（中国标准时间）
  • America/New_York（美国东部时间）
  • Europe/London（格林威治标准时间）
  • UTC（协调世界时）

完整时区列表： 可通过系统内置的IANA时区数据库获取全部600+时区标识，涵盖全球各地区标准时区、夏令时规则及历史时区变更。

官方文档： 详细时区列表和接口用法请参考： 华为开发者文档 - I18n模块

建议在开发时直接调用接口获取设备支持的完整时区列表，或查阅官方文档获取最新时区数据。

回到顶部