openharmony / global_i18n_standard

Providing i18n capabilities such as date/time formatting | 提供时间日期格式化等国际化能力

i18n

• Introduction
• Directory Structure
• Constraints
• Usage
• Repositories Involved

Introduction

The i18n module provides a wide array of internationalization (i18n) APIs for implementing functions such as date and time formatting.

Directory Structure

The directory structure for the i18n module is as follows:

/base/global/
├── i18n_standard           # Code repository for the i18n framework
│   ├── frameworks          # Core code of the i18n framework
│   ├── interfaces          # APIs
│   │   ├── js              # JavaScript APIs
│   │   └── native          # Native APIs

Constraints

Development language: JavaScript

Language, script, and country codes: The supported language must be represented by a two- or three-letter code defined in the ISO 639 standard; the supported script must be represented by a four-letter code defined in the ISO 15924 standard; the supported country must be represented by a two-letter code defined in the ISO 3166 standard.

Usage

Change the date and time formats (such as the sequence of year, month, and day, month and week names, and 12-hour or 24-hour system) following the system settings to adapt to the cultural habits of users in different locales. For details, see the API reference. The sample code is as follows:

const date = new Date(2021, 11, 17, 3, 24, 0); // Create a Date object containing date and time information.
fmt = new Intl.DateTimeFormat('en-US') // Create a DateTimeFormat instance.
console.log(fmt.format(date)); // Format the date and time by using the DateTimeFormat instance.

Repositories Involved

Globalization subsystem

global_i18n_standard

global_resmgr_standard