# @fdograph/rut-utilities 中文文档

规范地址：https://npmcn.com/package/%40fdograph/rut-utilities/

版本：1\.4\.0
npm 元数据更新时间：2022-04-05T10:24:31.163Z
中文译文更新时间：2026-11-14T12:33:15.610Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40fdograph/rut-utilities
原文对照：https://npmcn.com/package/%40fdograph/rut-utilities/?lang=original
项目主页：https://github.com/fdograph/rut-utilities#readme
源码仓库：https://github.com/fdograph/rut-utilities

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

- 包体积（解压后）：30.7 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-01-20T20:26:55.389Z
- 最新版本发布：2022-03-01T19:08:56.247Z
- 近 30 天下载量：19343（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 0 个）

## 中文简介

完整输入的一套公用功能来解析,验证和生成智利的R.U.T. 建立实用实用技术系统,促进和有效使用R.U.T. Chillino completamente tipado.

## 安装

```sh
npm install @fdograph/rut-utilities
```

也可以使用：`pnpm add @fdograph/rut-utilities`、`yarn add @fdograph/rut-utilities`、`bun add @fdograph/rut-utilities`

## README

# 智利公用事业公司

![Coverage - Branches](https://npmcn.com/package/%40fdograph/rut-utilities/badges/badge-branches.svg) ![Coverage - Functions](https://npmcn.com/package/%40fdograph/rut-utilities/badges/badge-functions.svg) ![Coverage - Lines](https://npmcn.com/package/%40fdograph/rut-utilities/badges/badge-lines.svg) ![Coverage - Statements](https://npmcn.com/package/%40fdograph/rut-utilities/badges/badge-statements.svg)

## [:es: 西班牙的韦尔西翁](https://npmcn.com/package/%40fdograph/rut-utilities/README-es.md)

* * *

**目录**

-   [:es: 西班牙的韦尔西翁](https://npmcn.com/package/%40fdograph/rut-utilities/README-es.md)
-   [: speech balloon: 进取](https://npmcn.com/package/%40fdograph/rut-utilities/#readme-intro)
-   [:火箭:开始](https://npmcn.com/package/%40fdograph/rut-utilities/#readme-getting-started)
-   [: 扳手: 用法](https://npmcn.com/package/%40fdograph/rut-utilities/#readme-usage)
-   [: page facing up:许可证](https://npmcn.com/package/%40fdograph/rut-utilities/#readme-license)

* * *

## : speech balloon: 进取

> 完整输入的一套工具函数,用于解析、验证和生成 [智利 R.U.T.](https://es.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario)
> 
> 用于想要交互,操纵和验证智利R.U.T的开发者.

## : 火箭: 开始

### Npm & Yarn 安装 :

```bash
$ npm install @fdograph/rut-utilities

$ yarn add @fdograph/rut-utilities
```

[: 顶: 返回顶端](https://npmcn.com/package/%40fdograph/rut-utilities/#readme-contents)

## : 扳手: 用法

> `validateRut(rut?: string, noSuspicious = true) => boolean`

回返 `true` 如果通过 `string` 对应于完全有效的R.U.T。 这是有效的 `rut-like` `string` 并且不符合"可疑"R.U.T.模式。 缩写: `44.444.444-4`, (中文(简体) ), `22.222.222-2`, (中文(简体) ), `3.333.333-3`, (中文(简体) ), `9999999-9`

```typescript
import { validateRut } from '@fdograph/rut-utilities';

validateRut('18585543-0');
> true

validateRut('18.585.543-0');
> true

validateRut('9.999.999-9');
> false

validateRut('44.444.444-4');
> false
```

为了避免"可疑"的R.U.T.验证 我们可以推翻 `noSuspicious` 辩论并传为 `false`。这将改变这种方法的行为,使其跳过“可疑”模式验证.

```typescript
import { validateRut } from '@fdograph/rut-utilities';

validateRut('18585543-0', false);
> true

validateRut('18.585.543-0', false);
> true

validateRut('9.999.999-9', false);
> true

validateRut('44.444.444-4', false);
> true
```

* * *

> `validateRutList(ruts: Iterable<string>, noSuspicious = false) => Map<string, boolean>`

返回结果 [地图](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) 每个条目有一个 `key` 对应输入和 `value` 与审定结果相对应.

```typescript
import { validateRutList } from '@fdograph/rut-utilities';

const validRuts = ['7775735-k', '18585543-0', '18348353-6'];
const result = validateRutList(validRuts);

result.get('7775735-k');
> true

result.get(validRuts[1]);
> true

```

* * *

> `formatRut(rut?: string, format?: RutFormat = RutFormat.DASH) => string`

格式 a `rut-like` 根据 `format` 参数或返回完整字符串,如果它不匹配 `rut-like` 字符串图案 .

```typescript
enum RutFormat {
    DOTS,
    DASH,
    DOTS_DASH
}
```

```typescript
import { formatRut, RutFormat } from '@fdograph/rut-utilities';

formatRut('44.333.222-1');
> '44333222-1'

formatRut('44333222-1', RutFormat.DOTS_DASH);
> '44.333.222-1'

formatRut('44333222-1', RutFormat.DOTS);
> '44.333.2221'

formatRut('jg7gk-1', RutFormat.DOTS);
> 'jg7gk-1'
```

* * *

> `deconstructRut(rut: string) => DeconstructedRut`

返回包含 RUT 对象 `digits` 财务报告和审定财务报表 `verifier`。 。 。 .

你用得着 [调整结构](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment) 进入每一个.

```typescript
type DeconstructedRut = {
  digits: string;
  verifier: string;
}
```

```typescript
import { deconstructRut } from '@fdograph/rut-utilities';

const { digits, verifier } = deconstructRut('7775735-k');

console.log(digits);
> '7775735'

console.log(verifier);
> 'k'

```

* * *

您可以在 [测试](https://npmcn.com/package/%40fdograph/rut-utilities/src/tests/main.test.ts)

## : page facing up:许可证

该项目根据Apache 2.0许可证颁发许可——见 [自由主义](https://npmcn.com/package/%40fdograph/rut-utilities/LICENSE) 详细文件.

[: 顶: 返回顶端](https://npmcn.com/package/%40fdograph/rut-utilities/#readme-contents)

## 常见问题

### @fdograph/rut-utilities 是什么？

完整输入的一套公用功能来解析,验证和生成智利的R\.U\.T\. 建立实用实用技术系统,促进和有效使用R\.U\.T\. Chillino completamente tipado\.

### 如何安装 @fdograph/rut-utilities？

在项目目录运行 npm install @fdograph/rut-utilities，或使用 pnpm add / yarn add / bun add。

### @fdograph/rut-utilities 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fdograph/rut-utilities 支持 ESM 还是 CommonJS？

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

### @fdograph/rut-utilities 可以商用吗？

@fdograph/rut-utilities 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @fdograph/rut-utilities 的下载量有多少？

根据 npm 官方下载统计，@fdograph/rut-utilities 在 2026/10/15 – 2026/11/13 这 30 天内被下载 19,343 次，日均约 645 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fdograph/rut-utilities 还在维护吗？

最新版本 1\.4\.0 发布于 2022/03/02（4 年前）；至今共发布 27 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/01/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。