Update app.py

app.py

@@ -796,6 +796,157 @@ def list_files_by_type(directory: str = ".",
 
 
 
+
+
+def get_central_time() -> datetime:
+    """Get current time in US Central timezone."""
+    central = pytz.timezone('US/Central')
+    return datetime.now(central)
+
+def format_timestamp_prefix() -> str:
+    """Generate timestamp prefix in format MM_dd_yy_hh_mm_AM/PM."""
+    ct = get_central_time()
+    return ct.strftime("%m_%d_%y_%I_%M_%p")
+
+def get_formatted_time(dt: datetime = None, 
+                      timezone: str = 'US/Central',
+                      include_timezone: bool = True,
+                      include_seconds: bool = False) -> str:
+    """
+    Format a datetime object with specified options.
+    If no datetime is provided, uses current time.
+    """
+    if dt is None:
+        tz = pytz.timezone(timezone)
+        dt = datetime.now(tz)
+    elif dt.tzinfo is None:
+        tz = pytz.timezone(timezone)
+        dt = tz.localize(dt)
+    
+    format_string = "%Y-%m-%d %I:%M"
+    if include_seconds:
+        format_string += ":%S"
+    format_string += " %p"
+    if include_timezone:
+        format_string += " %Z"
+    
+    return dt.strftime(format_string)
+
+def parse_timestamp(timestamp_str: str, 
+                   timezone: str = 'US/Central') -> Optional[datetime]:
+    """
+    Parse a timestamp string in various formats.
+    Returns timezone-aware datetime object.
+    """
+    try:
+        # Try different format patterns
+        patterns = [
+            "%m_%d_%y_%I_%M_%p",  # Standard app format
+            "%Y-%m-%d %I:%M %p",   # Common 12-hour format
+            "%Y-%m-%d %H:%M",      # 24-hour format
+            "%m/%d/%y %I:%M %p",   # US date format
+            "%d/%m/%y %I:%M %p"    # European date format
+        ]
+        
+        dt = None
+        for pattern in patterns:
+            try:
+                dt = datetime.strptime(timestamp_str, pattern)
+                break
+            except ValueError:
+                continue
+        
+        if dt is None:
+            raise ValueError(f"Could not parse timestamp: {timestamp_str}")
+        
+        # Add timezone if not present
+        if dt.tzinfo is None:
+            tz = pytz.timezone(timezone)
+            dt = tz.localize(dt)
+            
+        return dt
+        
+    except Exception as e:
+        st.error(f"Error parsing timestamp: {str(e)}")
+        return None
+
+def get_time_ago(dt: datetime) -> str:
+    """
+    Convert datetime to human-readable "time ago" format.
+    E.g., "2 hours ago", "3 days ago", etc.
+    """
+    try:
+        now = datetime.now(dt.tzinfo)
+        diff = now - dt
+        
+        seconds = diff.total_seconds()
+        
+        if seconds < 60:
+            return "just now"
+        elif seconds < 3600:
+            minutes = int(seconds / 60)
+            return f"{minutes} minute{'s' if minutes != 1 else ''} ago"
+        elif seconds < 86400:
+            hours = int(seconds / 3600)
+            return f"{hours} hour{'s' if hours != 1 else ''} ago"
+        elif seconds < 604800:
+            days = int(seconds / 86400)
+            return f"{days} day{'s' if days != 1 else ''} ago"
+        elif seconds < 2592000:
+            weeks = int(seconds / 604800)
+            return f"{weeks} week{'s' if weeks != 1 else ''} ago"
+        elif seconds < 31536000:
+            months = int(seconds / 2592000)
+            return f"{months} month{'s' if months != 1 else ''} ago"
+        else:
+            years = int(seconds / 31536000)
+            return f"{years} year{'s' if years != 1 else ''} ago"
+            
+    except Exception as e:
+        st.error(f"Error calculating time ago: {str(e)}")
+        return "unknown time ago"
+
+def format_duration(seconds: float) -> str:
+    """
+    Format a duration in seconds to human-readable string.
+    E.g., "2m 30s", "1h 15m", etc.
+    """
+    try:
+        if seconds < 0:
+            return "invalid duration"
+            
+        # Handle special cases
+        if seconds < 1:
+            return f"{seconds * 1000:.0f}ms"
+        if seconds < 60:
+            return f"{seconds:.1f}s"
+            
+        # Calculate hours, minutes, seconds
+        hours = int(seconds // 3600)
+        minutes = int((seconds % 3600) // 60)
+        secs = seconds % 60
+        
+        # Build duration string
+        parts = []
+        if hours > 0:
+            parts.append(f"{hours}h")
+        if minutes > 0:
+            parts.append(f"{minutes}m")
+        if secs > 0 and hours == 0:  # Only show seconds if less than an hour
+            parts.append(f"{secs:.1f}s")
+            
+        return " ".join(parts)
+        
+    except Exception as e:
+        st.error(f"Error formatting duration: {str(e)}")
+        return "unknown duration"
+
+
+
+
+        
+
+
 # ─────────────────────────────────────────────────────────
 # 4. PAPER PROCESSING & DISPLAY
 # ──────────────────��──────────────────────────────────────