@yingzhixiaoyi/dayjs
v0.0.1
Published
Unified Day.js runtime with timezone, server clock and time helpers
Readme
@yingzhixiaoyi/dayjs
包定位
统一的 Day.js 时间运行时,提供预装插件、业务时区、服务器时间校准、时间格式化、比较和区间判断。
能力边界
本包负责:
- Day.js 实例和常用插件统一初始化;
- 默认业务时区和显式时区服务;
- 服务器时间偏移校准;
- 常见时间格式化、比较、区间和运算;
- Day.js locale 由宿主应用按需管理。
本包不负责:
- 网络请求和响应头读取;
- 业务 API、活动规则和页面状态;
- Wujie 或主子应用通信;
- 具体 UI 组件。
依赖边界
dayjs是运行时依赖。- 不依赖
wujie_mono或业务包。
使用方式
import { timeUtil, updateServerTimeFromHeader } from '@yingzhixiaoyi/dayjs'
updateServerTimeFromHeader(response.headers.get('Date') ?? '')
timeUtil.formatToDateTime(order.createdAt)
timeUtil.isAfter(order.startAt)需要原生 Day.js 时:
import { dayjs } from '@yingzhixiaoyi/dayjs'IIFE 产物使用宿主提供的全局依赖:
<script src="https://unpkg.com/[email protected]/dayjs.min.js"></script>
<script src="https://cdn.example.com/@yingzhixiaoyi/dayjs/index.iife.js"></script>无法提供 dayjs 全局对象时,应使用 ESM / Vite 入口。
注意事项
- 无时区字符串按包配置的业务时区解释。
- 默认时区不是所有业务的通用事实,其他项目应使用
createTimeService配置自己的时区。 - 服务器时间校准只影响对应时钟实例;不要把客户端时间和服务器校准时间混用。
