Time Zone Setting

Use Cases

The local time of different countries and regions varies according to their longitude. Therefore, different time zones are planned. For example, the UK uses time zone 0 and China uses time zone GMT+8. The time in China is eight hours earlier than that in the UK. For example, 12:00 in Beijing is 4 a.m. in London. The time zone module allows your application to obtain the time zone list to implement its own service logic, for example, a dual-clock application.

How to Develop

Time Zone-related Functions

1. Import the i18n module.

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

2. Create a TimeZone object and implement functions such as calculating the offset between a fixed time zone and the actual time zone and obtaining and traversing the time zone list. “`ts // Obtain the time zone of Brazil. let timezone: i18n.TimeZone = i18n.getTimeZone(‘America/Sao_Paulo’); // Pass in a specific time zone to create a TimeZone object. let timezoneId: string = timezone.getID(); // timezoneId = ‘America/Sao_Paulo’

// Obtain the TimeZone object corresponding to the city ID. let aucklandTimezone: i18n.TimeZone = i18n.TimeZone.getTimezoneFromCity(‘Auckland’); timezoneId = aucklandTimezone.getID(); // timezoneId = ‘Pacific/Auckland’

// Localized time zone name let timeZoneName: string = timezone.getDisplayName (‘zh-Hans’, true); // timeZoneName =‘Brasília Standard Time’

// Localized city name let cityDisplayName: string = i18n.TimeZone.getCityDisplayName(‘Auckland’, ‘zh-Hans’); // cityDisplayName = ‘Auckland (New Zealand)’

// Fixed offset of the time zone let rawOffset: number = timezone.getRawOffset(); // rawOffset = -10800000

// Actual offset of the time zone (fixed offset + DST) let offset: number = timezone.getOffset(1234567890); // offset = -10800000

// List of time zone IDs supported by the system. let availableIDs: Array = i18n.TimeZone.getAvailableIDs(); // availableIDs = [‘America/Adak’, ‘Asia/Hovd’, …]

// List of time zone city IDs supported by the system. let cityIDs: Array = i18n.TimeZone.getAvailableZoneCityIDs(); // cityIDs = [‘Auckland’, ‘Magadan’, …]

// Traverse the list of time zone city IDs. let timezoneList: Array