# @equinor/fusion-wc-date 中文文档

规范地址：https://npmcn.com/package/%40equinor/fusion-wc-date/

版本：1\.2\.5
npm 元数据更新时间：2026-10-22T14:33:35.650Z
中文译文更新时间：2026-11-16T00:26:38.737Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40equinor/fusion-wc-date
原文对照：https://npmcn.com/package/%40equinor/fusion-wc-date/?lang=original
项目主页：https://github.com/equinor/fusion-web-components#readme
源码仓库：https://github.com/equinor/fusion-web-components

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

- 包体积（解压后）：703 kB，23 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2021-08-12T07:45:24.561Z
- 最新版本发布：2026-10-22T14:33:34.892Z
- 近 30 天下载量：1971（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 6 个）

## 中文简介

□\`聚变-wc-date'\[!\]\[在npm上写作\](https://img.shields.io/npm/v/@equinor/聚变-wc-date.svg)\](https://www.npmjs.com/package/@equinor/聚变-wc-date)

## 安装

```sh
npm install @equinor/fusion-wc-date
```

也可以使用：`pnpm add @equinor/fusion-wc-date`、`yarn add @equinor/fusion-wc-date`、`bun add @equinor/fusion-wc-date`

## README

## `fusion-wc-date` [![Published on npm](https://img.shields.io/npm/v/@equinor/fusion-wc-date.svg)](https://www.npmjs.com/package/@equinor/fusion-wc-date)

[故事书](https://equinor.github.io/fusion-web-components/?path=/docs/data-date)

## 安装

```sh
npm install @equinor/fusion-wc-date
```

## 日期时间 `<fwc-datetime>`

### 示例使用

#### 日期

```ts
return (
  <fwc-datetime format={DateTimeFormat.date} date='2021-08-09T11:12:49Z' />
);
```

#### 日期和时间

```ts
return (
  <fwc-datetime format={DateTimeFormat.datetime} date='2021-08-09T11:12:49Z' />
);
```

#### 时间

```ts
return (
  <fwc-datetime format={DateTimeFormat.time} date='2021-08-09T11:12:49Z' />
);
```

#### 自定义

```ts
return (
  <fwc-datetime format='yyyy.MM.dd' date='2021-08-09T11:12:49Z' />
);
```

#### 替代格式类型

这个 `format` 变量也可以作为数值而不是输入的 enum

```ts
return (
  <fwc-datetime format='datetime' date='2021-08-09T11:12:49Z' />
);
```

#### 有自定义地产

```ts
return (
  <fwc-datetime format={DateTimeFormat.time} date='2021-08-09T11:12:49Z' locale='nb' />
);
```

### 属性/属性

| 名称 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `date` | `string` | `current date` | 以 ISO 格式格式格式格式化的日期 。 见 [ISO 8601 (英语)](https://en.wikipedia.org/wiki/ISO_8601)。 。 。 . |
| `format` | `DateTimeFormat* or string` | `datetime` | 要使用的预定义或自定义格式 。 依据 [Unicode 技术标准# 35](https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table)。 。 。 . |
| `locale` | `LocaleName**` | `enGB` | 用于覆盖日期格式所依据的地块 。 参见日期-fns [`Locale`](https://date-fns.org/v2.23.0/docs/Locale)。 。 。 . |

\* 联合国 `DateTimeFormat` 导出于 `fwc-date`。 。 。 .

```ts
enum DateTimeFormat {
  date='dd.MM.yyyy',
  time='HH:mm',
  datetime='HH:mm dd.MM.yyyy',
  time_with_seconds='HH:mm:ss',
  datetime_with_seconds='HH:mm:ss dd.MM.yyyy',
}
```

页:1 `LocaleName` 导出于 `fwc-date`。 。 。 . 参见日期-fns [`Locale`](https://date-fns.org/v2.23.0/docs/Locale) 用于所有支持的地方.

```ts
type LocaleName = 'enGB' | 'enUS' | 'nb' | ...;
```

## 范围 `<fwc-daterange>`

### 示例使用

#### 相对

```ts
return (
  <fwc-daterange variant='relative' date='2021-08-09T09:12:49Z' baseDate='2021-08-09T11:12:49Z' />
);
```

#### 距离

```ts
return (
  <fwc-daterange variant='distance' date='2021-08-09T09:12:49Z' baseDate='2021-08-09T11:12:49Z' />
);
```

#### 日期和时间( 从 - 到)

```ts
return (
  <fwc-daterange
    variant='datetime'
    format={DateTimeFormat.datetime}
    date='2021-08-09T09:12:49Z'
    baseDate='2021-08-09T11:12:49Z'
  />
);
```

#### 日期( G) 使用自定义分隔符的时间

```ts
return (
  <fwc-daterange
    variant='datetime'
    format={DateTimeFormat.datetime}
    date='2021-08-09T09:12:49Z'
    baseDate='2021-08-09T11:12:49Z'
  >
  <span slot='separator'>to</span>
  </fwc-daterange>
);
```

#### 有自定义地产

```ts
return (
  <fwc-daterange
    variant='datetime'
    format={DateTimeFormat.datetime}
    date='2021-08-09T09:12:49Z'
    baseDate='2021-08-09T11:12:49Z'
    locale='nb'
  >
  <span slot='separator'>to</span>
  </fwc-daterange>
);
```

### 槽数

| 名称 | 默认 | 说明 |
| --- | --- | --- |
| `separator` | `<span>-</span>` | 要制取的分隔元素 `from` 财务报告和审定财务报表 `to` 变式日期 `datetime`。 。 。 . |

### 属性/属性

| 名称 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `from` | `string` | `current date` | 以 ISO 格式格式格式格式化的日期 。 见 [ISO 8601 (英语)](https://en.wikipedia.org/wiki/ISO_8601)。 。 。 . |
| `to` | `string` | `current date` | 以 ISO 格式比较的日期 。 见 [ISO 8601 (英语)](https://en.wikipedia.org/wiki/ISO_8601)。 。 。 . |
| `variant` | `DateRangeVariant*` | `datetime` | 用作格式计算基础的模板变量,默认为 `datetime` (单位:千美元)`HH:mm dd.MM.yyyy` - 说吧 `HH:mm dd.MM.yyyy`) (中文(简体) ). |
| `format` | `DateTimeFormat** or string` | `undefined` | 要使用的预定义或自定义格式 。 依据 [Unicode 技术标准# 35](https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table)。 。 。 . |
| `locale` | `LocaleName***` | `enGB` | 用于覆盖日期格式所依据的地块 。 参见日期-fns [`Locale`](https://date-fns.org/v2.23.0/docs/Locale)。 。 。 . |
| `seconds` | `boolean` | `false` | 设定 `true` 中包含秒数 `distance` 变种. |
| `weekstart` | `WeekDay****` | `1` | 每周第一天的索引(`0 = Sunday`) (中文(简体) ). |
| `suffix` | `boolean` | `false` | 包含后缀以显示是否 `date` 位于 `baseDate`。仅适用于变体 `distance`。 。 。 . |
| `capitalize` | `boolean` | `false` | 设定 `true` 来利用格式化文本中的第一个字符。 适用于 `distance` 财务报告和审定财务报表 `relative` 变相. |

\* 联合国 `DateRangeVariant` 导出于 `fwc-date`。 。 。 .

```ts
type DateRangeVariant = 'relative' | 'distance' | 'datetime';
```

页:1 `DateTimeFormat` 导出于 `fwc-date`。 。 。 .

```ts
enum DateTimeFormat {
  date = 'dd.MM.yyyy',
  time = 'HH:mm',
  datetime = 'HH:mm dd.MM.yyyy',
  time_with_seconds = 'HH:mm:ss',
  datetime_with_seconds = 'HH:mm:ss dd.MM.yyyy',
}
```

页:1 `LocaleName` 导出于 `fwc-date`。 。 。 . 参见日期-fns [`Locale`](https://date-fns.org/v2.23.0/docs/Locale) 用于所有支持的地方.

```ts
type LocaleName = 'enGB' | 'enUS' | 'nb' | ...;
```

页:1 `WeekDay` 导出于 `fwc-date`。 。 。 .

```ts
type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6;
```

## 常见问题

### @equinor/fusion-wc-date 是什么？

□\`聚变-wc-date'\[\!\]\[在npm上写作\]\(https://img\.shields\.io/npm/v/@equinor/聚变-wc-date\.svg\)\]\(https://www\.npmjs\.com/package/@equinor/聚变-wc-date\)

### 如何安装 @equinor/fusion-wc-date？

在项目目录运行 npm install @equinor/fusion-wc-date，或使用 pnpm add / yarn add / bun add。

### @equinor/fusion-wc-date 支持 TypeScript 吗？

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

### @equinor/fusion-wc-date 支持 ESM 还是 CommonJS？

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

### @equinor/fusion-wc-date 可以商用吗？

@equinor/fusion-wc-date 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @equinor/fusion-wc-date 的下载量有多少？

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

### @equinor/fusion-wc-date 还在维护吗？

最新版本 1\.2\.5 发布于 2026/10/22（24 天前）；至今共发布 43 个版本，其中过去 12 个月发布了 6 个；首次发布于 2021/08/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

