# @ethisyscore/foundation-utils 中文文档

规范地址：https://npmcn.com/package/%40ethisyscore/foundation-utils/

版本：0\.7\.1
npm 元数据更新时间：2026-10-25T16:31:53.225Z
中文译文更新时间：2026-11-13T23:48:54.683Z
软件包许可：SEE LICENSE IN LICENSE

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

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

弃用说明：This package has moved to the Ethisys Core package feed\. In Ethisys Core, open the Developers page and follow the setup steps \(cc login connects npm to the feed\)\.

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

- 包体积（解压后）：564 kB，103 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- peer 依赖：zod \>=4，dayjs \>=1\.11
- 首次发布：2026-10-19T09:44:31.975Z
- 最新版本发布：2026-10-24T20:02:56.542Z
- 近 30 天下载量：3322（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

EthysCore网络应用共享的无平台公用设备,插件SDK和插件:日期、时间和期限帮助器(超日期-fns),RFC 6902 JSON Patch(超突变),金钱,数字和字节的显示格式,列表封件正常化和p

## 安装

```sh
npm install @ethisyscore/foundation-utils
```

也可以使用：`pnpm add @ethisyscore/foundation-utils`、`yarn add @ethisyscore/foundation-utils`、`bun add @ethisyscore/foundation-utils`

## README

# @ethisyscore/创始-使用

EthysCore网络应用共享的无平台公用设备,插件SDK和插件. 纯类型脚本, 没有反应。 EthysCore基金会npm侧:遵循与.NET软件包相同的规则(无) 平台类型,每个概念一个行为,变化很少).

## 安装

```bash
npm install @ethisyscore/foundation-utils
```

`date-fns` 财务报告和审定财务报表 `mutative` 是运行时间的依赖. `dayjs` 财务报告和审定财务报表 `zod` 是可选的同伴依赖关系, 仅需要用于 `./date/dayjs` 财务报告和审定财务报表 `./phone/zod` 亚行道.

## 入境点

| 子路径 | 目录 |
| --- | --- |
| `.` | 下方所有东西,除了 `./date/dayjs` 财务报告和审定财务报表 `./phone/zod` |
| `./date` | 格式常数、 ISO 和时区安全辅助器、 显示格式、 持续时间、, `<input>` 改为 `DateTimeOffset` 线条帮助器、范围、格式字符串验证 |
| `./date/dayjs` | `dayjsToIsoDayBoundary` |
| `./date/org-format` | 组织驱动显示 : `formatDate`, (中文(简体) ), `formatDateTime`, (中文(简体) ), `formatTime`, (中文(简体) ), `formatDateOrPresent`, (中文(简体) ), `formatRelativeTime` 和日取口罩。 每人拿组织 `{ dateFormat, timeFormat }`; 缺少或无效的格式返回到英国 `dd/MM/yyyy` 财务报告和审定财务报表 `HH:mm` |
| `./patch` | RFC 6902 JSON 补丁: `generateJsonPatch`, (中文(简体) ), `applyJsonPatch`, (中文(简体) ), `deepClone` 编辑 `JsonPatchOperation` 类型 |
| `./list` | `unwrapList`: 正常的列表回复赤裸地或在一个信封中返回. `PAGE_SIZE_OPTIONS` 财务报告和审定财务报表 `DEFAULT_PAGE_SIZE` |
| `./money` | `formatMoney`, (中文(简体) ), `formatCompactMoney`, (中文(简体) ), `getCurrencySymbol`, (中文(简体) ), `parseMoney`。呼叫者总是给货币取名 |
| `./number` | `formatNumber`, (中文(简体) ), `formatPercent`, (中文(简体) ), `formatBytes` (1 KB = 1024字节)和 `formatDecimalBytes` (1KB = 1 000字节,用于储存津贴及其费用) |
| `./wire` | `decodeWireEnum`, (中文(简体) ), `decodeWireEnumName`: enum 值作为正文或名称发送 |
| `./route` | `RouteMetaEntry`, (中文(简体) ), `Breadcrumb`, (中文(简体) ), `sortBySpecificity`, (中文(简体) ), `matchRoute`, (中文(简体) ), `resolvePattern`, (中文(简体) ), `buildBreadcrumbs`: 匹配一个路径名与平面路由元数据并构建其面包屑线索 |
| `./types` | 底 DTO 和查询形状 : `Guid`, (中文(简体) ), `asGuid`, (中文(简体) ), `EMPTY_GUID`, (中文(简体) ), `Auditable`, (中文(简体) ), `AuditableDetailed`, (中文(简体) ), `HasRowVersion`, (中文(简体) ), `PagedQuery`, (中文(简体) ), `SearchQuery`, (中文(简体) ), `LookupItem` |
| `./phone` | `isValidPhone`, (中文(简体) ), `normalisePhone`, (中文(简体) ), `formatPhone`, (中文(简体) ), `sanitisePhoneInput`: E.164-相容电话号码(可选领跑) `+`,7-15个数字) |
| `./phone/zod` | `optionalPhoneSchema`, (中文(简体) ), `requiredPhoneSchema` |

这里没有什么州。 调用者保存组织的格式和货币(插件 SDK 在 模块级别 refs 从主机,React上下文中的web app上印出)并传入.

## 脚本

```bash
npm run build          # tsup: ESM + CJS + d.ts
npm test               # vitest
npm run lint           # tsc --noEmit + eslint
npm run lint:package   # publint + attw against the packed tarball
```

由 npm 发布 `.github/workflows/release.yml` 与基金会NuGet软件包相同的版本.

## 常见问题

### @ethisyscore/foundation-utils 是什么？

EthysCore网络应用共享的无平台公用设备,插件SDK和插件:日期、时间和期限帮助器\(超日期-fns\),RFC 6902 JSON Patch\(超突变\),金钱,数字和字节的显示格式,列表封件正常化和p注意：该包已被作者标记为弃用——This package has moved to the Ethisys Core package feed\. In Ethisys Core, open the Developers page and follow the setup steps \(cc login connects npm to the feed\)\.

### 如何安装 @ethisyscore/foundation-utils？

在项目目录运行 npm install @ethisyscore/foundation-utils，或使用 pnpm add / yarn add / bun add。

### @ethisyscore/foundation-utils 支持 TypeScript 吗？

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

### @ethisyscore/foundation-utils 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ethisyscore/foundation-utils 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ethisyscore/foundation-utils 可以商用吗？

@ethisyscore/foundation-utils 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @ethisyscore/foundation-utils 的下载量有多少？

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

### @ethisyscore/foundation-utils 还在维护吗？

最新版本 0\.7\.1 发布于 2026/10/25（20 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/10/19。作者已将其标记为弃用，新项目建议寻找替代方案。