Add ical_value property to vDatetime

[xxiaoxiong]

This PR adds the ical_value property to vDatetime, contributing to Issue #876.

Changes

• Added ical_value property to vDatetime (src/icalendar/prop/dt/datetime.py)
  • Returns: datetime - The Python datetime object (timezone-aware or naive)
  • Type hint: datetime
  • RFC reference: :rfc:5545#section-3.3.5
  • Includes comprehensive docstring with examples

Tests

• Created test_vDatetime.py with 5 comprehensive test cases:
  • test_ical_value_naive - Tests timezone-naive datetime
  • test_ical_value_aware - Tests timezone-aware datetime
  • test_ical_value_utc - Tests UTC datetime
  • test_ical_value_components - Tests year/month/day/hour/minute/second components
  • test_ical_value_from_ical - Tests with parsed ical strings
• All tests pass: 5 passed

Quality Checks

• Add type hint
• Add docstring with RFC reference
• Add tests for all code paths
• Pass ruff format check
• Pass ruff lint check
• All tests pass

Relates to #876

[read-the-docs-community]

Documentation build overview

📚 icalendar | 🛠️ Build #32600435 | 📁 Comparing 66b0b8e against latest (7357cec)

  🔍 Preview build  

5 files changed · ± 5 modified

± Modified

• 404.html
• genindex.html
• reference/api/icalendar.prop.dt.datetime.html
• reference/api/icalendar.prop.dt.html
• _modules/icalendar/prop/dt/datetime.html