Document time zone-related functionality

[nejmeijer]

My apologies if this is my own error, but I am missing any documentation on specifying the time zone when creating events and calenders. This module seems time zone-aware, but I cannot find any mention of time zones in the online documentation (https://icspy.readthedocs.io/en/stable/). Could it be that such functionality is missing altogether or that it is simply not documented?

The documentation mentions release 0.7.2 from my location.

[N-Coder]

Unfortunately, version 0.7 has only very limited support for timezones. It writes out all timestamps in UTC, while fully supporting parsing of arbitrary timezone information.

Support in version 0.8 (which is in alpha stage on PyPi and the current version on the main branch) is a lot better, but still not fully documented. Some infos can be found here. This should get better at some time, but finishing the code for the new version is still a higher priority.

[nejmeijer]

I tested using version 0.8.0.dev0 and (after some rewriting) it works like a charm. The documentation you linked @N-Coder was in fact enough for me to figure out how to do it, so I regard my problem as solved. Shall I close this issue or would you like to keep it open until 0.8 proper is released?