簡介

國際化部件為應用提供了一系列國際化接口，包括：時間日期格式化、數字格式化、月份星期格式化、單復數、度量衡等相關接口。基于這些國際化接口，開發者可以設計并實現具有良好國際化能力的應用，從而可以高效、低成本的實現應用的本地化。國際化部件支持如下設備：Multi-modal V200Z-R BES2600。

國際化部件架構圖說明:

• Kits為提供的c++國際化接口。
• frameworks為c++接口的底層c++實現。
• binary data generate tool為數據打包工具。數據打包工具的輸入為文本數據文件，輸出為二進制數據文件i18n.dat，i18n.dat中包含了國際化接口所依賴的國際化數據。數據打包工具位于tools/i18n-dat-tool目錄下，i18n.dat位于frameworks目錄下。 數據打包工具的使用方法：執行tools/i18n-dat-tool/src/main/java/ohos/global/i18n/Fetcher.java中的main方法。
• source data文本格式的國際化數據，位于tools/i18n-dat-tool/resource目錄下。

鴻蒙知識已更新完整gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md可以前往參考。

或者添+mau123789是衛心

說明

1. 提供時間日期格式化接口，使時間日期格式（如年月日順序、月份和星期詞匯、使用12或24小時制等）跟隨系統設置滿足不同區域用戶的文化習慣。更詳細的內容見API文檔。示例如下：

   #include "date_time_format.h"
   using namespace OHOS::I18N
   
   LocaleInfo locale("zh", "Hans", "CN");  // 獲得區域
   DateTimeFormat formatter(AvailableDateTimeFormatPattern::HOUR_MINUTE, locale); // 初始化時間日期示例，并獲取該區域時間格式化所需數據，第一個參數為時間日期格式化模板類型，所支持的模板類型見API文檔types.h
   time_t time = 3600 * 3; // 所需要格式化的時間
   std::string zoneInfo = "+1:00"; // 設置時區，相對于UTC 0時區加一小時
   std::string out; // 時間日期格式化結果保存在out中
   Ii8nStatus status = Ii8nStatus::ISUCCESS;
   formatter.Format(time, zoneInfo, out, status); // 判斷status狀態
   
   output:  4:00
   

2. 提供數字格式化接口，使數字格式（如數字體系、數字分組、小數點、百分號等）跟隨應用系統設置滿足不同區域用戶的文化習慣。更詳細的內容見API文檔。示例如下：

   #include "number_format.h"
   using namespace OHOS::I18N
   
   LocaleInfo locale("en", "US");
   int status = 0;
   NumberFormat formatter(locale, status);  // 初始化數據格式化實例，并獲取指定locale數字格式化所需數據；status為初始化的結果，等于1時表示初始化失敗
   int num = 1234
   std::string out = formatter.Format(num, status);  // 判斷status狀態
   
   output: 1,234
   

3. 提供獲取指定區域月份、星期不同格式名稱的能力。示例如下：

   #include "date_time_format.h"
   using namespace OHOS::I18N
   
   LocaleInfo locale("en", "US");  // 獲得區域
   DateTimeFormat formatter(AvailableDateTimeFormatPattern::HOUR_MINUTE, locale);
   std::string month = formatter.GetMonthName(0, DateTimeDataType::FORMAT_WIDE); // 獲取format類型的長格式
   
   output: January
   

4. 不同語言下名稱跟隨數字有不同的表達，如英文下會有：“one apple”、“two apples”。單復數規范總結多種語言的語法規范將名詞的單數和復數形式劃分為zero、one、two、few、many、other六種類型。不同語言支持不同數量的單復數類型，如中文只支持other一種，英文支持one和other兩種，阿拉伯語支持全部6種類型。提供單復數接口來計算不同語言下不同數字時應該使用的名詞復數類型，使“數字+名詞”這種表達形式跟隨應用語言滿足不同語言用戶的文化習慣。示例如下：

   #include "plural_format.h"
   using namespace OHOS::I18N
   
   Locale locale("en", "US"); // 獲得區域
   Ii8nStatus status = Ii8nStatus::ISUCCESS;
   PluralFormatter formatter = PluralFormatter(locale, status);  // 判斷status狀態
   int out = formatter.GetPluralFormatter(1, status);  // 判斷status狀態
   
   output: 1 // 獲取單復數六條規則中的第二條規則
   

5. 提供獲取指定區域不同單復數、不同格式對應的度量衡名稱的能力。示例如下：

   #include "measure_format.h"
   using namespace OHOS::I18N
   
   LocaleInfo locale("en", "US");  // 獲得區域
   int num = 1;  // 度量衡前的數字，如 1h
   std::string unit = "h";  // 度量衡
   I18nStatus status = I18nStatus::ISUCCESS;
   MeasureFormatType type = MeasureFormatType::MEASURE_FULL;  // 指定度量衡格式，包括SHORT、MEDIUM、LONG、FULL四種格式。
   MeasureFormat formatter(locale, status);  // 判斷status狀態
   std::string unit = formatter.Format(num, unit, status, type); // 獲取前置數字1、FULL格式下，度量衡h（小時）的格式化表示。
   
   output: hour
   

審核編輯 黃宇