help: Add a dedicated page on how to format global times.

This commit is contained in:
David Rosa 2023-03-14 20:29:06 -06:00 committed by Tim Abbott
parent 5c0e7ca43c
commit 8c1e1f3f89
5 changed files with 43 additions and 21 deletions

View File

@ -100,28 +100,9 @@ whenever you need a reminder of the formatting syntax below.
## Global times ## Global times
When collaborating with people in another time zone, you often need to {!global-times-intro.md!}
express a specific time clearly. Rather than typing out your time zone
and having everyone translate the time in their heads, in Zulip, you
can mention a time, and it'll be displayed to each user in their own
time zone (just like the timestamps on Zulip messages).
A date picker will appear once you type `<time`. {!global-times-examples.md!}
```
Our next meeting is scheduled for <time:2020-05-28T13:30:00+05:30>
```
A person in San Francisco will see:
> Our next meeting is scheduled for *Thu, May 28 2020, 1:00 AM*.
While someone in India will see:
> Our next meeting is scheduled for *Thu, May 28 2020, 1:30 PM*.
You can also use other formats such as UNIX timestamps or human readable
dates, for example, `<time:May 28 2020, 1:30 PM IST>`.
## Tables ## Tables

13
help/global-times.md Normal file
View File

@ -0,0 +1,13 @@
# Global times
{!global-times-intro.md!}
## Examples
{!global-times-examples.md!}
## Related articles
* [Message formatting](/help/format-your-message-using-markdown)
* [Preview messages before sending](/help/preview-your-message-before-sending)
* [Resize the compose box](/help/resize-the-compose-box)

View File

@ -0,0 +1,22 @@
### What you type
A date picker will appear once you type `<time`.
```
Our next meeting is scheduled for <time:2020-05-28T13:30:00+05:30>
```
!!! tip ""
You can also use other formats such as UNIX timestamps or human readable
dates, for example, `<time:May 28 2020, 1:30 PM IST>`.
### What it looks like
A person in San Francisco will see:
> Our next meeting is scheduled for *Thu, May 28 2020, 1:00 AM*.
While someone in India will see:
> Our next meeting is scheduled for *Thu, May 28 2020, 1:30 PM*.

View File

@ -0,0 +1,5 @@
When collaborating with people in different time zones, you often need to
express a specific time clearly. In Zulip, rather than typing out your time
zone and having everyone translate the time in their heads, you can insert
a time, and it will be displayed to each user in their own time zone (just
like timestamps on Zulip messages).

View File

@ -71,6 +71,7 @@
* [Spoilers](/help/spoilers) * [Spoilers](/help/spoilers)
* [/me action messages](/help/me-action-messages) * [/me action messages](/help/me-action-messages)
* [Create a poll](/help/create-a-poll) * [Create a poll](/help/create-a-poll)
* [Global times](/help/global-times)
* [Start a video call](/help/start-a-call) * [Start a video call](/help/start-a-call)
## Sending messages ## Sending messages