GWORLDCLOCK(1)

📦 version 1.5.0, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GWORLDCLOCK(1) 💖

okay bestie, sit down, hydrate, because we're about to talk about gworldclock — a whole entire command from section 1 of the manual, and it's literally the cutest way to spy on what time it is in, like, every time zone at once 🕐✨

🌍 NAME 🌍

gworldclock — it displays the time and the date in whatever time zones you tell it to. that's it. that's the job. 💅

✨ SYNOPSIS ✨

gworldclock [ -f FILE ]

one tiny optional flag. she's low maintenance. 🎀

🦋 DESCRIPTION 🦋

so here's the tea: gworldclock shows you the time and the date of whatever time zones you pick, and it does it through a GTK+ interface. yes, an actual graphical window. not me being cute in a terminal for once 😭

and the iconic part? you can "rendezvous" or "synchronise" those zones to a time that is not the current time. so if your bestie is in Tokyo and you're planning a call, you can vibe-check the whole thing before you commit. main character scheduling energy fr fr 👑

where do the zones come from, you ask? you pick them from the list that's right there in the GUI user interface. and that list of available zones is generated from the data living in:

/usr/share/zoneinfo/zone.tab

that's the source of truth, no cap. 🗺️

the set of zones you chose gets stored in ${HOME}/.tzlist by default. but if you want it somewhere else, you can hand it an alternate file right there on the command line with -f. 💫

and okay, plot twist — you can also just make that file by hand in TZ format. DIY queen behavior, we love to see it 🫶

the zone list is kept in a format that's consistent with the shell script tzwatch, which currently lives in twclock. (iykyk 😌)

so what does that format actually look like? it's literally: one TZ string per line, and then optionally after that, a human-friendly string wrapped up in inverted commas (") that gives the zone a name. so it reads like a lil name tag for your time zone 🏷️

🎀 OPTIONS 🎀

  • -f FILE — read the zone list from FILE instead of from ${HOME}/.tzlist. that's the whole flag. she's simple, she's effective, she's serving 💅

👀 SEE ALSO 👀

  • tzwatch (1)

go give her a look too, bestie, they're a matching set 🦋

💜 AUTHOR 💜

gworldclock was written by Drew Parsons <dparsons@debian.org>. absolute legend, we stan 🌈⭐

and that's a wrap, babes! this page is from 28 September 2003 and it's part of the GWORLDCLOCK(1) manual — so if you ever forget a detail, she's right there waiting for you. go forth and schedule across time zones like the icon you are 👑💖

📦 where this page comes from