# @ember-intl/formatjs-extract-cldr-data 中文文档

规范地址：https://npmcn.com/package/%40ember-intl/formatjs-extract-cldr-data/

版本：6\.1\.0
npm 元数据更新时间：2026-10-20T09:42:32.949Z
中文译文更新时间：2026-11-13T14:47:54.798Z
软件包许可：BSD-3-Clause

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ember-intl/formatjs-extract-cldr-data
原文对照：https://npmcn.com/package/%40ember-intl/formatjs-extract-cldr-data/?lang=original
项目主页：https://github.com/ember-intl/formatjs-extract-cldr-data
源码仓库：https://github.com/ember-intl/formatjs-extract-cldr-data

弃用说明：Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：48.7 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：6 个
- 首次发布：2017-08-05T09:15:28.754Z
- 最新版本发布：2018-11-17T14:53:40.545Z
- 近 30 天下载量：75198（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 0 个）

## 中文简介

用于取出FormatJS库需要的QQR数据的工具库.

## 安装

```sh
npm install @ember-intl/formatjs-extract-cldr-data
```

也可以使用：`pnpm add @ember-intl/formatjs-extract-cldr-data`、`yarn add @ember-intl/formatjs-extract-cldr-data`、`bun add @ember-intl/formatjs-extract-cldr-data`

## README

# 格式 JS 解析器 数据

用于提取 [缩略语](http://cldr.unicode.org/) 数据 [格式JS](http://formatjs.io/) 图书馆.

[![npm Version](https://img.shields.io/npm/v/@ember-intl/formatjs-extract-cldr-data.svg?style=flat-square)](https://www.npmjs.org/package/@ember-intl/formatjs-extract-cldr-data)

## 使用量

此软件包提供了一个函数,用于通过FormatJS库的默认导出来提取其所需的QXR数据. 数据作为由地语语言标记键入的对象返回;例如, `"en-US"`。这个软件包利用了一个事实,即语言标记是分级的,只会返回所需的唯一,去重复的数据.

以下例子显示了如何使用地语阶梯来返回独有数据:

```js
var extractData = require('formatjs-extract-cldr-data');

var data = extractData({
    locales    : ['en-US', 'en-GB'],
    pluralRules: true
});

console.log(data); // =>

{ 'en-US': { locale: 'en-US', parentLocale: 'en' },
  'en-GB': { locale: 'en-GB', parentLocale: 'en-001' },
  'en-001': { locale: 'en-001', parentLocale: 'en' } },
  en: { locale: 'en', pluralRuleFunction: [Function] }
```

自从 `pluralRuleFunction` 根区域 `"en"` 与本地语言相同: `"en-US"` 财务报告和审定财务报表 `"en-GB"`,该函数位于"en"条目. 条目 `en-*` 区位均包含 `parentLocale` 可追踪到 `"en"`。 。 。 .

### 数据形状

从这个软件包返回的数据对象将具有以下形状,这里是美国英语的数据:

```js
{ en:
   { locale: 'en',
     pluralRuleFunction: [Function],
     fields:
      { year: [Object],
        "year-short": [Object],
        month: [Object],
        "month-short": [Object],
        day: [Object],
        "day-short": [Object],
        hour: [Object],
        "hour-short": [Object],
        minute: [Object],
        "minute-short": [Object],
        second: [Object],
        "second-short": [Object] } } }
```

每个字段的形状如下: `year`数字 :

```js
{ displayName: 'Year',
  relative: { '0': 'this year', '1': 'next year', '-1': 'last year' },
  relativeTime:
   { future: { one: 'in {0} year', other: 'in {0} years' },
     past: { one: '{0} year ago', other: '{0} years ago' } } }
```

### 选项

为了返回任何数据,该值 `true` 必须指定给其中任一 `pluralRules` 和(或) `relativeFields` 选项。 默认情况下, 将返回%% R 中所有本地数据; 限制哪个本地数据, 将其中的数组指定给 `locales` 选项.

#### `locales`

用于提取数据、 指定为字符串语言标记的可选语系数组。 默认情况下, 数据会返回到 QQR 中的所有地方 .

**说明:** 这个软件包利用了语言标记等级来去复制数据,同时也使语言标记的外壳正常化. 每个地方都会有条目 `locales`, (中文(简体) ), _加号_ 每个父语言的条目直到根。 当一个地方有父母时,a `parentLocale` 字段将显示于 那个地方的入口.

#### `pluralRules`

是否布尔 `pluralRuleFunction`s 应为指定的 `locales`. 这些职能将支持基本和正数多元化。 这些函数是使用 [制作-平面](https://github.com/eemeli/make-plural.js) 项目.

#### `relativeFields`

是否布尔 `fields` 应当为指定的 `locales`. 所提取的字段数据仅限于支持FormatJS相对时间格式化特性所需的数据,其组织形状与上述形状相同.

## 更新 QQR 数据

本软件包使用的 QXR 版本和数据可以通过更改 `cldr-*` 软件包版本 `package.json`。 。 。 .

**说明:** 建议保持软件包的准确性 **没有** 使用情况 `~` 或者说 `^` 修饰相.

## 许可证

这个软件在雅虎公司BSD许可证下可以自由使用. 见 [自由文件](https://github.com/ember-intl/formatjs-extract-cldr-data/blob/master/LICENSE) 许可证文本和版权信息.

这套包装中的“R”数据是根据Apache、ICU和Unicode许可证发放的。 其许可文本和版权信息请参见QQR许可文件.

## 常见问题

### @ember-intl/formatjs-extract-cldr-data 是什么？

用于取出FormatJS库需要的QQR数据的工具库\.注意：该包已被作者标记为弃用——Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

### 如何安装 @ember-intl/formatjs-extract-cldr-data？

在项目目录运行 npm install @ember-intl/formatjs-extract-cldr-data，或使用 pnpm add / yarn add / bun add。

### @ember-intl/formatjs-extract-cldr-data 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ember-intl\_\_formatjs-extract-cldr-data 是否存在。

### @ember-intl/formatjs-extract-cldr-data 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ember-intl/formatjs-extract-cldr-data 可以商用吗？

@ember-intl/formatjs-extract-cldr-data 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @ember-intl/formatjs-extract-cldr-data 的下载量有多少？

根据 npm 官方下载统计，@ember-intl/formatjs-extract-cldr-data 在 2026/10/14 – 2026/11/12 这 30 天内被下载 75,198 次，日均约 2,507 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ember-intl/formatjs-extract-cldr-data 还在维护吗？

最新版本 6\.1\.0 发布于 2018/11/17（7 年前）；至今共发布 7 个版本，其中过去 12 个月发布了 0 个；首次发布于 2017/08/05。作者已将其标记为弃用，新项目建议寻找替代方案。