+ jRt^RIHt^RIHtHtHt^RIHtHt]'d ^RI H t H t RRlt RRlt R R ltR R ltR RltRRlt.ROtR#)z Utility functions for icalendar.) annotations)datedatetimetzinfo) TYPE_CHECKINGcast) TypeGuardTypeIsc V^8dQhRRRR/#)dtdate | datetimereturnbool)formats"N/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/tools.py __annotate__r sAAADAc\\V\4;'d\V\4'*#)aDCheck if a value is a date but not a datetime. This function distinguishes between ``date`` and ``datetime`` objects, returning ``True`` only for pure ``date`` instances. Parameters: dt: The date or datetime object to check. Returns: ``True`` if the value is a ``date`` but not a ``datetime``, ``False`` otherwise. Example: .. code-block:: pycon >>> from datetime import date, datetime >>> from icalendar.tools import is_date >>> is_date(date(2024, 1, 15)) True >>> is_date(datetime(2024, 1, 15, 10, 30)) False ) isinstancerrr s&ris_dater s#. b$  @ @ 2x(@$@@rc V^8dQhRRRR/#)r r r rzTypeIs[datetime]r)rs"rrr&s$$O$(8$rc"\V\4#)aCheck if a value is a datetime. Parameters: dt: The date or datetime object to check. Returns: ``True`` if the value is a ``datetime``, ``False`` if it is only a ``date``. Example: .. code-block:: pycon >>> from datetime import date, datetime >>> from icalendar.tools import is_datetime >>> is_datetime(datetime(2024, 1, 15, 10, 30)) True >>> is_datetime(date(2024, 1, 15)) False )rrrs&r is_datetimer&s( b( ##rc V^8dQhRRRR/#)r r r rrr)rs"rrr=s  O  rc\V4'd,\VPVPVP4#\ RV4#)aConvert a date to a datetime. If the input is already a ``datetime``, it is returned unchanged. If the input is a ``date``, it is converted to a ``datetime`` at midnight. Parameters: dt: The date or datetime to convert. Returns: A ``datetime`` object. If the input was a ``date``, the time component will be set to midnight (00:00:00). Example: .. code-block:: pycon >>> from datetime import date, datetime >>> from icalendar.tools import to_datetime >>> to_datetime(date(2024, 1, 15)) datetime.datetime(2024, 1, 15, 0, 0) >>> to_datetime(datetime(2024, 1, 15, 10, 30)) datetime.datetime(2024, 1, 15, 10, 30) r)rryearmonthdayrrs&r to_datetimer!=s5.r{{26622  B rc V^8dQhRRRR/#)r tzrrrr)rs"rrrYs # # #4 #rc\VR4#)aOCheck if a timezone is a pytz timezone. pytz timezones require special handling with ``localize()`` and ``normalize()`` methods for correct timezone calculations. Parameters: tz: The timezone info object to check. Returns: ``True`` if the timezone is a pytz timezone (has a ``localize`` attribute), ``False`` otherwise. localize)hasattr)r#s&ris_pytzr'Ys 2z ""rc V^8dQhRRRR/#)r r r rzTypeGuard[datetime]r)rs"rrris U U? U': Urcn\V4;'d$VP;pRJ;'d \V4#)aVCheck if a datetime uses a pytz timezone. This function checks whether the datetime has a timezone attached and whether that timezone is a pytz timezone requiring special handling. Parameters: dt: The date or datetime object to check. Returns: ``True`` if the value is a ``datetime`` with a pytz timezone, ``False`` otherwise. N)rrr')r rs& r is_pytz_dtr*is0 r? T T")) 3D@ T TWV_Trc V^8dQhRRRR/#)r r r rr)rs"rrrys?rc^\V4'dVPPV4#V#)ayNormalize a datetime after calculations when using pytz. pytz requires the ``normalize()`` function to be called after arithmetic operations to correctly adjust the timezone offset, especially around daylight saving time transitions. Parameters: dt: The date or datetime to normalize. Returns: The normalized datetime if it uses pytz, otherwise the input unchanged. )r*r normalizers&rnormalize_pytzr.ys'"~~yy""2&& IrN)rrr'r*r.r!)__doc__ __future__rrrrtypingrricalendar.compatibilityrr rrr!r'r*r.__all__rrrr4sA&"++&9A4$. 8 # U $ r