@equinor/fusion-wc-date

中文文档
1.2.5发布于 2026/10/22ISCTypeScriptCommonJS构建来源已验证近 30 天下载 1971
□`聚变-wc-date'[!][在npm上写作](https://img.shields.io/npm/v/@equinor/聚变-wc-date.svg)](https://www.npmjs.com/package/@equinor/聚变-wc-date)
中文使用文档
文档目录9 节
  1. fusion-wc-date
  2. 安装
  3. 日期时间 <fwc-datetime>
  4. 示例使用
  5. 属性/属性
  6. 范围 <fwc-daterange>
  7. 示例使用
  8. 槽数
  9. 属性/属性

fusion-wc-date Published on npm

故事书

安装

npm install @equinor/fusion-wc-date

日期时间 <fwc-datetime>

示例使用

日期

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

日期和时间

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

时间

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

自定义

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

替代格式类型

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

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

有自定义地产

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

属性/属性

名称类型默认说明
datestringcurrent date以 ISO 格式格式格式格式化的日期 。 见 ISO 8601 (英语)。 。 。 .
formatDateTimeFormat* or stringdatetime要使用的预定义或自定义格式 。 依据 Unicode 技术标准# 35。 。 。 .
localeLocaleName**enGB用于覆盖日期格式所依据的地块 。 参见日期-fns Locale。 。 。 .

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

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 用于所有支持的地方.

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

范围 <fwc-daterange>

示例使用

相对

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

距离

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

日期和时间( 从 - 到)

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

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

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>
);

有自定义地产

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。 。 。 .

属性/属性

名称类型默认说明
fromstringcurrent date以 ISO 格式格式格式格式化的日期 。 见 ISO 8601 (英语)。 。 。 .
tostringcurrent date以 ISO 格式比较的日期 。 见 ISO 8601 (英语)。 。 。 .
variantDateRangeVariant*datetime用作格式计算基础的模板变量,默认为 datetime (单位:千美元)HH:mm dd.MM.yyyy - 说吧 HH:mm dd.MM.yyyy) (中文(简体) ).
formatDateTimeFormat** or stringundefined要使用的预定义或自定义格式 。 依据 Unicode 技术标准# 35。 。 。 .
localeLocaleName***enGB用于覆盖日期格式所依据的地块 。 参见日期-fns Locale。 。 。 .
secondsbooleanfalse设定 true 中包含秒数 distance 变种.
weekstartWeekDay****1每周第一天的索引(0 = Sunday) (中文(简体) ).
suffixbooleanfalse包含后缀以显示是否 date 位于 baseDate。仅适用于变体 distance。 。 。 .
capitalizebooleanfalse设定 true 来利用格式化文本中的第一个字符。 适用于 distance 财务报告和审定财务报表 relative 变相.

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

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

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

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 用于所有支持的地方.

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

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

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

版本与发布记录

@equinor/fusion-wc-date 共发布 43 个版本,首次发布于 2021/08/12;过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.5latest2026/10/2224 天前
1.2.42026/08/123 个月前
1.2.32026/05/116 个月前
1.2.22026/05/056 个月前
1.2.12026/04/286 个月前
1.2.02026/04/206 个月前

其他发布通道:next → 0.2.28-next.1。

关于 @equinor/fusion-wc-date 的常见问题

@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 和提交记录判断。