@pisell/materials 6.3.25 → 6.3.27

package/lib/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/lib/components/pisellDateTimeDisplay/components/DateDisplay.js

@@ -0,0 +1,71 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/components/DateDisplay.tsx
+var DateDisplay_exports = {};
+__export(DateDisplay_exports, {
+  DateDisplay: () => DateDisplay,
+  default: () => DateDisplay_default
+});
+module.exports = __toCommonJS(DateDisplay_exports);
+var import_react = __toESM(require("react"));
+var import_dayjs = __toESM(require("dayjs"));
+var import_utils = require("../utils");
+var DateDisplay = ({
+  date,
+  format,
+  referenceDate = (0, import_dayjs.default)(),
+  style,
+  className
+}) => {
+  const labels = format == null ? void 0 : format.relativeDayLabels;
+  const relativeDay = (format == null ? void 0 : format.showRelativeDay) ? (0, import_utils.getRelativeDay)(date, referenceDate) : null;
+  const formattedDate = relativeDay ? (labels == null ? void 0 : labels[relativeDay]) ?? (0, import_utils.getRelativeDayLabel)(relativeDay, date.locale()) : (0, import_utils.formatDate)(date, format);
+  if (!formattedDate) {
+    return null;
+  }
+  const inlineStyle = {
+    fontSize: style == null ? void 0 : style.fontSize,
+    fontWeight: style == null ? void 0 : style.fontWeight,
+    color: style == null ? void 0 : style.color,
+    lineHeight: style == null ? void 0 : style.lineHeight
+  };
+  return /* @__PURE__ */ import_react.default.createElement(
+    "span",
+    {
+      className: `pisell-datetime-display-date ${className || ""}`.trim(),
+      style: inlineStyle
+    },
+    formattedDate
+  );
+};
+var DateDisplay_default = DateDisplay;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DateDisplay
+});

package/lib/components/pisellDateTimeDisplay/components/TimeDisplay.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+import type { TimeFormatConfig, TextStyleConfig } from '../types';
+/**
+ * TimeDisplay 组件 Props
+ */
+export interface TimeDisplayProps {
+    /**
+     * 时间对象
+     */
+    time: Dayjs;
+    /**
+     * 时间格式配置
+     */
+    format?: TimeFormatConfig;
+    /**
+     * 文本样式
+     */
+    style?: TextStyleConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * 时间展示组件
+ *
+ * @description
+ * - 格式化并展示时间
+ * - 支持 12/24 小时制
+ * - 支持显示秒
+ * - 支持小时补零
+ *
+ * @example
+ * <TimeDisplay
+ *   time={dayjs()}
+ *   format={{ use12Hour: false, showSeconds: true }}
+ *   style={{ fontSize: 24, fontWeight: 600, color: '#000' }}
+ * />
+ */
+export declare const TimeDisplay: React.FC<TimeDisplayProps>;
+export default TimeDisplay;

package/lib/components/pisellDateTimeDisplay/components/TimeDisplay.js

@@ -0,0 +1,64 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/components/TimeDisplay.tsx
+var TimeDisplay_exports = {};
+__export(TimeDisplay_exports, {
+  TimeDisplay: () => TimeDisplay,
+  default: () => TimeDisplay_default
+});
+module.exports = __toCommonJS(TimeDisplay_exports);
+var import_react = __toESM(require("react"));
+var import_utils = require("../utils");
+var TimeDisplay = ({
+  time,
+  format,
+  style,
+  className
+}) => {
+  const formattedTime = (0, import_utils.formatTime)(time, format);
+  const inlineStyle = {
+    fontSize: style == null ? void 0 : style.fontSize,
+    fontWeight: style == null ? void 0 : style.fontWeight,
+    color: style == null ? void 0 : style.color,
+    lineHeight: style == null ? void 0 : style.lineHeight
+  };
+  return /* @__PURE__ */ import_react.default.createElement(
+    "span",
+    {
+      className: `pisell-datetime-display-time ${className || ""}`.trim(),
+      style: inlineStyle
+    },
+    formattedTime
+  );
+};
+var TimeDisplay_default = TimeDisplay;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TimeDisplay
+});

package/lib/components/pisellDateTimeDisplay/components/WeekdayDisplay.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+import type { WeekdayFormatConfig, TextStyleConfig } from '../types';
+/**
+ * WeekdayDisplay 组件 Props
+ */
+export interface WeekdayDisplayProps {
+    /**
+     * 日期对象（用于获取星期）
+     */
+    weekday: Dayjs;
+    /**
+     * 星期格式配置
+     */
+    format?: WeekdayFormatConfig;
+    /**
+     * 文本样式
+     */
+    style?: TextStyleConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * 星期展示组件
+ *
+ * @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 declare const WeekdayDisplay: React.FC<WeekdayDisplayProps>;
+export default WeekdayDisplay;

package/lib/components/pisellDateTimeDisplay/components/WeekdayDisplay.js

@@ -0,0 +1,64 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/components/WeekdayDisplay.tsx
+var WeekdayDisplay_exports = {};
+__export(WeekdayDisplay_exports, {
+  WeekdayDisplay: () => WeekdayDisplay,
+  default: () => WeekdayDisplay_default
+});
+module.exports = __toCommonJS(WeekdayDisplay_exports);
+var import_react = __toESM(require("react"));
+var import_utils = require("../utils");
+var WeekdayDisplay = ({
+  weekday,
+  format,
+  style,
+  className
+}) => {
+  const formattedWeekday = (0, import_utils.formatWeekday)(weekday, format);
+  const inlineStyle = {
+    fontSize: style == null ? void 0 : style.fontSize,
+    fontWeight: style == null ? void 0 : style.fontWeight,
+    color: style == null ? void 0 : style.color,
+    lineHeight: style == null ? void 0 : style.lineHeight
+  };
+  return /* @__PURE__ */ import_react.default.createElement(
+    "span",
+    {
+      className: `pisell-datetime-display-weekday ${className || ""}`.trim(),
+      style: inlineStyle
+    },
+    formattedWeekday
+  );
+};
+var WeekdayDisplay_default = WeekdayDisplay;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WeekdayDisplay
+});

package/lib/components/pisellDateTimeDisplay/components/index.d.ts

@@ -0,0 +1,6 @@
+export { TimeDisplay } from './TimeDisplay';
+export { DateDisplay } from './DateDisplay';
+export { WeekdayDisplay } from './WeekdayDisplay';
+export type { TimeDisplayProps } from './TimeDisplay';
+export type { DateDisplayProps } from './DateDisplay';
+export type { WeekdayDisplayProps } from './WeekdayDisplay';

package/lib/components/pisellDateTimeDisplay/components/index.js

@@ -0,0 +1,35 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/components/index.tsx
+var components_exports = {};
+__export(components_exports, {
+  DateDisplay: () => import_DateDisplay.DateDisplay,
+  TimeDisplay: () => import_TimeDisplay.TimeDisplay,
+  WeekdayDisplay: () => import_WeekdayDisplay.WeekdayDisplay
+});
+module.exports = __toCommonJS(components_exports);
+var import_TimeDisplay = require("./TimeDisplay");
+var import_DateDisplay = require("./DateDisplay");
+var import_WeekdayDisplay = require("./WeekdayDisplay");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DateDisplay,
+  TimeDisplay,
+  WeekdayDisplay
+});

package/lib/components/pisellDateTimeDisplay/formats/dateTimeDisplayFormats.d.ts

@@ -0,0 +1,7 @@
+import type { DateTimeDisplayFormatPreset } from '../types';
+/**
+ * PisellDateTimeDisplay 按语言预设的格式
+ * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）；默认不展示相对日，可传 dateFormat.showRelativeDay: true 开启
+ * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）；默认不展示相对日，可传 dateFormat.showRelativeDay: true 开启
+ */
+export declare const DATETIME_DISPLAY_FORMATS: Record<string, Partial<DateTimeDisplayFormatPreset>>;

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

@@ -0,0 +1,98 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/formats/dateTimeDisplayFormats.ts
+var dateTimeDisplayFormats_exports = {};
+__export(dateTimeDisplayFormats_exports, {
+  DATETIME_DISPLAY_FORMATS: () => DATETIME_DISPLAY_FORMATS
+});
+module.exports = __toCommonJS(dateTimeDisplayFormats_exports);
+var DATETIME_DISPLAY_FORMATS = {
+  "zh-cn": {
+    dateFormat: {
+      order: "YMD",
+      showYear: true,
+      separator: "-",
+      showChineseUnit: false,
+      showRelativeDay: false
+    },
+    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: false
+    },
+    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: false,
+      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: [" ", " "]
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DATETIME_DISPLAY_FORMATS
+});

package/lib/components/pisellDateTimeDisplay/formats/index.d.ts

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

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

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/formats/index.ts
+var formats_exports = {};
+__export(formats_exports, {
+  DATETIME_DISPLAY_FORMATS: () => import_dateTimeDisplayFormats.DATETIME_DISPLAY_FORMATS
+});
+module.exports = __toCommonJS(formats_exports);
+var import_dateTimeDisplayFormats = require("./dateTimeDisplayFormats");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DATETIME_DISPLAY_FORMATS
+});

package/lib/components/pisellDateTimeDisplay/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useCurrentTime } from './useCurrentTime';
+export type { UseCurrentTimeOptions } from './useCurrentTime';

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

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellDateTimeDisplay/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useCurrentTime: () => import_useCurrentTime.useCurrentTime
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useCurrentTime = require("./useCurrentTime");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCurrentTime
+});

package/lib/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;