时区

使用场景

全球各国家和地区的经度不同，地方时间也有所不同，因此划分了不同的时区。例如英国采用0时区，中国采用东8时区，中国时间要比英国快8个小时，中国北京中午12:00是英国伦敦凌晨4点。时区模块可用于获取时区列表，应用可基于时区列表实现业务逻辑，如双时钟应用。
时区模块还可用于获取时区跳变时间点、偏移量等，时区的跳变逻辑参考夏令时跳变。

开发步骤

时区相关功能

1. 导入模块。

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

2. 开发实例，包括获取特定时区、计算固定和实际时区偏移量、获取和遍历时区列表等。 “`ts // 获取巴西时区 let timezone: i18n.TimeZone = i18n.getTimeZone(‘America/Sao_Paulo’); // 传入特定时区，创建时区类 let timezoneId: string = timezone.getID(); // timezoneId = ‘America/Sao_Paulo’

// 获取城市ID对应的时区对象 let aucklandTimezone: i18n.TimeZone = i18n.TimeZone.getTimezoneFromCity(‘Auckland’); timezoneId = aucklandTimezone.getID(); // timezoneId = ‘Pacific/Auckland’

// 时区的本地化名称 let timeZoneName: string = timezone.getDisplayName(‘zh-Hans’, true); // timeZoneName = ‘巴西利亚标准时间’

// 本地化城市名称 let cityDisplayName: string = i18n.TimeZone.getCityDisplayName(‘Auckland’, ‘zh-Hans’); // cityDisplayName = ‘奥克兰 (新西兰)’

// 时区的固定偏移量 let rawOffset: number = timezone.getRawOffset(); // rawOffset = -10800000

// 时区的实际偏移量（固定偏移量+夏令时） let offset: number = timezone.getOffset(1234567890); // offset = -10800000

// 系统支持的时区ID列表 let availableIDs: Array = i18n.TimeZone.getAvailableIDs(); // availableIDs = [‘America/Adak’, ‘Asia/Hovd’, …]

// 系统支持的时区城市ID列表 let cityIDs: Array = i18n.TimeZone.getAvailableZoneCityIDs(); // cityIDs = [‘Auckland’, ‘Magadan’, …]

// 遍历时区城市ID列表 let timezoneList: Array