@pisell/materials 1.8.12 → 1.8.14

package/es/components/pisellDataSourceContainer/components/ColumnsSetting/utils.js

@@ -4,60 +4,25 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-import { isJson } from '@pisell/utils';
-
 /**
- * 复制过来的功能
+ * 列设置工具：持久化复用 @pisell/utils 的 saveColumnSettingToLocal / getColumnSettingFromLocal；
+ * mergeColumnSettingSimple 为 Table 列与本地缓存的合并逻辑，保留在此。
  */
-var getTableKey = function getTableKey(componentId) {
-  // 兼容非浏览器环境（如SSR/测试）
-  if (typeof window === 'undefined' || typeof window.location === 'undefined') {
-    return "table-setting-".concat(componentId);
-  }
-  var _window$location = window.location,
-    pathname = _window$location.pathname,
-    search = _window$location.search;
-  var appendPath = pathname || '/';
 
-  // 仅用于读取 memory_key，其余查询参数忽略
-  var memoryKey = '';
-  try {
-    var params = new URLSearchParams(search || '');
-    var mk = params.get('memory_key');
-    if (mk && mk.trim() !== '') {
-      memoryKey = mk.trim();
-    }
-  } catch (e) {
-    // 忽略解析异常，降级为仅使用 pathname
-  }
-  var urlPart = memoryKey ? "".concat(appendPath, "#").concat(memoryKey) : appendPath;
-  return "table-setting-".concat(componentId, "-").concat(urlPart);
-};
-export var saveColumnSettingToLocal = function saveColumnSettingToLocal(_ref) {
-  var componentId = _ref.componentId,
-    columnSetting = _ref.columnSetting;
-  if (!componentId) return;
-  var storageKey = getTableKey(componentId);
-  var data = {
-    column_setting: columnSetting,
-    updatedAt: Date.now()
-  };
-  localStorage.setItem(storageKey, JSON.stringify(data));
-};
-export var getColumnSettingFromLocal = function getColumnSettingFromLocal(componentId) {
-  if (!componentId) return null;
-  var storageKey = getTableKey(componentId);
-  var originData = localStorage.getItem(storageKey);
-  if (originData && isJson(originData)) {
-    var data = JSON.parse(originData);
-    return data.column_setting;
-  }
-  return null;
+import { saveColumnSettingToLocal as saveColumnSettingToLocalFromUtils, getColumnSettingFromLocal, clearColumnSettingFromLocal } from '@pisell/utils';
+export { getColumnSettingFromLocal, clearColumnSettingFromLocal };
+
+/** 与 DataSourceContainer ColumnsSetting 调用处类型兼容的列设置项（含 React.ReactNode title） */
+
+export var saveColumnSettingToLocal = function saveColumnSettingToLocal(params) {
+  saveColumnSettingToLocalFromUtils({
+    componentId: params.componentId,
+    columnSetting: params.columnSetting
+  });
 };
-export var mergeColumnSettingSimple = function mergeColumnSettingSimple(_ref2) {
-  var columns = _ref2.columns,
-    componentId = _ref2.componentId;
-  // 没有 componentId，直接返回默认配置
+export var mergeColumnSettingSimple = function mergeColumnSettingSimple(_ref) {
+  var columns = _ref.columns,
+    componentId = _ref.componentId;
   if (!componentId) {
     return columns.map(function (item, index) {
       var _item$isShow;
@@ -67,8 +32,6 @@ export var mergeColumnSettingSimple = function mergeColumnSettingSimple(_ref2) {
       });
     });
   }
-
-  // 从本地存储读取
   var cachedColumns = getColumnSettingFromLocal(componentId);
   if (!cachedColumns || !Array.isArray(cachedColumns)) {
     return columns.map(function (item, index) {
@@ -79,13 +42,9 @@ export var mergeColumnSettingSimple = function mergeColumnSettingSimple(_ref2) {
       });
     });
   }
-
-  // 构建本地缓存的 Map（使用 dataIndex 作为 key）
   var cachedMap = new Map(cachedColumns.map(function (item) {
     return [item.dataIndex, item];
   }));
-
-  // 合并配置：本地缓存优先
   var mergedColumns = columns.map(function (item, index) {
     var _item$isShow3;
     var cached = cachedMap.get(item.dataIndex);
@@ -94,7 +53,6 @@ export var mergeColumnSettingSimple = function mergeColumnSettingSimple(_ref2) {
       return _objectSpread(_objectSpread({}, item), {}, {
         isShow: (_cached$isShow = cached.isShow) !== null && _cached$isShow !== void 0 ? _cached$isShow : true,
         sortIndex: (_cached$sortIndex = cached.sortIndex) !== null && _cached$sortIndex !== void 0 ? _cached$sortIndex : index
-        // 注意：fixed 等特殊字段不从缓存中覆盖，保持 props 传入的值
       });
     }
     return _objectSpread(_objectSpread({}, item), {}, {
@@ -102,16 +60,9 @@ export var mergeColumnSettingSimple = function mergeColumnSettingSimple(_ref2) {
       sortIndex: index
     });
   });
-
-  // 按 sortIndex 排序
   mergedColumns.sort(function (a, b) {
     var _a$sortIndex, _b$sortIndex;
     return ((_a$sortIndex = a.sortIndex) !== null && _a$sortIndex !== void 0 ? _a$sortIndex : 0) - ((_b$sortIndex = b.sortIndex) !== null && _b$sortIndex !== void 0 ? _b$sortIndex : 0);
   });
   return mergedColumns;
-};
-export var clearColumnSettingFromLocal = function clearColumnSettingFromLocal(componentId) {
-  if (!componentId) return;
-  var storageKey = getTableKey(componentId);
-  localStorage.removeItem(storageKey);
 };

package/es/components/pisellDataSourceContainer/components/Pagination/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("antd").PaginationProps> & DataSourceContainerContextType & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/hooks/useDataSourceKey.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const useDataSourceKey: () => {
     dataSourceKey: string | undefined;
     dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;

package/es/components/pisellDataSourceContainer/provider/HandleActions.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import { DataSourceContainerProps, HandleActionContextType } from '../type';
 export declare const HandleActionContext: React.Context<HandleActionContextType | null>;
-export declare const HandleActionsProvider: (props: DataSourceContainerProps) => JSX.Element;
+export declare const HandleActionsProvider: (props: DataSourceContainerProps) => React.JSX.Element;
 export declare const useHandleActionProvider: () => HandleActionContextType;

package/es/components/pisellDatePicker/datePickerCpt.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { PickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { Dayjs } from 'dayjs';
 import './detePickerCpt.less';
@@ -17,5 +18,5 @@ export interface DatePickerCptProps extends PickerDateProps<Dayjs> {
  * @param props
  * @constructor
  */
-declare const DatePickerCpt: (props: DatePickerCptProps) => JSX.Element;
+declare const DatePickerCpt: (props: DatePickerCptProps) => React.JSX.Element;
 export default DatePickerCpt;

package/es/components/pisellDatePicker/index.d.ts

@@ -1,2 +1,3 @@
-declare const PisellDatePicker: (props: any) => JSX.Element;
+/// <reference types="react" />
+declare const PisellDatePicker: (props: any) => import("react").JSX.Element;
 export default PisellDatePicker;

package/es/components/pisellDateTimeDisplay/PisellDateTimeDisplay.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import 'dayjs/locale/zh-cn';
+import 'dayjs/locale/en';
+import type { PisellDateTimeDisplayProps } from './types';
+import './PisellDateTimeDisplay.less';
+/**
+ * PisellDateTimeDisplay 组件
+ *
+ * @description
+ * 专注于展示当前时间的组件，支持：
+ * - 当前日期、时间、星期展示
+ * - 多种布局方式（水平、垂直、单行）
+ * - 丰富的格式化配置
+ * - 自动刷新
+ * - 国际化支持
+ *
+ * @example
+ * // 基础用法
+ * <PisellDateTimeDisplay />
+ *
+ * // 自定义格式
+ * <PisellDateTimeDisplay
+ *   layout="vertical"
+ *   timeFormat={{ use12Hour: true, showSeconds: true }}
+ *   dateFormat={{ showYear: true, showChineseUnit: true }}
+ * />
+ *
+ * // 自定义格式化字符串
+ * <PisellDateTimeDisplay
+ *   customFormat="YYYY-MM-DD HH:mm:ss"
+ * />
+ */
+export declare const PisellDateTimeDisplay: React.FC<PisellDateTimeDisplayProps>;
+declare const _default: React.NamedExoticComponent<PisellDateTimeDisplayProps>;
+export default _default;

package/es/components/pisellDateTimeDisplay/PisellDateTimeDisplay.js

@@ -12,6 +12,7 @@ import { useCurrentTime } from "./hooks";
 import { getRefreshInterval, isChinese as checkIsChinese, getRelativeDay, getRelativeDayLabel, getDayjsLocale } from "./utils";
 import { TimeDisplay, DateDisplay, WeekdayDisplay } from "./components";
 import { DATETIME_DISPLAY_FORMATS } from "./formats/dateTimeDisplayFormats";
+import useEngineContext from "../../hooks/useEngineContext";
 import "./PisellDateTimeDisplay.less";
 
 /**
@@ -42,8 +43,9 @@ import "./PisellDateTimeDisplay.less";
  * />
  */
 export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
-  var _ref, _presetSource$localeK;
-  var _props$layout = props.layout,
+  var _context$engine, _ref, _presetSource$localeK;
+  var valueProp = props.value,
+    _props$layout = props.layout,
     layout = _props$layout === void 0 ? 'horizontal' : _props$layout,
     _props$textAlign = props.textAlign,
     textAlign = _props$textAlign === void 0 ? 'center' : _props$textAlign,
@@ -67,9 +69,10 @@ export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
     onClick = props.onClick,
     className = props.className,
     style = props.style;
-
+  var context = useEngineContext();
+  var resolvedLocale = locale || (context === null || context === void 0 || (_context$engine = context.engine) === null || _context$engine === void 0 || (_context$engine = _context$engine.props) === null || _context$engine === void 0 ? void 0 : _context$engine.locale) || 'en';
   // 多语言格式：formatByLocale 优先，否则用内置 DATETIME_DISPLAY_FORMATS；再与单项 props 合并（单项优先）
-  var localeKey = getDayjsLocale(locale);
+  var localeKey = getDayjsLocale(resolvedLocale);
   var baseLocale = localeKey.split('-')[0];
   var presetSource = formatByLocale !== null && formatByLocale !== void 0 ? formatByLocale : DATETIME_DISPLAY_FORMATS;
   var preset = (_ref = (_presetSource$localeK = presetSource[localeKey]) !== null && _presetSource$localeK !== void 0 ? _presetSource$localeK : presetSource[baseLocale]) !== null && _ref !== void 0 ? _ref : {};
@@ -81,17 +84,20 @@ export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
   // 计算刷新间隔
   var computedRefreshInterval = refreshInterval !== null && refreshInterval !== void 0 ? refreshInterval : getRefreshInterval(effectiveTimeFormat);
 
-  // 使用自定义 hook 管理当前时间
+  // 使用自定义 hook 管理当前时间（仅在没有 value 时用于展示）
   var currentTime = useCurrentTime({
     refreshInterval: computedRefreshInterval,
-    disabled: disableAutoRefresh,
-    locale: locale,
+    disabled: disableAutoRefresh || valueProp !== undefined,
+    locale: resolvedLocale,
     onUpdate: onTimeUpdate
   });
 
+  // 展示时间：传入 value 时用 value 并应用当前 locale，否则用已带 locale 的 currentTime
+  var displayTime = valueProp !== undefined && valueProp !== null ? dayjs(valueProp).locale(localeKey) : currentTime;
+
   // 如果有自定义格式化，直接使用
   if (customFormat) {
-    var formattedTime = currentTime.format(customFormat);
+    var formattedTime = displayTime.format(customFormat);
     var _containerInlineStyle = _objectSpread({
       background: containerStyle === null || containerStyle === void 0 ? void 0 : containerStyle.background,
       borderRadius: containerStyle === null || containerStyle === void 0 ? void 0 : containerStyle.borderRadius,
@@ -120,7 +126,7 @@ export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
 
   // 日期与星期一体：若日期以相对日（今天/昨天/明天）展示，则不展示星期
   var referenceDate = dayjs();
-  var relativeDay = effectiveDateFormat !== null && effectiveDateFormat !== void 0 && effectiveDateFormat.showRelativeDay ? getRelativeDay(currentTime, referenceDate) : null;
+  var relativeDay = effectiveDateFormat !== null && effectiveDateFormat !== void 0 && effectiveDateFormat.showRelativeDay ? getRelativeDay(displayTime, referenceDate) : null;
   var hideWeekdayWhenDateRelative = showDate && relativeDay !== null;
 
   // 构建容器样式
@@ -140,14 +146,14 @@ export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
       case 'time':
         return showTime ? /*#__PURE__*/React.createElement(TimeDisplay, {
           key: "time",
-          time: currentTime,
+          time: displayTime,
           format: effectiveTimeFormat,
           style: timeStyle
         }) : null;
       case 'date':
         return showDate ? /*#__PURE__*/React.createElement(DateDisplay, {
           key: "date",
-          date: currentTime,
+          date: displayTime,
           format: effectiveDateFormat,
           referenceDate: dayjs(),
           style: dateStyle
@@ -155,7 +161,7 @@ export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
       case 'weekday':
         return showWeekday && !hideWeekdayWhenDateRelative ? /*#__PURE__*/React.createElement(WeekdayDisplay, {
           key: "weekday",
-          weekday: currentTime,
+          weekday: displayTime,
           format: effectiveWeekdayFormat,
           style: weekdayStyle
         }) : null;
@@ -203,15 +209,15 @@ export var PisellDateTimeDisplay = function PisellDateTimeDisplay(props) {
     var timeField = showTime ? renderField('time') : null;
 
     // 判断是否为中文环境
-    var currentLocale = currentTime.locale();
+    var currentLocale = displayTime.locale();
     var isChinese = checkIsChinese(currentLocale);
 
     // 当同时显示日期和星期时，使用合并格式；有相对日时只展示相对日，不展示具体日期与星期
     if (showDate && showWeekday) {
       var _labels$relativeDay;
       var labels = effectiveDateFormat === null || effectiveDateFormat === void 0 ? void 0 : effectiveDateFormat.relativeDayLabels;
-      var dateStr = relativeDay ? (_labels$relativeDay = labels === null || labels === void 0 ? void 0 : labels[relativeDay]) !== null && _labels$relativeDay !== void 0 ? _labels$relativeDay : getRelativeDayLabel(relativeDay, currentTime.locale()) : isChinese ? currentTime.format('M月D日') : currentTime.format('D MMM');
-      var weekdayStr = currentTime.format('ddd');
+      var dateStr = relativeDay ? (_labels$relativeDay = labels === null || labels === void 0 ? void 0 : labels[relativeDay]) !== null && _labels$relativeDay !== void 0 ? _labels$relativeDay : getRelativeDayLabel(relativeDay, displayTime.locale()) : isChinese ? displayTime.format('M月D日') : displayTime.format('D MMM');
+      var weekdayStr = displayTime.format('ddd');
       // 相对日替换掉原日期展示：有今天/昨天/明天时只显示相对日，不拼接具体日期或星期
       var combinedStr = relativeDay ? dateStr : isChinese ? "".concat(weekdayStr, " ").concat(dateStr) : "".concat(weekdayStr, ", ").concat(dateStr);
 

package/es/components/pisellDateTimeDisplay/PisellDateTimeDisplay.less

@@ -64,9 +64,10 @@
     line-height: 1.2;
   }
 
-  // 分隔符
+  // 分隔符：保留空格占位，避免纯空格时被折叠不显示
   &-separator {
     display: inline-block;
+    white-space: pre;
   }
 
   // 自定义格式化

package/es/components/pisellDateTimeDisplay/PisellDateTimeDisplay.stories.d.ts

@@ -0,0 +1,195 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import PisellDateTimeDisplay from './PisellDateTimeDisplay';
+/**
+ * PisellDateTimeDisplay 组件 Storybook
+ */
+declare const meta: Meta<typeof PisellDateTimeDisplay>;
+export default meta;
+declare type Story = StoryObj<typeof PisellDateTimeDisplay>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 水平布局（默认）
+ */
+export declare const HorizontalLayout: Story;
+/**
+ * 垂直布局
+ */
+export declare const VerticalLayout: Story;
+/**
+ * 单行布局
+ */
+export declare const InlineLayout: Story;
+/**
+ * 单行布局 - 自定义分隔符
+ */
+export declare const InlineWithCustomSeparator: Story;
+/**
+ * 中文完整日期格式：2025-12-31 - 2:00 周四
+ * 单行、日期在前、日期与时间之间 " - "、时间与星期之间空格
+ */
+export declare const InlineDateTimeWeekdayZh: Story;
+/**
+ * 12小时制
+ */
+export declare const Time12Hour: Story;
+/**
+ * 显示秒
+ */
+export declare const TimeWithSeconds: Story;
+/**
+ * 12小时制 + 显示秒
+ */
+export declare const Time12HourWithSeconds: Story;
+/**
+ * 小时补零
+ */
+export declare const TimePadHour: Story;
+/**
+ * 只显示小时
+ */
+export declare const TimeOnlyHour: Story;
+/**
+ * 完整日期（Y-M-D）
+ */
+export declare const DateFullYMD: Story;
+/**
+ * 月-日-年 格式
+ */
+export declare const DateMDY: Story;
+/**
+ * 日-月-年 格式
+ */
+export declare const DateDMY: Story;
+/**
+ * 中文日期带单位
+ */
+export declare const DateChinese: Story;
+/**
+ * 相对日：今天/昨天/明天
+ * 与「当前日期」同天显示「今天」，前一天「昨天」，后一天「明天」；其他日期仍按原格式。
+ * 参考日为 dayjs()，随时间变化：例如 2 月 4 日当天，2 月 4 日显示「今天」，2 月 3 日显示「昨天」。
+ */
+export declare const RelativeDay: Story;
+/**
+ * 相对日 - 英文
+ */
+export declare const RelativeDayEn: Story;
+/**
+ * 相对日 - 自定义文案
+ */
+export declare const RelativeDayCustomLabels: Story;
+/**
+ * 英文完整月份
+ */
+export declare const DateFullMonth: Story;
+/**
+ * 自定义分隔符
+ */
+export declare const DateCustomSeparator: Story;
+/**
+ * 星期完整展示（英文）
+ */
+export declare const WeekdayFull: Story;
+/**
+ * 星期完整展示（中文）
+ */
+export declare const WeekdayFullChinese: Story;
+/**
+ * 星期单字母展示
+ */
+export declare const WeekdaySingleLetter: Story;
+/**
+ * 只显示时间
+ */
+export declare const OnlyTime: Story;
+/**
+ * 只显示日期
+ */
+export declare const OnlyDate: Story;
+/**
+ * 自定义字段顺序
+ */
+export declare const CustomFieldOrder: Story;
+/**
+ * 自定义格式化 - ISO 格式
+ */
+export declare const CustomFormatISO: Story;
+/**
+ * 自定义格式化 - 中文格式
+ */
+export declare const CustomFormatChinese: Story;
+/**
+ * 自定义格式化 - 包含星期
+ */
+export declare const CustomFormatWithWeekday: Story;
+/**
+ * 中文环境
+ */
+export declare const LocaleChinese: Story;
+/**
+ * 英文环境
+ */
+export declare const LocaleEnglish: Story;
+/**
+ * 自定义容器样式
+ */
+export declare const CustomContainerStyle: Story;
+/**
+ * 自定义文本样式
+ */
+export declare const CustomTextStyle: Story;
+/**
+ * 居中对齐
+ */
+export declare const CenterAlign: Story;
+/**
+ * 禁用自动刷新
+ */
+export declare const DisableRefresh: Story;
+/**
+ * 自定义刷新间隔（5秒）
+ */
+export declare const CustomRefreshInterval: Story;
+/**
+ * 应用场景 - 后台首页
+ */
+export declare const ScenarioDashboard: Story;
+/**
+ * 应用场景 - 状态栏
+ */
+export declare const ScenarioStatusBar: Story;
+/**
+ * 应用场景 - 欢迎页
+ */
+export declare const ScenarioWelcome: Story;
+/**
+ * 应用场景 - 大屏展示
+ */
+export declare const ScenarioLargeScreen: Story;
+/**
+ * 多语言对比
+ */
+export declare const MultiLanguage: Story;
+/**
+ * 时间格式对比
+ */
+export declare const TimeFormats: Story;
+/**
+ * 日期格式对比
+ */
+export declare const DateFormats: Story;
+/**
+ * 星期格式对比
+ */
+export declare const WeekdayFormats: Story;
+/**
+ * 所有布局对比
+ */
+export declare const AllLayouts: Story;
+/**
+ * 深色主题
+ */
+export declare const DarkTheme: Story;

package/es/components/pisellDateTimeDisplay/components/DateDisplay.d.ts

@@ -0,0 +1,48 @@
+import React from 'react';
+import { type Dayjs } from 'dayjs';
+import type { DateFormatConfig, TextStyleConfig } from '../types';
+/**
+ * DateDisplay 组件 Props
+ */
+export interface DateDisplayProps {
+    /**
+     * 日期对象
+     */
+    date: Dayjs;
+    /**
+     * 日期格式配置
+     */
+    format?: DateFormatConfig;
+    /**
+     * 参考日期（用于「今天/昨天/明天」判定，默认当前时间 dayjs()）
+     */
+    referenceDate?: Dayjs;
+    /**
+     * 文本样式
+     */
+    style?: TextStyleConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * 日期展示组件
+ *
+ * @description
+ * - 格式化并展示日期
+ * - 支持 showRelativeDay：今天/昨天/明天时用相对日替换原日期展示，不展示具体日期
+ * - 支持不同的日期顺序（YMD/MDY/DMY）
+ * - 支持年月日字段显隐
+ * - 支持中文单位（年、月、日）
+ * - 支持英文月份格式（简写/完整/数字）
+ *
+ * @example
+ * <DateDisplay
+ *   date={dayjs()}
+ *   format={{ order: 'YMD', showYear: true, showChineseUnit: true }}
+ *   style={{ fontSize: 18, fontWeight: 400, color: '#666' }}
+ * />
+ */
+export declare const DateDisplay: React.FC<DateDisplayProps>;
+export default DateDisplay;

package/es/components/pisellDateTimeDisplay/formats/dateTimeDisplayFormats.js

@@ -1,7 +1,7 @@
 /**
  * PisellDateTimeDisplay 按语言预设的格式
- * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）、相对日今天/昨天/明天
- * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）、相对日 Today/Yesterday/Tomorrow
+ * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）；默认不展示相对日，可传 dateFormat.showRelativeDay: true 开启
+ * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）；默认不展示相对日，可传 dateFormat.showRelativeDay: true 开启
  */
 export var DATETIME_DISPLAY_FORMATS = {
   'zh-cn': {
@@ -10,7 +10,7 @@ export var DATETIME_DISPLAY_FORMATS = {
       showYear: true,
       separator: '-',
       showChineseUnit: false,
-      showRelativeDay: true
+      showRelativeDay: false
     },
     timeFormat: {
       use12Hour: false,
@@ -35,7 +35,7 @@ export var DATETIME_DISPLAY_FORMATS = {
       showYear: true,
       separator: '-',
       showChineseUnit: false,
-      showRelativeDay: true
+      showRelativeDay: false
     },
     timeFormat: {
       use12Hour: false,
@@ -58,7 +58,7 @@ export var DATETIME_DISPLAY_FORMATS = {
       order: 'DMY',
       shortMonth: true,
       showYear: true,
-      showRelativeDay: true,
+      showRelativeDay: false,
       useCommaBeforeYear: true
     },
     timeFormat: {

package/es/components/pisellDateTimeDisplay/hooks/useCurrentTime.d.ts

@@ -0,0 +1,46 @@
+import { Dayjs } from 'dayjs';
+/**
+ * useCurrentTime Hook 配置项
+ */
+export interface UseCurrentTimeOptions {
+    /**
+     * 刷新间隔（毫秒）
+     * @default 60000
+     */
+    refreshInterval?: number;
+    /**
+     * 是否禁用自动刷新
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * dayjs locale
+     * @default 优先使用全局配置，其次使用 i18n 当前语言（getCurrentLocale）
+     * @example 'zh-CN' | 'zh-HK' | 'en' | 'en-US' | 'ja'
+     */
+    locale?: string;
+    /**
+     * 时间更新回调
+     */
+    onUpdate?: (time: Dayjs) => void;
+}
+/**
+ * 管理当前时间状态的自定义 Hook
+ *
+ * @description
+ * - 自动创建定时器刷新时间
+ * - 支持自定义刷新间隔
+ * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > i18n 当前语言
+ * - 组件卸载时自动清除定时器
+ *
+ * @example
+ * const currentTime = useCurrentTime({
+ *   refreshInterval: 1000,
+ *   locale: 'zh-CN',
+ *   onUpdate: (time) => console.log(time.format())
+ * });
+ *
+ * @param options 配置项
+ * @returns 当前时间（Dayjs 对象）
+ */
+export declare function useCurrentTime(options?: UseCurrentTimeOptions): Dayjs;