tzselect(8)

✨ tzselect(8) ✨

System Manager's Manual 💅 okay so this is the page for tzselect, the manual name is tzselect(8) and it's giving helpful tool. 🎀

🌸 NAME 🌸

tzselect — select a timezone 🌍

🧚 SYNOPSIS 🧚

tzselect [ -c coord ] [ -n limit ] [ --help ] [ --version ]

💖 DESCRIPTION 💖

okay so tzselect basically asks you a bunch of questions about where you are, then spits out the timezone you picked to standard output. ✨ The result is perfect as a value for the TZ environment variable, so you can literally just drop it in and slay. 💅

Everything you type gets handled through standard input and standard error, so it's all just you and the program chatting. 🫶

🦋 OPTIONS 🦋

• -c coord — ngl this one is so cool 😭 Instead of walking through continent, then country, then city, you give it coordinates and it shows you time zones whose biggest cities are closest to that spot. 🌈 The coordinates use ISO 6709 notation, so latitude first, immediately followed by longitude. Both are signed integers with an optional decimal point and fraction: positive means north and east, negative means south and west. Latitudes with two integer digits and longitudes with three are read as degrees. Latitudes with four or six integer digits and longitudes with five or seven are read as DDMM, DDDMM, DDMMSS, or DDDMMSS, meaning DD or DDD degrees, MM minutes, and zero or SS seconds. Any trailing fractions are fractional minutes, or fractional seconds if SS is there. The decimal point is whatever your current locale uses. 🙈 In the default C locale, -c +40.689-074.045 means 40.689 degrees N, 74.045 degrees W. -c +4041.4-07402.7 means 40 degrees 41.4 minutes N, 74 degrees 2.7 minutes W. And -c +404121-0740240 means 40 degrees 41 minutes 21 seconds N, 74 degrees 2 minutes 40 seconds W. If your coord isn't one of these documented forms, the behavior is unspecified, so like, don't go there. 💀
• -n limit — when you're using -c, this decides how many nearby locations get displayed. The default is 10. 🍓
• --help — shows help info and exits. 🫶
• --version — shows version info and exits. ✨

🌈 ENVIRONMENT VARIABLES 🌈

• AWK — the name of a POSIX-compliant awk program. Defaults to awk. 💜
• TZDIR — the name of the directory holding the timezone data files. Defaults to /usr/share/zoneinfo. 🗂️

🍓 FILES 🍓

• TZDIR/iso3166.tab — table of ISO 3166 2-letter country codes and country names. 🌎
• TZDIR/zone1970.tab — table of country codes, latitude and longitude, timezones, and descriptive comments. 📍
• TZDIR/TZ — the timezone data file for timezone TZ. ⭐

🔥 EXIT STATUS 🔥

If tzselect successfully gets a timezone out of the user, the exit status is zero. Otherwise it's nonzero. 👑

🧚 SEE ALSO 🧚

newctime(3), tzfile(5), zdump(8), zic(8) 📚

🙈 NOTES 🙈

Heads up bestie: applications should not assume that tzselect's output matches the user's political preferences. 🚩

---

Source: Time Zone Database. Page: tzselect(8). Stay iconic and keep those timezones straight! 🦋💖✨