chore: add documentation for useTimeZoneConversion [LIBS-396]

[tomzemp]

Adds documentation for the useTimeZoneConversion hook.

I have tried to cover most applicable use cases without too much additional explanation.

Some other points (like javascript dates sucking and this hopefully becoming irrelevant when temporal is released) might be handled in a blog post @Topener? FYI: The original ticket (LIBS-396) and the PR for the code also has a lot of background discussion.

[tomzemp]

Thanks for the review @Topener. I have fixed the code examples (and added a note to the last one to make it clearer that it is purely an example and shouldn't be copy/pasted).

Would you like to try doing the rewording for the points that you thought could benefit? I think the time zone issues are a bit complicated to communicate in a clear manner, so maybe it would benefit from your attempts to reformulate?

Thanks

[Topener]

@tomzemp yes I'll get on that! Thanks for the improvements

[Topener]

@tomzemp I've improved the text some, please check if I didn't break anything flow wise, otherwise we're good

[tomzemp]

Great. Thanks @Topener 🙏. Could you run prettier on that file as it's now failing the lint check?

[dhis2-bot]

🎉 This PR is included in version 3.9.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• npm package (@latest dist-tag)
• npm package (@latest dist-tag)
• npm package (@latest dist-tag)
• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀