Skip to content

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.

3.8 KB
Raw Blame
/**
 * Utility functions for timezone conversions and display
 */

/**
 * Format a date/time in the user's timezone with timezone indicator
 * @param date - The date to format (can be string or Date)
 * @param timezone - The IANA timezone identifier (e.g., "America/New_York")
 * @param options - Intl.DateTimeFormat options
 * @returns Formatted date string with timezone
 */
export function formatInTimezone(
  date: string | Date,
  timezone: string,
  options?: Intl.DateTimeFormatOptions,
): string {
  const dateObj = typeof date === "string" ? new Date(date) : date;

  const defaultOptions: Intl.DateTimeFormatOptions = {
    year: "numeric",
    month: "short",
    day: "numeric",
    hour: "2-digit",
    minute: "2-digit",
    ...options,
  };

  try {
    return new Intl.DateTimeFormat("en-US", {
      ...defaultOptions,
      timeZone: timezone === "not-set" ? undefined : timezone,
    }).format(dateObj);
  } catch {
    // Fallback to local timezone if invalid timezone
    console.warn(`Invalid timezone "${timezone}", using local timezone`);
    return new Intl.DateTimeFormat("en-US", defaultOptions).format(dateObj);
  }
}

/**
 * Get the timezone abbreviation (e.g., "EST", "PST")
 * @param timezone - The IANA timezone identifier
 * @returns Timezone abbreviation
 */
export function getTimezoneAbbreviation(timezone: string): string {
  if (timezone === "not-set" || !timezone) {
    return "";
  }

  try {
    const date = new Date();
    const tzAbbr = new Intl.DateTimeFormat("en-US", {
      timeZone: timezone,
      timeZoneName: "short",
    })
      .formatToParts(date)
      .find((part) => part.type === "timeZoneName")?.value;

    return tzAbbr || timezone;
  } catch {
    return timezone;
  }
}

/**
 * Format time for schedule display with timezone context
 * @param nextRunTime - The next run time (UTC)
 * @param displayTimezone - The timezone to display the time in (typically user's timezone)
 * @returns Formatted string in the specified timezone
 */
export function formatScheduleTime(
  nextRunTime: string | Date,
  displayTimezone: string = "UTC",
): string {
  const date =
    typeof nextRunTime === "string" ? new Date(nextRunTime) : nextRunTime;

  // Use provided timezone for display, fallback to UTC
  const formatted = formatInTimezone(date, displayTimezone, {
    month: "short",
    day: "numeric",
    hour: "2-digit",
    minute: "2-digit",
    timeZoneName: "short",
  });

  return formatted;
}

/**
 * Get a human-readable timezone name
 * @param timezone - IANA timezone identifier
 * @returns Human-readable name
 */
export function getTimezoneDisplayName(timezone: string): string {
  if (timezone === "not-set") {
    return "Not set";
  }

  if (timezone === "UTC") {
    return "UTC";
  }

  // Convert America/New_York to "New York (EST)"
  try {
    const parts = timezone.split("/");
    const city = parts[parts.length - 1].replace(/_/g, " ");
    const abbr = getTimezoneAbbreviation(timezone);
    if (abbr && abbr !== timezone) {
      return `${city} (${abbr})`;
    }
    // If abbreviation is same as timezone or not found, show timezone with underscores replaced
    const timezoneDisplay = timezone.replace(/_/g, " ");
    return `${city} (${timezoneDisplay})`;
  } catch {
    return timezone.replace(/_/g, " ");
  }
}

/**
 * Get the GMT offset for a given timezone, e.g. "GMT+9" or "UTC"
 */
export function getTimezoneGmtOffset(timezone: string): string {
  if (timezone === "not-set" || !timezone) return "";
  try {
    const date = new Date();
    const formatted = new Intl.DateTimeFormat("en-US", {
      timeZone: timezone,
      timeZoneName: "short",
    }).format(date);

    // Common outputs look like "1/1/2024, GMT+9" or "1/1/2024, UTC"
    const match = formatted.match(/(GMT[+\-]\d{1,2}|UTC)/i);
    return match ? match[0].toUpperCase() : "";
  } catch {
    return "";
  }
}