@cj-tech-master/excelts 2.0.0-canary.20251228013952.4f2c3c6 → 2.0.0

package/dist/types/utils/datetime.d.ts

@@ -6,6 +6,35 @@
  */
 /** Supported date format strings */
 export type DateFormat = "YYYY-MM-DD[T]HH:mm:ssZ" | "YYYY-MM-DD[T]HH:mm:ss" | "YYYY-MM-DD[T]HH:mm:ss.SSSZ" | "YYYY-MM-DD" | "YYYY-MM-DD HH:mm:ss" | "MM-DD-YYYY" | "MM-DD-YYYY HH:mm:ss" | "MM/DD/YYYY HH:mm:ss" | "DD-MM-YYYY" | "DD-MM-YYYY HH:mm:ss" | "DD/MM/YYYY HH:mm:ss";
+/**
+ * Quick pre-filter to reject non-date strings
+ */
+export declare function mightBeDate(s: string): boolean;
+/**
+ * Parse a date string
+ *
+ * @param value - String to parse
+ * @param formats - Specific formats to try (optional, auto-detects ISO if omitted)
+ * @returns Date object or null
+ *
+ * @example
+ * parseDate("2024-12-26")                    // auto-detect ISO
+ * parseDate("12-26-2024", ["MM-DD-YYYY"])   // explicit US format
+ */
+export declare function parseDate(value: string, formats?: DateFormat[]): Date | null;
+/**
+ * Format a Date to string
+ *
+ * @param date - Date to format
+ * @param format - Format template (optional, defaults to ISO)
+ * @param utc - Use UTC time (default: false)
+ * @returns Formatted string or empty string if invalid
+ *
+ * @example
+ * formatDate(date)                        // "2024-12-26T10:30:00.000+08:00"
+ * formatDate(date, "YYYY-MM-DD", true)   // "2024-12-26"
+ */
+export declare function formatDate(date: Date, format?: string, utc?: boolean): string;
 /**
  * Optimized date parser for batch processing
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "2.0.0-canary.20251228013952.4f2c3c6",
+  "version": "2.0.0",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "type": "module",
   "publishConfig": {