Add ical_value property to vDate

[xxiaoxiong]

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

Changes

• Added ical_value property to vDate (src/icalendar/prop/dt/date.py)
  • Returns: date - The Python date object
  • Type hint: date
  • RFC reference: :rfc:5545#section-3.3.4
  • Includes comprehensive docstring with examples

Tests

• Created test_vDate.py with 5 comprehensive test cases:
  • test_ical_value_basic - Tests basic date return
  • test_ical_value_components - Tests year/month/day components
  • test_ical_value_from_ical - Tests with parsed ical strings
  • test_ical_value_leap_year - Tests leap year dates
  • test_ical_value_year_boundaries - Tests first/last day of year
• 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 #32600425 | 📁 Comparing 943c638 against latest (7357cec)

  🔍 Preview build  

5 files changed · ± 5 modified

± Modified

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

[stevepiercy]

@xxiaoxiong thank you for opening this PR. Because you haven't responded to the reviews and CI failures, I'm closing all of your PRs to let other contributors know that they are free to work on it. You're welcome to address our comments, resolve the matters, and reopen your pull request at any time, specifically to address the question of AI usage and add a change log, per Contribute. Thank you!