User Preference Setting (for System Applications Only)

Use Cases

In addition to system locales and application preferred languages, the system supports setting of user preferences. Currently, the system supports two user preferences: whether to use local digits and whether to use the 12/24-hour format. User preference settings are saved to system locales and application preferred languages as part of the internationalization feature.

How to Develop

For details about how to use the APIs, see setUsingLocalDigit and set24HourClock.

1. Import the intl module.

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

2. Obtain the preferred language of an application.

   // Obtain the preferred language of an application.
   let appPreferredLanguage: string = i18n.System.getAppPreferredLanguage();
   

3. Enable display of local digits on the application page.

   try {  
     i18n.System.setUsingLocalDigit(true); // Enable the local digit switch.
   } catch(error) {
     let err: BusinessError = error as BusinessError;
     console.error(`call System.setUsingLocalDigit failed, error code: ${err.code}, message: ${err.message}.`);
   }
   let date = new Date(2023, 9, 25);
   let appPreferredLanguage = "ar";
   let dateTimeFmt = new intl.DateTimeFormat(appPreferredLanguage);
   let result = dateTimeFmt.format(date); // result = "٢٠٢٣/١٠/٢٥" (local Arabic digits)
   

4. Set the 24-hour clock format.

   try {  
     i18n.System.set24HourClock(true); // true means to enable the 24-hour clock, and false means to enable the 12-hour clock.
   } catch(error) {
     let err: BusinessError = error as BusinessError;
     console.error(`call System.set24HourClock failed, error code: ${err.code}, message: ${err.message}.`);
   }
   let date = new Date(2023, 9, 25, 16, 48, 0);
   let appPreferredLanguage = "zh";
   let dateTimeFmt = new intl.DateTimeFormat(appPreferredLanguage, { timeStyle: "medium" });
   let result = dateTimeFmt.format(date); // result = "16:48:00"