Refactor time utility functions for improved type safety and error handling

- Removed deprecated formatDate function.
- Enhanced formatWithZone to support TypeScript types for parameters.
- Updated getTimeZoneOffset to use TypeScript types.
- Improved formatWithDate for better error messages and type safety.

components/TimestampExecution.tsx

@@ -1,5 +1,5 @@
-import {useEffect, useState, useRef, useCallback} from "react";
-import CopyButton from "./CopyButton";
+import { useEffect, useState, useRef, useCallback } from 'react';
+import CopyButton from './CopyButton';
 
 /**
  * 时间戳显示和执行组件
@@ -22,16 +22,16 @@ import CopyButton from "./CopyButton";
 export function TimestampExecution() {
   /** @type {[number, function]} 当前时间戳（毫秒）和更新函数 */
   const [currentTimestamp, setCurrentTimestamp] = useState(() => Math.floor(Date.now()));
-  
+
   /** @type {[boolean, function]} 是否显示毫秒（true=毫秒，false=秒） */
   const [showMilliseconds, setShowMilliseconds] = useState(true);
-  
+
   /** @type {[boolean, function]} 时间戳是否正在自动更新 */
   const [isRunningTimestamp, setIsRunningTimestamp] = useState(true);
-  
+
   /** @type {React.RefObject<NodeJS.Timeout | null>} 定时器引用，用于清理 */
   const timerRef = useRef(null);
-  
+
   /**
    * 计算显示的时间戳值
    * @type {number}
@@ -39,13 +39,13 @@ export function TimestampExecution() {
   const displayTimestamp = showMilliseconds
     ? currentTimestamp
     : Math.floor(currentTimestamp / 1000);
-  
+
   /**
    * 计算单位文本
    * @type {string}
    */
   const unitText = showMilliseconds ? '毫秒' : '秒';
-  
+
   /**
    * 定时更新时间戳的副作用
    * 根据 isRunningTimestamp 和 showMilliseconds 控制定时器的启停和间隔
@@ -56,7 +56,7 @@ export function TimestampExecution() {
       clearInterval(timerRef.current);
       timerRef.current = null;
     }
-    
+
     // 如果需要运行，创建新的定时器
     if (isRunningTimestamp) {
       const interval = showMilliseconds ? 100 : 1000;
@@ -64,7 +64,7 @@ export function TimestampExecution() {
         setCurrentTimestamp(Math.floor(Date.now()));
       }, interval);
     }
-    
+
     // 清理函数
     return () => {
       if (timerRef.current) {
@@ -73,68 +73,68 @@ export function TimestampExecution() {
       }
     };
   }, [isRunningTimestamp, showMilliseconds]);
-  
+
   /**
    * 切换时间戳显示单位（毫秒/秒）
    * @type {function(): void}
    */
   const toggleUnit = useCallback(() => {
-    setShowMilliseconds(prev => !prev);
+    setShowMilliseconds((prev) => !prev);
   }, []);
-  
+
   /**
    * 切换时间戳自动更新状态（启动/停止）
    * @type {function(): void}
    */
   const toggleTimestamp = useCallback(() => {
-    setIsRunningTimestamp(prev => !prev);
+    setIsRunningTimestamp((prev) => !prev);
   }, []);
-  
+
   /**
    * 切换单位按钮的辅助文本
    * @type {string}
    */
   const unitButtonLabel = showMilliseconds ? '切换为秒显示' : '切换为毫秒显示';
-  
+
   /**
    * 启动/停止按钮的辅助文本
    * @type {string}
    */
   const toggleButtonLabel = isRunningTimestamp ? '停止时间戳自动更新' : '开始时间戳自动更新';
-  
+
   /**
    * 启动/停止按钮的显示文本
    * @type {string}
    */
   const toggleButtonText = isRunningTimestamp ? '停止' : '开始';
-  
+
   return (
     <div className="timestamp-container">
       <div className="timestamp-display">
         <span className="timestamp-value">{displayTimestamp}</span>
         <span className="timestamp-unit">{unitText}</span>
       </div>
-      
+
       <div className="timestamp-controls">
         <button
           type="button"
-          className="timestamp-btn action-btn"
+          className="action-btn"
           onClick={toggleUnit}
           aria-label={unitButtonLabel}
           title={unitButtonLabel}
         >
           切换单位
         </button>
-        
+
         <CopyButton
           text={String(currentTimestamp)}
           buttonText="复制时间戳"
           aria-label="复制当前时间戳到剪贴板"
         />
-        
+
         <button
           type="button"
-          className={`timestamp-btn ${isRunningTimestamp ? 'stop-btn' : 'action-btn'}`}
+          className={`${isRunningTimestamp ? 'stop-btn' : 'action-btn'}`}
           onClick={toggleTimestamp}
           aria-label={toggleButtonLabel}
           title={toggleButtonLabel}
@@ -144,4 +144,4 @@ export function TimestampExecution() {
       </div>
     </div>
   );
-}
+}