fix: timezone handling scheduler workflows

Author: MichielMAnalytics

api/app/clients/tools/structured/Workflow.js

@@ -477,6 +477,49 @@ class WorkflowTool extends Tool {
         );
       }
 
+      // Get user's timezone for schedule conversion
+      let userTimezone = 'UTC'; // Default to UTC
+      try {
+        const { User } = require('~/db/models');
+        const user = await User.findById(userId).select('timezone').lean();
+        if (user && user.timezone) {
+          userTimezone = user.timezone;
+          logger.debug(`[WorkflowTool] Using user timezone: ${userTimezone} for user ${userId}`);
+        }
+      } catch (error) {
+        logger.warn(`[WorkflowTool] Could not get user timezone for ${userId}, using UTC:`, error);
+      }
+
+      // Convert schedule from user timezone to UTC if needed
+      if (triggerType === 'schedule' && scheduleConfig && userTimezone !== 'UTC') {
+        try {
+          const { convertTimeToUTC } = require('~/server/services/Scheduler/utils/cronUtils');
+          
+          // Parse the cron expression (assumes format: minute hour day month weekday)
+          const parts = scheduleConfig.trim().split(/\s+/);
+          if (parts.length === 5) {
+            const [minute, hour, day, month, weekday] = parts;
+            
+            // Only convert if hour and minute are specific values (not wildcards)
+            if (hour !== '*' && minute !== '*' && !hour.includes('/') && !minute.includes('/')) {
+              const hourNum = parseInt(hour);
+              const minuteNum = parseInt(minute);
+              
+              if (!isNaN(hourNum) && !isNaN(minuteNum)) {
+                // Convert to UTC using the same function as frontend
+                const { hour: utcHour, minute: utcMinute } = convertTimeToUTC(hourNum, minuteNum, userTimezone);
+                scheduleConfig = `${utcMinute} ${utcHour} ${day} ${month} ${weekday}`;
+                
+                logger.info(`[WorkflowTool] Converted schedule from ${userTimezone} to UTC: ${hour}:${minute} -> ${utcHour}:${utcMinute}`);
+              }
+            }
+          }
+        } catch (error) {
+          logger.error(`[WorkflowTool] Error converting schedule to UTC:`, error);
+          // Continue with original schedule if conversion fails
+        }
+      }
+
       // Track app connection status for messaging
       let isAppConnected = true;
 

api/server/services/Scheduler/utils/cronUtils.js

@@ -274,6 +274,7 @@ function getTimeUntilExecution(nextRun) {
 
 module.exports = {
   calculateNextRun,
+  convertTimeToUTC,
   validateCronExpression,
   getOverdueTime,
   getTimeUntilExecution,

client/src/components/SidePanel/WorkflowBuilder/Trigger/ScheduleTrigger.tsx

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { ScheduleType } from '../types';
+import { getTimezoneAbbreviation } from '~/utils/timezone';
 
 interface ScheduleTriggerProps {
   scheduleType: ScheduleType;
@@ -13,6 +14,7 @@ interface ScheduleTriggerProps {
   scheduleConfig: string;
   setScheduleConfig: (config: string) => void;
   isTesting: boolean;
+  userTimezone?: string;
 }
 
 const ScheduleTrigger: React.FC<ScheduleTriggerProps> = ({
@@ -27,7 +29,9 @@ const ScheduleTrigger: React.FC<ScheduleTriggerProps> = ({
   scheduleConfig,
   setScheduleConfig,
   isTesting,
+  userTimezone,
 }) => {
+  const timezoneAbbr = userTimezone ? getTimezoneAbbreviation(userTimezone) : '';
   return (
     <div className="space-y-3">
       {/* Schedule Type Selection */}
@@ -58,7 +62,7 @@ const ScheduleTrigger: React.FC<ScheduleTriggerProps> = ({
       {scheduleType !== 'custom' && (
         <div>
           <label className="mb-2 block text-sm font-medium text-text-primary">
-            What time?
+            What time? {timezoneAbbr && <span className="text-xs text-text-secondary">({timezoneAbbr})</span>}
           </label>
           <input
             type="time"
@@ -69,6 +73,11 @@ const ScheduleTrigger: React.FC<ScheduleTriggerProps> = ({
               isTesting ? 'cursor-not-allowed opacity-50' : ''
             }`}
           />
+          {userTimezone && (
+            <p className="mt-1 text-xs text-text-secondary">
+              This workflow will run at {scheduleTime} in your timezone ({userTimezone})
+            </p>
+          )}
         </div>
       )}
 
@@ -141,7 +150,7 @@ const ScheduleTrigger: React.FC<ScheduleTriggerProps> = ({
       {scheduleType === 'custom' && (
         <div>
           <label className="mb-2 block text-sm font-medium text-text-primary">
-            Cron expression
+            Cron expression (UTC)
           </label>
           <input
             type="text"

client/src/components/SidePanel/WorkflowBuilder/Trigger/TriggerPanel.tsx

@@ -40,6 +40,7 @@ interface TriggerPanelProps {
   isLoadingTriggers: boolean;
   filteredAppTriggers: AppTriggerType[];
   isIntegrationConnected: (appSlug: string) => boolean;
+  userTimezone?: string;
 }
 
 const TriggerPanel: React.FC<TriggerPanelProps> = ({
@@ -73,6 +74,7 @@ const TriggerPanel: React.FC<TriggerPanelProps> = ({
   isLoadingTriggers,
   filteredAppTriggers,
   isIntegrationConnected,
+  userTimezone,
 }) => {
   return (
     <div className="space-y-3">
@@ -112,6 +114,7 @@ const TriggerPanel: React.FC<TriggerPanelProps> = ({
               scheduleConfig={scheduleConfig}
               setScheduleConfig={setScheduleConfig}
               isTesting={isTesting}
+              userTimezone={userTimezone}
             />
           )}