@pisell/materials 3.3.82 → 3.3.84

package/es/components/pisellDateTimeDisplay/components/DateDisplay.js

@@ -0,0 +1,57 @@
+import React from 'react';
+import dayjs from 'dayjs';
+import { formatDate, getRelativeDay, getRelativeDayLabel } from "../utils";
+
+/**
+ * DateDisplay 组件 Props
+ */
+
+/**
+ * 日期展示组件
+ *
+ * @description
+ * - 格式化并展示日期
+ * - 支持 showRelativeDay：今天/昨天/明天时用相对日替换原日期展示，不展示具体日期
+ * - 支持不同的日期顺序（YMD/MDY/DMY）
+ * - 支持年月日字段显隐
+ * - 支持中文单位（年、月、日）
+ * - 支持英文月份格式（简写/完整/数字）
+ *
+ * @example
+ * <DateDisplay
+ *   date={dayjs()}
+ *   format={{ order: 'YMD', showYear: true, showChineseUnit: true }}
+ *   style={{ fontSize: 18, fontWeight: 400, color: '#666' }}
+ * />
+ */
+export var DateDisplay = function DateDisplay(_ref) {
+  var _labels$relativeDay;
+  var date = _ref.date,
+    format = _ref.format,
+    _ref$referenceDate = _ref.referenceDate,
+    referenceDate = _ref$referenceDate === void 0 ? dayjs() : _ref$referenceDate,
+    style = _ref.style,
+    className = _ref.className;
+  var labels = format === null || format === void 0 ? void 0 : format.relativeDayLabels;
+  var relativeDay = format !== null && format !== void 0 && format.showRelativeDay ? getRelativeDay(date, referenceDate) : null;
+  // 相对日替换原日期展示：有今天/昨天/明天时只显示相对日，不展示具体日期
+  var formattedDate = relativeDay ? (_labels$relativeDay = labels === null || labels === void 0 ? void 0 : labels[relativeDay]) !== null && _labels$relativeDay !== void 0 ? _labels$relativeDay : getRelativeDayLabel(relativeDay, date.locale()) : formatDate(date, format);
+
+  // 如果没有要显示的内容，返回 null
+  if (!formattedDate) {
+    return null;
+  }
+
+  // 构建样式
+  var inlineStyle = {
+    fontSize: style === null || style === void 0 ? void 0 : style.fontSize,
+    fontWeight: style === null || style === void 0 ? void 0 : style.fontWeight,
+    color: style === null || style === void 0 ? void 0 : style.color,
+    lineHeight: style === null || style === void 0 ? void 0 : style.lineHeight
+  };
+  return /*#__PURE__*/React.createElement("span", {
+    className: "pisell-datetime-display-date ".concat(className || '').trim(),
+    style: inlineStyle
+  }, formattedDate);
+};
+export default DateDisplay;

package/es/components/pisellDateTimeDisplay/components/TimeDisplay.js

@@ -0,0 +1,44 @@
+import React from 'react';
+import { formatTime } from "../utils";
+
+/**
+ * TimeDisplay 组件 Props
+ */
+
+/**
+ * 时间展示组件
+ *
+ * @description
+ * - 格式化并展示时间
+ * - 支持 12/24 小时制
+ * - 支持显示秒
+ * - 支持小时补零
+ *
+ * @example
+ * <TimeDisplay
+ *   time={dayjs()}
+ *   format={{ use12Hour: false, showSeconds: true }}
+ *   style={{ fontSize: 24, fontWeight: 600, color: '#000' }}
+ * />
+ */
+export var TimeDisplay = function TimeDisplay(_ref) {
+  var time = _ref.time,
+    format = _ref.format,
+    style = _ref.style,
+    className = _ref.className;
+  // 格式化时间
+  var formattedTime = formatTime(time, format);
+
+  // 构建样式
+  var inlineStyle = {
+    fontSize: style === null || style === void 0 ? void 0 : style.fontSize,
+    fontWeight: style === null || style === void 0 ? void 0 : style.fontWeight,
+    color: style === null || style === void 0 ? void 0 : style.color,
+    lineHeight: style === null || style === void 0 ? void 0 : style.lineHeight
+  };
+  return /*#__PURE__*/React.createElement("span", {
+    className: "pisell-datetime-display-time ".concat(className || '').trim(),
+    style: inlineStyle
+  }, formattedTime);
+};
+export default TimeDisplay;

package/es/components/pisellDateTimeDisplay/components/WeekdayDisplay.js

@@ -0,0 +1,59 @@
+import React from 'react';
+import { formatWeekday } from "../utils";
+
+/**
+ * WeekdayDisplay 组件 Props
+ */
+
+/**
+ * 星期展示组件
+ *
+ * @description
+ * - 格式化并展示星期
+ * - 支持完整/缩写/单字母模式
+ * - 自动支持中英文
+ *
+ * @example
+ * // 默认（缩写）
+ * <WeekdayDisplay
+ *   weekday={dayjs()}
+ *   format={{ full: false, singleLetter: false }}
+ *   style={{ fontSize: 18, fontWeight: 400, color: '#666' }}
+ * />
+ * // => "Sat" / "周六"
+ *
+ * // 完整
+ * <WeekdayDisplay
+ *   weekday={dayjs()}
+ *   format={{ full: true }}
+ * />
+ * // => "Saturday" / "星期六"
+ *
+ * // 单字母
+ * <WeekdayDisplay
+ *   weekday={dayjs()}
+ *   format={{ singleLetter: true }}
+ * />
+ * // => "S" / "六"
+ */
+export var WeekdayDisplay = function WeekdayDisplay(_ref) {
+  var weekday = _ref.weekday,
+    format = _ref.format,
+    style = _ref.style,
+    className = _ref.className;
+  // 格式化星期
+  var formattedWeekday = formatWeekday(weekday, format);
+
+  // 构建样式
+  var inlineStyle = {
+    fontSize: style === null || style === void 0 ? void 0 : style.fontSize,
+    fontWeight: style === null || style === void 0 ? void 0 : style.fontWeight,
+    color: style === null || style === void 0 ? void 0 : style.color,
+    lineHeight: style === null || style === void 0 ? void 0 : style.lineHeight
+  };
+  return /*#__PURE__*/React.createElement("span", {
+    className: "pisell-datetime-display-weekday ".concat(className || '').trim(),
+    style: inlineStyle
+  }, formattedWeekday);
+};
+export default WeekdayDisplay;

package/es/components/pisellDateTimeDisplay/components/index.js

@@ -0,0 +1,3 @@
+export { TimeDisplay } from "./TimeDisplay";
+export { DateDisplay } from "./DateDisplay";
+export { WeekdayDisplay } from "./WeekdayDisplay";

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

@@ -0,0 +1,81 @@
+/**
+ * PisellDateTimeDisplay 按语言预设的格式
+ * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）、相对日今天/昨天/明天
+ * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）、相对日 Today/Yesterday/Tomorrow
+ */
+export var DATETIME_DISPLAY_FORMATS = {
+  'zh-cn': {
+    dateFormat: {
+      order: 'YMD',
+      showYear: true,
+      separator: '-',
+      showChineseUnit: false,
+      showRelativeDay: true
+    },
+    timeFormat: {
+      use12Hour: false,
+      showSeconds: false
+    },
+    weekdayFormat: {
+      full: false,
+      singleLetter: false
+    },
+    fields: {
+      showTime: true,
+      showDate: true,
+      showWeekday: true,
+      fieldOrder: ['date', 'time', 'weekday'],
+      inlineSeparators: [' - ', ' ']
+    }
+  },
+  zh: {
+    // 兜底 zh
+    dateFormat: {
+      order: 'YMD',
+      showYear: true,
+      separator: '-',
+      showChineseUnit: false,
+      showRelativeDay: true
+    },
+    timeFormat: {
+      use12Hour: false,
+      showSeconds: false
+    },
+    weekdayFormat: {
+      full: false,
+      singleLetter: false
+    },
+    fields: {
+      showTime: true,
+      showDate: true,
+      showWeekday: true,
+      fieldOrder: ['date', 'time', 'weekday'],
+      inlineSeparators: [' - ', ' ']
+    }
+  },
+  en: {
+    dateFormat: {
+      order: 'DMY',
+      shortMonth: true,
+      showYear: true,
+      showRelativeDay: true,
+      useCommaBeforeYear: true
+    },
+    timeFormat: {
+      use12Hour: false,
+      showSeconds: false
+    },
+    weekdayFormat: {
+      full: false,
+      singleLetter: false,
+      trailingComma: true
+    },
+    fields: {
+      showTime: true,
+      showDate: true,
+      showWeekday: true,
+      fieldOrder: ['time', 'weekday', 'date'],
+      inlineSeparators: [' ', ' ']
+    }
+  }
+};

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

@@ -0,0 +1 @@
+export { DATETIME_DISPLAY_FORMATS } from "./dateTimeDisplayFormats";

package/es/components/pisellDateTimeDisplay/hooks/index.js

@@ -0,0 +1 @@
+export { useCurrentTime } from "./useCurrentTime";

package/es/components/pisellDateTimeDisplay/hooks/useCurrentTime.js

@@ -0,0 +1,86 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useState, useEffect } from 'react';
+import dayjs from 'dayjs';
+import { getDayjsLocale } from "../utils/localeUtils";
+import usePisellConfig from "../../pisell-config-provider/hooks/usePisellConfig";
+
+/**
+ * useCurrentTime Hook 配置项
+ */
+
+/**
+ * 管理当前时间状态的自定义 Hook
+ *
+ * @description
+ * - 自动创建定时器刷新时间
+ * - 支持自定义刷新间隔
+ * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > i18n 当前语言
+ * - 组件卸载时自动清除定时器
+ *
+ * @example
+ * const currentTime = useCurrentTime({
+ *   refreshInterval: 1000,
+ *   locale: 'zh-CN',
+ *   onUpdate: (time) => console.log(time.format())
+ * });
+ *
+ * @param options 配置项
+ * @returns 当前时间（Dayjs 对象）
+ */
+export function useCurrentTime(options) {
+  var _ref = options || {},
+    _ref$refreshInterval = _ref.refreshInterval,
+    refreshInterval = _ref$refreshInterval === void 0 ? 60000 : _ref$refreshInterval,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    userLocale = _ref.locale,
+    onUpdate = _ref.onUpdate;
+
+  // 获取全局配置中的 locale
+  var globalConfig = usePisellConfig();
+  var globalLocale = globalConfig === null || globalConfig === void 0 ? void 0 : globalConfig.locale;
+
+  // 获取实际使用的 locale（优先级：用户指定 > 全局配置 > i18n 当前语言）
+  var dayjsLocale = getDayjsLocale(userLocale || globalLocale);
+
+  // 初始化时间
+  var _useState = useState(function () {
+      var time = dayjs();
+      return time.locale(dayjsLocale);
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    currentTime = _useState2[0],
+    setCurrentTime = _useState2[1];
+  useEffect(function () {
+    // 如果禁用自动刷新，只设置一次
+    if (disabled) {
+      return;
+    }
+
+    // 设置定时器
+    var timer = setInterval(function () {
+      var time = dayjs();
+      var localizedTime = time.locale(dayjsLocale);
+      setCurrentTime(localizedTime);
+      onUpdate === null || onUpdate === void 0 || onUpdate(localizedTime);
+    }, refreshInterval);
+
+    // 清除定时器
+    return function () {
+      clearInterval(timer);
+    };
+  }, [refreshInterval, disabled, dayjsLocale, onUpdate]);
+
+  // 当 locale 改变时，立即更新时间的 locale
+  useEffect(function () {
+    setCurrentTime(function (prevTime) {
+      return prevTime.locale(dayjsLocale);
+    });
+  }, [dayjsLocale]);
+  return currentTime;
+}

package/es/components/pisellDateTimeDisplay/index.js

@@ -0,0 +1,2 @@
+export { default as PisellDateTimeDisplay } from "./PisellDateTimeDisplay";
+export { default } from "./PisellDateTimeDisplay";

package/es/components/pisellDateTimeDisplay/types.js

@@ -0,0 +1 @@
+export {};

package/es/components/pisellDateTimeDisplay/utils/formatDate.js

@@ -0,0 +1,148 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { isChinese as checkIsChinese } from "./localeUtils";
+
+/**
+ * 格式化日期
+ * @param date dayjs 日期对象
+ * @param config 日期格式配置
+ * @returns 格式化后的日期字符串
+ *
+ * @example
+ * // 英文环境
+ * formatDate(dayjs(), { order: 'YMD', shortMonth: true, showYear: true })
+ * // => "2026-Mar-21"
+ *
+ * // 中文环境
+ * formatDate(dayjs(), { order: 'YMD', showChineseUnit: true, showYear: true })
+ * // => "2026年3月21日"
+ *
+ * formatDate(dayjs(), { order: 'MDY', shortMonth: false, showYear: true })
+ * // => "March 21, 2026"
+ */
+export function formatDate(date, config) {
+  var _ref = config || {},
+    _ref$order = _ref.order,
+    order = _ref$order === void 0 ? 'YMD' : _ref$order,
+    _ref$shortMonth = _ref.shortMonth,
+    shortMonth = _ref$shortMonth === void 0 ? true : _ref$shortMonth,
+    _ref$numericMonth = _ref.numericMonth,
+    numericMonth = _ref$numericMonth === void 0 ? false : _ref$numericMonth,
+    _ref$showChineseUnit = _ref.showChineseUnit,
+    showChineseUnit = _ref$showChineseUnit === void 0 ? false : _ref$showChineseUnit,
+    _ref$separator = _ref.separator,
+    separator = _ref$separator === void 0 ? '-' : _ref$separator,
+    _ref$showYear = _ref.showYear,
+    showYear = _ref$showYear === void 0 ? false : _ref$showYear,
+    _ref$showMonth = _ref.showMonth,
+    showMonth = _ref$showMonth === void 0 ? true : _ref$showMonth,
+    _ref$showDay = _ref.showDay,
+    showDay = _ref$showDay === void 0 ? true : _ref$showDay,
+    _ref$useCommaBeforeYe = _ref.useCommaBeforeYear,
+    useCommaBeforeYear = _ref$useCommaBeforeYe === void 0 ? true : _ref$useCommaBeforeYe;
+
+  // 判断是否为中文环境
+  var locale = date.locale();
+  var isChinese = checkIsChinese(locale);
+
+  // 构建格式化字符串的各部分
+  var parts = [];
+
+  // 年份格式
+  var yearFormat = isChinese && showChineseUnit ? 'YYYY年' : 'YYYY';
+
+  // 月份格式
+  var monthFormat = '';
+  if (numericMonth) {
+    // 数字月份
+    monthFormat = isChinese && showChineseUnit ? 'M月' : 'MM';
+  } else {
+    // 文本月份（英文）或数字月份（中文）
+    if (isChinese) {
+      monthFormat = showChineseUnit ? 'M月' : 'M';
+    } else {
+      monthFormat = shortMonth ? 'MMM' : 'MMMM';
+    }
+  }
+
+  // 日期格式
+  var dayFormat = isChinese && showChineseUnit ? 'D日' : 'DD';
+
+  // 根据日期顺序组装
+  switch (order) {
+    case 'YMD':
+      if (showYear) parts.push(yearFormat);
+      if (showMonth) parts.push(monthFormat);
+      if (showDay) parts.push(dayFormat);
+      break;
+    case 'MDY':
+      if (showMonth) parts.push(monthFormat);
+      if (showDay) parts.push(dayFormat);
+      if (showYear) parts.push(yearFormat);
+      break;
+    case 'DMY':
+      if (showDay) parts.push(dayFormat);
+      if (showMonth) parts.push(monthFormat);
+      if (showYear) parts.push(yearFormat);
+      break;
+  }
+
+  // 如果没有要显示的部分，返回空字符串
+  if (parts.length === 0) {
+    return '';
+  }
+
+  // 中文且有单位时，直接连接（不使用分隔符）
+  if (isChinese && showChineseUnit) {
+    return date.format(parts.join(''));
+  }
+
+  // MDY 格式特殊处理（英文习惯）Mar 21, 2026
+  if (order === 'MDY' && !isChinese) {
+    var formatted = date.format(parts.join(' '));
+    if (showYear && showMonth && showDay) {
+      var _formatted$split = formatted.split(' '),
+        _formatted$split2 = _slicedToArray(_formatted$split, 3),
+        month = _formatted$split2[0],
+        day = _formatted$split2[1],
+        year = _formatted$split2[2];
+      return "".concat(month, " ").concat(day, ", ").concat(year);
+    }
+    if (showYear && showDay && !showMonth) {
+      var _formatted$split3 = formatted.split(' '),
+        _formatted$split4 = _slicedToArray(_formatted$split3, 2),
+        _day = _formatted$split4[0],
+        _year = _formatted$split4[1];
+      return "".concat(_day, ", ").concat(_year);
+    }
+    return formatted;
+  }
+
+  // DMY 格式英文：21 Mar, 2026 或 22 Jan 2025（useCommaBeforeYear 控制）
+  if (order === 'DMY' && !isChinese) {
+    var _formatted = date.format(parts.join(' '));
+    if (showYear && showMonth && showDay && useCommaBeforeYear) {
+      var _formatted$split5 = _formatted.split(' '),
+        _formatted$split6 = _slicedToArray(_formatted$split5, 3),
+        _day2 = _formatted$split6[0],
+        _month = _formatted$split6[1],
+        _year2 = _formatted$split6[2];
+      return "".concat(_day2, " ").concat(_month, ", ").concat(_year2);
+    }
+    if (showYear && showDay && !showMonth && useCommaBeforeYear) {
+      var _formatted$split7 = _formatted.split(' '),
+        _formatted$split8 = _slicedToArray(_formatted$split7, 2),
+        _day3 = _formatted$split8[0],
+        _year3 = _formatted$split8[1];
+      return "".concat(_day3, ", ").concat(_year3);
+    }
+    return _formatted;
+  }
+
+  // 其他情况使用分隔符
+  return date.format(parts.join(separator));
+}

package/es/components/pisellDateTimeDisplay/utils/formatDateOrRelative.js

@@ -0,0 +1,38 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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 { formatDate } from "./formatDate";
+import { formatWeekday } from "./formatWeekday";
+import { getRelativeDay, getRelativeDayLabel } from "./relativeDay";
+
+/**
+ * 获取「日期部分」的展示文案（相对日内置在 datetime）
+ * - 若开启 showRelativeDay 且日期为今天/昨天/明天，返回相对日文案（如「今天」「Yesterday」）
+ * - 否则返回「星期, 日期」格式（用于时间区间跨天等场景）
+ *
+ * 供 PisellDateTimeDisplay、PisellTimeRangeDisplay 等统一使用，相对时间逻辑只在此处维护
+ */
+export function getDatePartDisplay(params) {
+  var date = params.date,
+    dateFormat = params.dateFormat,
+    weekdayFormat = params.weekdayFormat,
+    referenceDate = params.referenceDate,
+    dateFormatOverride = params.dateFormatOverride;
+  if (dateFormat !== null && dateFormat !== void 0 && dateFormat.showRelativeDay) {
+    var rel = getRelativeDay(date, referenceDate);
+    if (rel) {
+      var _labels$rel;
+      var labels = dateFormat.relativeDayLabels;
+      return (_labels$rel = labels === null || labels === void 0 ? void 0 : labels[rel]) !== null && _labels$rel !== void 0 ? _labels$rel : getRelativeDayLabel(rel, date.locale());
+    }
+  }
+  var mergedDateConfig = _objectSpread(_objectSpread({}, dateFormat), dateFormatOverride);
+  var weekdayStr = formatWeekday(date, _objectSpread(_objectSpread({}, weekdayFormat), {}, {
+    trailingComma: true
+  }));
+  var dateStr = formatDate(date, mergedDateConfig);
+  return "".concat(weekdayStr, " ").concat(dateStr);
+}

package/es/components/pisellDateTimeDisplay/utils/formatTime.js

@@ -0,0 +1,44 @@
+/**
+ * 格式化时间
+ * @param time dayjs 时间对象
+ * @param config 时间格式配置
+ * @returns 格式化后的时间字符串
+ *
+ * @example
+ * formatTime(dayjs(), { use12Hour: false, showSeconds: false, padHour: false })
+ * // => "13:45"
+ *
+ * formatTime(dayjs(), { use12Hour: true, showSeconds: false, padHour: true })
+ * // => "01:45 PM"
+ *
+ * formatTime(dayjs(), { use12Hour: false, showSeconds: true, padHour: false })
+ * // => "13:45:30"
+ */
+export function formatTime(time, config) {
+  var _ref = config || {},
+    _ref$use12Hour = _ref.use12Hour,
+    use12Hour = _ref$use12Hour === void 0 ? false : _ref$use12Hour,
+    _ref$showSeconds = _ref.showSeconds,
+    showSeconds = _ref$showSeconds === void 0 ? false : _ref$showSeconds,
+    _ref$padHour = _ref.padHour,
+    padHour = _ref$padHour === void 0 ? false : _ref$padHour,
+    _ref$onlyShowHour = _ref.onlyShowHour,
+    onlyShowHour = _ref$onlyShowHour === void 0 ? false : _ref$onlyShowHour;
+
+  // 只显示小时
+  if (onlyShowHour) {
+    return padHour ? time.format('HH') : time.format('H');
+  }
+
+  // 12小时制
+  if (use12Hour) {
+    var _hourFormat = padHour ? 'hh' : 'h';
+    var _timeFormat = showSeconds ? "".concat(_hourFormat, ":mm:ss A") : "".concat(_hourFormat, ":mm A");
+    return time.format(_timeFormat);
+  }
+
+  // 24小时制（默认）
+  var hourFormat = padHour ? 'HH' : 'H';
+  var timeFormat = showSeconds ? "".concat(hourFormat, ":mm:ss") : "".concat(hourFormat, ":mm");
+  return time.format(timeFormat);
+}

package/es/components/pisellDateTimeDisplay/utils/formatWeekday.js

@@ -0,0 +1,62 @@
+import { isChinese as checkIsChinese } from "./localeUtils";
+
+/**
+ * 格式化星期
+ * @param weekday dayjs 日期对象
+ * @param config 星期格式配置
+ * @returns 格式化后的星期字符串
+ *
+ * @example
+ * // 英文环境
+ * formatWeekday(dayjs(), { full: false, singleLetter: false })
+ * // => "Sat"
+ *
+ * formatWeekday(dayjs(), { full: true })
+ * // => "Saturday"
+ *
+ * formatWeekday(dayjs(), { singleLetter: true })
+ * // => "S"
+ *
+ * // 中文环境
+ * formatWeekday(dayjs(), { full: false, singleLetter: false })
+ * // => "周六"
+ *
+ * formatWeekday(dayjs(), { full: true })
+ * // => "星期六"
+ *
+ * formatWeekday(dayjs(), { singleLetter: true })
+ * // => "六"
+ */
+export function formatWeekday(weekday, config) {
+  var _ref = config || {},
+    _ref$full = _ref.full,
+    full = _ref$full === void 0 ? false : _ref$full,
+    _ref$singleLetter = _ref.singleLetter,
+    singleLetter = _ref$singleLetter === void 0 ? false : _ref$singleLetter,
+    _ref$trailingComma = _ref.trailingComma,
+    trailingComma = _ref$trailingComma === void 0 ? false : _ref$trailingComma;
+
+  // 判断是否为中文环境
+  var locale = weekday.locale();
+  var isChinese = checkIsChinese(locale);
+  var appendComma = function appendComma(s) {
+    return trailingComma ? isChinese ? "".concat(s, "\uFF0C") : "".concat(s, ",") : s;
+  };
+
+  // 单字母展示
+  if (singleLetter) {
+    if (isChinese) {
+      var weekdayMap = ['日', '一', '二', '三', '四', '五', '六'];
+      return appendComma(weekdayMap[weekday.day()]);
+    }
+    return appendComma(weekday.format('dd').charAt(0));
+  }
+
+  // 完整展示
+  if (full) {
+    return appendComma(weekday.format('dddd'));
+  }
+
+  // 默认（缩写）ddd: 周一 / Mon
+  return appendComma(weekday.format('ddd'));
+}

package/es/components/pisellDateTimeDisplay/utils/getRefreshInterval.js

@@ -0,0 +1,28 @@
+/**
+ * 根据时间格式配置计算刷新间隔
+ * @param timeFormat 时间格式配置
+ * @returns 刷新间隔（毫秒）
+ *
+ * @description
+ * - 显示秒时：1000ms (1秒刷新一次)
+ * - 不显示秒时：60000ms (60秒刷新一次)
+ *
+ * @example
+ * getRefreshInterval({ showSeconds: true })
+ * // => 1000
+ *
+ * getRefreshInterval({ showSeconds: false })
+ * // => 60000
+ */
+export function getRefreshInterval(timeFormat) {
+  var _timeFormat$showSecon;
+  var showSeconds = (_timeFormat$showSecon = timeFormat === null || timeFormat === void 0 ? void 0 : timeFormat.showSeconds) !== null && _timeFormat$showSecon !== void 0 ? _timeFormat$showSecon : false;
+
+  // 显示秒时 1 秒刷新
+  if (showSeconds) {
+    return 1000;
+  }
+
+  // 否则 60 秒刷新
+  return 60000;
+}