Skip to content

Release v0.8.2: Comprehensive DateTime Module Implementation

Choose a tag to compare

View all tags
@jwesleye jwesleye released this 08 Jul 19:35
· 117 commits to main since this release
v0.8.2
4f95f24

🎆 Major Feature Release: Complete DateTime Module

This release introduces a comprehensive DateTime module with 40+ production-ready functions across 6 specialized submodules, providing essential date/time operations for AI agents working with portfolio analysis, financial data, and time-based calculations.

✨ New DateTime Module Features

📅 Core Operations (datetime.operations)

  • Time arithmetic: add_hours(), subtract_hours(), add_minutes(), subtract_minutes()
  • Date arithmetic: add_days(), subtract_days() (existing)
  • Time calculations: calculate_time_difference() with multiple units
  • Current date/time: get_current_datetime(), get_current_date(), get_current_time()
  • Validation: is_valid_iso_date(), is_valid_iso_time(), is_valid_iso_datetime()

📊 Date Range Operations (datetime.ranges)

  • Range generation: get_date_range(), get_month_range(), get_quarter_dates()
  • Time periods: get_year_to_date_range(), get_days_ago(), get_months_ago()
  • Business calculations: get_business_days_in_range(), get_last_business_day()
  • Range validation: is_date_in_range(), calculate_days_between()

💼 Business Day Operations (datetime.business)

  • Business day detection: is_business_day() (excludes weekends)
  • Next business day: get_next_business_day() with weekend handling

🌍 Timezone Operations (datetime.timezone)

  • Timezone conversion: convert_timezone() with DST handling
  • Timezone info: get_timezone_offset(), is_daylight_saving_time()
  • Timezone validation: is_valid_timezone() with comprehensive database

📈 Date Information (datetime.info)

  • Calendar info: get_weekday_name(), get_month_name(), get_week_number()
  • Date calculations: get_day_of_year(), get_days_in_month()
  • Year operations: is_leap_year() with accurate leap year logic

✅ Validation Utilities (datetime.validation)

  • Range validation: validate_date_range(), validate_datetime_range()
  • Format validation: is_valid_date_format() for ISO compliance
  • Temporal validation: is_future_date(), is_past_date()

🎯 Key Technical Achievements

Google ADK Full Compliance

  • ✅ JSON-serializable types only: All functions use str, int, bool, Dict[str, str]
  • ✅ No default parameters: All parameters explicitly required for agent compatibility
  • ✅ Consistent return formats: Standardized ISO string outputs and dictionary structures
  • ✅ Clear error handling: Descriptive exceptions with agent-friendly messages

Production-Ready Quality

  • ✅ Comprehensive testing: 300+ tests with 96%+ coverage across all datetime functions
  • ✅ Agent evaluation: Full compatibility testing with Google ADK agent evaluation framework
  • ✅ Type safety: 100% mypy compliance with strict type checking
  • ✅ Code quality: 100% ruff compliance with automatic formatting

Portfolio Analysis Support

Designed specifically for financial agent prompts like:

  • "Show me portfolio performance from January 1st to June 30th"
  • "Calculate returns for the last 90 business days"
  • "Get quarterly performance data for Q1 2025"
  • "Find the last business day of each month"

🔧 Helper Integration

All datetime functions are automatically available through the helper system:

import basic_open_agent_tools as boat

# Load datetime tools
datetime_tools = boat.load_all_datetime_tools()

# Merge with other tools for comprehensive agent toolkit
agent_tools = boat.merge_tool_lists(
    boat.load_all_filesystem_tools(),
    boat.load_all_text_tools(), 
    boat.load_all_data_tools(),
    datetime_tools
)

📊 Module Statistics

  • Total Functions: 40+ datetime operations
  • Submodules: 6 specialized areas (operations, ranges, business, timezone, info, validation)
  • Test Coverage: 300+ tests with 96%+ coverage
  • Helper Integration: Complete integration with load_all_datetime_tools()
  • Google ADK Compatibility: 100% compliance with agent framework standards

🚀 Framework Compatibility

Compatible with:

  • Google ADK: Direct function imports without signature errors
  • LangChain: Functions wrap seamlessly with StructuredTool
  • Custom Agents: Broad compatibility with simple APIs
  • MCP Servers: Adaptable for Model Context Protocol

🔍 Implementation Standards

  • ISO Format Focus: All date/time inputs and outputs use ISO format strings
  • No Natural Language: Structured input/output only (models handle parsing)
  • Timezone Awareness: Proper handling of DST and timezone databases
  • Business Logic: Financial calendar support with business day calculations
  • Error Resilience: Comprehensive validation and meaningful error messages

🛠️ Technical Details

  • Python Compatibility: 3.8+ with automatic fallbacks for older versions
  • Dependencies: Uses Python standard library (datetime, zoneinfo) with pytz fallback
  • Cross-Platform: Tested on Windows, macOS, and Linux
  • Performance: Optimized for bulk operations and agent workflows

🎆 This release represents a major milestone in the basic-open-agent-tools project, providing a production-ready datetime toolkit that enables sophisticated time-based analysis for AI agents in financial, analytical, and business contexts.

🤖 Generated with Claude Code

Assets 2
Loading