Reference · the tools
time_zone
What it does
The person's time zones: where they live (home), and where they are for now (current), until a date if they say. With nothing given, says what is set. Their boxes follow within a minute or so (a stay's end, within the hour): TZ in every command, and timers with no zone of their own. "I'm in New York until Thursday" is current America/New_York and until that Thursday's date. When they are back, current "home". Ask them rather than guess, and say what you set.
What it needs to know
- home · optional
- Where they live, an IANA zone: "America/Los_Angeles".
- current · optional
- Where they are for now, an IANA zone; or "home" when they are back.
- until · optional
- The last day of it, YYYY-MM-DD in that zone. Omit if they did not say: it lasts until changed.
Where it lands
On the box it names.