Improve date parsing from search query

Author: ericallam

apps/webapp/app/routes/api.v1.deployments.ts

@@ -126,6 +126,7 @@ export const loader = createLoaderApiRoute(
 );
 
 import parseDuration from "parse-duration";
+import { parseDate } from "@trigger.dev/core/v3/isomorphic";
 
 function getCreatedAtFilter(searchParams: ApiDeploymentListSearchParams) {
   if (searchParams.period) {
@@ -171,8 +172,9 @@ function getCreatedAtFilter(searchParams: ApiDeploymentListSearchParams) {
 }
 
 function safeDateFromString(value: string, paramName: string) {
-  const date = new Date(value);
-  if (isNaN(date.getTime())) {
+  const date = parseDate(value);
+
+  if (!date) {
     throw new ServiceValidationError(`Invalid search query parameter: ${paramName}=${value}`, 400);
   }
   return date;

packages/core/src/v3/isomorphic/dates.ts

@@ -0,0 +1,35 @@
+/**
+ * Attempts to parse a string into a valid Date.
+ *
+ * Supported formats:
+ * - ISO and RFC date strings (e.g. "2025-08-18", "2025-08-18T12:34:56Z")
+ * - Natural language dates supported by JS Date (e.g. "August 18, 2025")
+ * - Epoch seconds (10-digit numeric string, e.g. "1629302400")
+ * - Epoch milliseconds (13-digit numeric string, e.g. "1629302400000")
+ *
+ * @param input The string to parse.
+ * @returns A valid Date object, or undefined if parsing fails.
+ */
+export function parseDate(input: string): Date | undefined {
+  if (typeof input !== "string") return undefined;
+
+  // Handle pure numeric strings as epoch values
+  if (/^\d+$/.test(input)) {
+    const num = Number(input);
+
+    if (input.length === 10) {
+      // Epoch seconds
+      return new Date(num * 1000);
+    } else if (input.length === 13) {
+      // Epoch milliseconds
+      return new Date(num);
+    } else {
+      // Unsupported numeric length
+      return undefined;
+    }
+  }
+
+  // Handle general date strings
+  const date = new Date(input);
+  return isNaN(date.getTime()) ? undefined : date;
+}

packages/core/src/v3/isomorphic/index.ts

@@ -4,3 +4,4 @@ export * from "./maxDuration.js";
 export * from "./queueName.js";
 export * from "./consts.js";
 export * from "./traceContext.js";
+export * from "./dates.js";