diff --git a/news/news/876.feature.1 b/news/news/876.feature.1 new file mode 100644 index 000000000..4668c24d2 --- /dev/null +++ b/news/news/876.feature.1 @@ -0,0 +1 @@ +Created the :attr:`vUTCOffset.ical_value ` property. @GabrielGervasio diff --git a/src/icalendar/prop/dt/utc_offset.py b/src/icalendar/prop/dt/utc_offset.py index d4bb48497..78aa3174a 100644 --- a/src/icalendar/prop/dt/utc_offset.py +++ b/src/icalendar/prop/dt/utc_offset.py @@ -85,6 +85,11 @@ def __init__(self, td: timedelta, /, params: dict[str, Any] | None = None) -> No self.td = td self.params = Parameters(params) + @property + def ical_value(self) -> timedelta: + """UTC offset as a :class:`~datetime.timedelta` according to :rfc:`5545#section-3.3.14`.""" + return self.td + def to_ical(self) -> str: """Return the ical representation.""" return self.format("") diff --git a/src/icalendar/tests/prop/test_unit.py b/src/icalendar/tests/prop/test_unit.py index 0a34e8b4b..4a179911b 100644 --- a/src/icalendar/tests/prop/test_unit.py +++ b/src/icalendar/tests/prop/test_unit.py @@ -300,6 +300,10 @@ def test_prop_vUTCOffset(self): assert vUTCOffset(timedelta(hours=1, minutes=30)).to_ical() == "+0130" + # Test ical_value + assert vUTCOffset(timedelta(hours=2)).ical_value == timedelta(hours=2) + assert vUTCOffset(timedelta(hours=-5)).ical_value == timedelta(hours=-5) + # Support seconds assert ( vUTCOffset(timedelta(hours=1, minutes=30, seconds=7)).to_ical() == "+013007"