| 1 | #!/usr/bin/env bash |
| 2 | # Desc: Baltakatei's verbose date command |
| 3 | # Usage: bkdatev [args] |
| 4 | # Example: bkdatev --date="2001-09-11T09:02:59-04" |
| 5 | # Version: 1.0.0 |
| 6 | # Depends: GNU Coreutils 8.32, Bash 3.2.57 |
| 7 | # Ref/Attrib: [1] "ISO 8601". Wikipedia. https://en.wikipedia.org/wiki/ISO_8601 |
| 8 | # [2] "Changing the Locale in Wine" https://stackoverflow.com/a/16428951 |
| 9 | # [3] "Shanghai vs Beijing" https://bugs.launchpad.net/ubuntu/+source/libgweather/+bug/228554 |
| 10 | # Notes: * Check `ls -R /usr/share/zoneinfo` for time zone names. |
| 11 | # * Check `cat /usr/share/i18n/SUPPORTED` for supported locales. |
| 12 | # * For list of valid locales, see: https://manpages.ubuntu.com/manpages/bionic/man3/DateTime::Locale::Catalog.3pm.html |
| 13 | # * Locations chosen for population, personal signifiance, and spatial coverage. |
| 14 | # * For International Atomic Time (TAI), use offsets from UTC provided in `/usr/share/zoneinfo/leap-seconds.list`. |
| 15 | # * Compatibility with macOS may be limited if any arguments |
| 16 | # are provided when running `bkdatev`; e.g. passing a |
| 17 | # `--date` option to `bkdatev` will fail. |
| 18 | |
| 19 | yell() { echo "$0: $*" >&2; } |
| 20 | die() { yell "$*"; exit 111; } |
| 21 | must() { "$@" || die "cannot $*"; } |
| 22 | insertStr() { |
| 23 | # Desc: Inserts a string into another string at a specified position. |
| 24 | # Input: arg1: str str_rec String to receive insertion |
| 25 | # arg2: int pos Insertion position (0 = append to front) |
| 26 | # arg3: str str_ins String to be inserted |
| 27 | # Output: stdout: Combined string |
| 28 | # Version: 0.0.2 |
| 29 | # Depends: BK-2020-03: yell(), die(), must() |
| 30 | # Ref/Attrib: * BK-2020-03: https://gitlab.com/baltakatei/baltakatei-exdev/ |
| 31 | # * Cooper, Mendel. “Advanced Bash-Scripting Guide: Manipulating Strings”. tldp.org https://tldp.org/LDP/abs/html/string-manipulation.html |
| 32 | |
| 33 | local str_rec pos str_ins re len_str_rec; |
| 34 | local pfx_pos_start pfx_len pfx; |
| 35 | local sfx_pos_start sfx_len sfx; |
| 36 | |
| 37 | # Check args |
| 38 | if [[ $# -ne 3 ]]; then |
| 39 | yell "ERROR:Invalid argument count:$#"; |
| 40 | return 1; fi; |
| 41 | re='^[0-9]+$'; |
| 42 | if [[ ! "$2" =~ $re ]]; then |
| 43 | yell "ERROR:Not an int:$2"; |
| 44 | return 1; fi; |
| 45 | str_rec="$1"; |
| 46 | pos="$2"; |
| 47 | str_ins="$3"; |
| 48 | |
| 49 | # Calculate string stats |
| 50 | len_str_rec="${#str_rec}"; |
| 51 | |
| 52 | # Form prefix |
| 53 | pfx_pos_start="0"; |
| 54 | pfx_len="$pos"; |
| 55 | pfx="${str_rec:$pfx_pos_start:$pfx_len}"; |
| 56 | |
| 57 | # Form suffix |
| 58 | sfx_pos_start="$(( pos ))"; |
| 59 | sfx_len="$(( len_str_rec - pos ))"; |
| 60 | sfx="${str_rec:$sfx_pos_start:$sfx_len}"; |
| 61 | |
| 62 | # Print output to stdout |
| 63 | printf "%s%s%s\n" "$pfx" "$str_ins" "$sfx"; |
| 64 | }; # Insert string provided at indicated position via stdout |
| 65 | line_sep() { |
| 66 | # Input: var: n_ln |
| 67 | local skip_every=4; |
| 68 | ((n_ln++)); |
| 69 | if ! ((n_ln % "$skip_every")); then |
| 70 | printf "\n"; |
| 71 | fi; |
| 72 | return 0; |
| 73 | }; # periodically print separating blank line |
| 74 | get_tz_offset() { |
| 75 | # Desc: Get from 'date' the timezone UTC offset in a way |
| 76 | # compatible with both GNU Coreutils and BSD versions. |
| 77 | # Input: env var: TZ (time zone for date; e.g. 'America/Denver') |
| 78 | # args: $@ # passed onto `date` |
| 79 | # Depends: date (GNU Coreutils 8.32 or BSD), rev |
| 80 | local ntz ntz ntz_out; |
| 81 | local last2; |
| 82 | |
| 83 | # Get numeric time zone string in way compatible with GNU Coreutils and BSD |
| 84 | ntz="$(date "+%z" "$@")"; # e.g. "+0530" |
| 85 | |
| 86 | # Check if last two characters are trailing zeros that can be removed. |
| 87 | last2="${ntz:3:2}"; # assumes $ntz is 5 characters (i.e. "±HHMM") |
| 88 | #last2="$(rev <<< $ntz)" && last2="${last2:0:2}" && last2="$(rev <<< "$last2")"; |
| 89 | if [[ "$last2" == "00" ]]; then |
| 90 | ## ntz_out is truncated by 2 characters |
| 91 | len_ntz="${#ntz}"; |
| 92 | len_ntz_out="$(( len_ntz - 2 ))"; |
| 93 | ntz_out=""${ntz:0:$len_ntz_out}; |
| 94 | else |
| 95 | ## ntz_out is ntz with semicolon inserted after HH |
| 96 | ntz_out="$(insertStr "$ntz" 3 ":" )"; |
| 97 | fi; |
| 98 | |
| 99 | # Output via stdout |
| 100 | printf "%s" "$ntz_out"; |
| 101 | }; # Format numeric time zone (for BSD date compatibility) |
| 102 | print_dateline() { |
| 103 | # Input: var: $id |
| 104 | # var: $fs_1 |
| 105 | # var: $fs_2 |
| 106 | # var: $fs_3 |
| 107 | # args: $@ # passed on to `date` |
| 108 | # env var: TZ (time zone for date; e.g. 'America/Denver') |
| 109 | # Output: stdout |
| 110 | # Depends: printf, date |
| 111 | # get_tz_offset() |
| 112 | # Ref/Attrib: * Truncate string in printf https://stackoverflow.com/a/46812677 |
| 113 | local s_1 s_2 s_2_tz s_3 s_4; |
| 114 | |
| 115 | s_1="$id"; |
| 116 | s_2="$(date "$@" "$fs_1")"; # ISO-8601 without numeric timezone |
| 117 | s_3="$(date "$@" "$fs_2")"; # Alternate ISO-8601 expressions |
| 118 | s_4="$(date "$@" "$fs_3")"; # locale-specific date strings |
| 119 | |
| 120 | # Append numeric timezone to $s_2 with appropriate format |
| 121 | # (e.g. '-07' for 'Arizona', '+05:45' for 'Asia/Kathmandu') |
| 122 | s_2_tz="$(get_tz_offset "$@")"; |
| 123 | s_2="$( printf "%s%s" "$s_2" "$s_2_tz" )"; |
| 124 | |
| 125 | printf "%-10.10s %-25.25s (%-20.20s) (%s)" "$s_1" "$s_2" "$s_3" "$s_4"; |
| 126 | printf "\n"; |
| 127 | |
| 128 | unset fs_1 fs_2 fs_3 fs_4; |
| 129 | }; # print line of dates |
| 130 | main() { |
| 131 | n_ln=0; # for line_sep() |
| 132 | unset LC_TIME; # Fall back to time zone-specific locale settings. |
| 133 | |
| 134 | # format strings |
| 135 | fs_iso8601="+%Y-%m-%dT%H:%M:%S"; # typical ISO-8601 without timezone |
| 136 | fs_iso8601_etc="+%G-W%V-%u, %Y-%j"; # alternate ISO-8601 dates |
| 137 | fs_locale="+%Z; %A; %c"; # locale-specific date strings |
| 138 | |
| 139 | # vars for print_dateline() |
| 140 | fs_1="$fs_iso8601"; |
| 141 | fs_2="$fs_iso8601_etc"; |
| 142 | fs_3="$fs_locale"; |
| 143 | |
| 144 | # UTC (pop. (2021): 7,837,000,000) |
| 145 | ( |
| 146 | export TZ=UTC; |
| 147 | id="UTC"; |
| 148 | fs_3="+%s seconds since 1970-01-01T00:00+00"; |
| 149 | print_dateline "$@"; |
| 150 | ); line_sep; |
| 151 | |
| 152 | # Hawaii |
| 153 | ( |
| 154 | export TZ=US/Hawaii; |
| 155 | export LANG="haw-US.UTF8"; |
| 156 | id="HAWAII"; |
| 157 | print_dateline "$@"; |
| 158 | ); line_sep; |
| 159 | |
| 160 | # Los Angeles, USA |
| 161 | ( |
| 162 | export TZ=America/Los_Angeles; |
| 163 | export LANG="en_US.UTF-8"; |
| 164 | id="LOS ANGELES"; |
| 165 | print_dateline "$@"; |
| 166 | ); line_sep; |
| 167 | |
| 168 | # Denver, USA (pop. (2021): 711,463) |
| 169 | ( |
| 170 | export TZ=America/Denver; |
| 171 | export LANG="en_US.UTF-8"; |
| 172 | id="DENVER"; |
| 173 | print_dateline "$@"; |
| 174 | ); line_sep; |
| 175 | |
| 176 | # Chicago, USA (pop. (2021): 711,463) |
| 177 | ( |
| 178 | export TZ=America/Chicago; |
| 179 | export LANG="en_US.UTF-8"; |
| 180 | id="CHICAGO"; |
| 181 | print_dateline "$@"; |
| 182 | ); line_sep; |
| 183 | |
| 184 | # Mexico City, Mexico (pop. (2018): 21,804,515) |
| 185 | ( |
| 186 | export TZ=America/Mexico_City; |
| 187 | export LANG="es_MX.UTF8"; |
| 188 | id="MEXICO CITY"; |
| 189 | print_dateline "$@"; |
| 190 | ); line_sep; |
| 191 | |
| 192 | # Panama City, Panama |
| 193 | ( |
| 194 | export TZ=America/Panama; |
| 195 | export LANG="es_PA.UTF8"; |
| 196 | id="PANAMA CITY"; |
| 197 | print_dateline "$@"; |
| 198 | ); line_sep; |
| 199 | |
| 200 | # New York, USA (pop. (2018): 20,140,470) |
| 201 | ( |
| 202 | export TZ=America/New_York; |
| 203 | export LANG="en_US.UTF-8"; |
| 204 | id="NEW YORK"; |
| 205 | print_dateline "$@"; |
| 206 | ); line_sep; |
| 207 | |
| 208 | # São Paulo, Brazil |
| 209 | ( |
| 210 | export TZ=America/Sao_Paulo; |
| 211 | export LANG="pt_BR.UTF8"; |
| 212 | id="SAO PAULO"; |
| 213 | print_dateline "$@"; |
| 214 | ); line_sep; |
| 215 | |
| 216 | # Buenos Aires |
| 217 | ( |
| 218 | export TZ=America/Argentina/Buenos_Aires; |
| 219 | export LANG="es_AR.UTF8"; |
| 220 | id="BUENOS AIRES"; |
| 221 | print_dateline "$@"; |
| 222 | ); line_sep; |
| 223 | |
| 224 | # London, England |
| 225 | ( |
| 226 | export TZ=Europe/London; |
| 227 | export LANG="en_GB.UTF-8"; |
| 228 | id="LONDON"; |
| 229 | print_dateline "$@"; |
| 230 | ); line_sep; |
| 231 | |
| 232 | # Kinshasa, Africa |
| 233 | ( |
| 234 | export TZ=Africa/Kinshasa; |
| 235 | export LANG="ln_CD.UTF8"; |
| 236 | id="KINSHASA"; |
| 237 | print_dateline "$@"; |
| 238 | ); line_sep; |
| 239 | |
| 240 | # Lagos, Africa |
| 241 | ( |
| 242 | export TZ=Africa/Lagos; |
| 243 | export LANG="en_NG.UTF8"; |
| 244 | id="LAGOS"; |
| 245 | print_dateline "$@"; |
| 246 | ); line_sep; |
| 247 | |
| 248 | # Paris, France |
| 249 | ( |
| 250 | export TZ=Europe/Paris; |
| 251 | export LANG="fr_FR.UTF8"; |
| 252 | id="PARIS"; |
| 253 | print_dateline "$@"; |
| 254 | ); line_sep; |
| 255 | |
| 256 | # Stockholm, Sweden |
| 257 | ( |
| 258 | export TZ=Europe/Stockholm; |
| 259 | export LANG="sv_SE.UTF8"; |
| 260 | id="STOCKHOLM"; |
| 261 | print_dateline "$@"; |
| 262 | ); line_sep; |
| 263 | |
| 264 | # Helsinki, Finland |
| 265 | ( |
| 266 | export TZ=Europe/Helsinki; |
| 267 | export LANG="fi_FI.UTF8"; |
| 268 | id="HELSINKI"; |
| 269 | print_dateline "$@"; |
| 270 | ); line_sep; |
| 271 | |
| 272 | # Cairo, Egypt |
| 273 | ( |
| 274 | export TZ=Africa/Cairo; |
| 275 | export LANG="ar_EG.UTF8"; |
| 276 | id="CAIRO"; |
| 277 | print_dateline "$@"; |
| 278 | ); line_sep; |
| 279 | |
| 280 | # Gaza City, Palestine (pop. (2017): 590,481) |
| 281 | ( |
| 282 | export TZ=Asia/Gaza; |
| 283 | export LANG="ar_JO.UTF-8"; # ar_PS is missing as of 2023-10-18, using ar_JO as closest substitute. |
| 284 | id="GAZA"; |
| 285 | print_dateline "$@"; |
| 286 | ); line_sep; |
| 287 | |
| 288 | # Tel Aviv, Israel (pop. (2021): 467,875) |
| 289 | ( |
| 290 | export TZ=Asia/Tel_Aviv; |
| 291 | export LANG="he_IL.UTF-8"; |
| 292 | id="TEL AVIV"; |
| 293 | print_dateline "$@"; |
| 294 | ); line_sep; |
| 295 | |
| 296 | # Athens (pop. (2020): 3,526,887) |
| 297 | ( |
| 298 | export TZ=Europe/Athens; |
| 299 | export LANG="el_GR.UTF8"; |
| 300 | id="ATHENS"; |
| 301 | print_dateline "$@"; |
| 302 | ); line_sep; |
| 303 | |
| 304 | # Istanbul (pop. (2020): 13,719,061) |
| 305 | ( |
| 306 | export TZ=Asia/Istanbul; |
| 307 | export LANG="tr_TR.UTF8"; |
| 308 | id="ISTANBUL"; |
| 309 | print_dateline "$@"; |
| 310 | ); line_sep; |
| 311 | |
| 312 | # Tehran, Iran |
| 313 | ( |
| 314 | export TZ=Asia/Tehran; |
| 315 | export LANG="fa_IR.UTF8"; |
| 316 | id="TEHRAN"; |
| 317 | print_dateline "$@"; |
| 318 | ); line_sep; |
| 319 | |
| 320 | # Moscow, Russia |
| 321 | ( |
| 322 | export TZ=Europe/Moscow; |
| 323 | export LANG="ru_RU.UTF-8"; |
| 324 | id="MOSCOW"; |
| 325 | print_dateline "$@"; |
| 326 | ); line_sep; |
| 327 | |
| 328 | # Kyiv, Ukraine (pop. (2021): 2,962,180) |
| 329 | ( |
| 330 | export TZ=Europe/Kyiv; |
| 331 | export LANG="uk_UA.UTF-8"; |
| 332 | id="KYIV"; |
| 333 | print_dateline "$@"; |
| 334 | ); line_sep; |
| 335 | |
| 336 | # Delhi, India (pop. (2018): 29,000,000) |
| 337 | ( |
| 338 | export TZ=Asia/Kolkata; |
| 339 | export LANG="hi_IN.UTF-8"; |
| 340 | id="DELHI"; |
| 341 | print_dateline "$@"; |
| 342 | ); line_sep; |
| 343 | |
| 344 | # Jakarta, Indonesia (pop. (2018): 33,430,285) |
| 345 | ( |
| 346 | export TZ=Asia/Jakarta; |
| 347 | export LANG="id_ID.UTF8"; |
| 348 | id="JAKARTA"; |
| 349 | print_dateline "$@"; |
| 350 | ); line_sep; |
| 351 | |
| 352 | # Singapore, Singapore (pop (2018): 5,792,000) |
| 353 | ( |
| 354 | export TZ=Asia/Singapore; |
| 355 | export LANG="en_SG.UTF-8"; |
| 356 | id="SINGAPORE"; |
| 357 | print_dateline "$@"; |
| 358 | ); line_sep; |
| 359 | |
| 360 | # Beijing, China (pop. (2018): 19,618,000) |
| 361 | ( |
| 362 | export TZ=Asia/Shanghai; # [3] |
| 363 | export LANG="zh_CN.UTF-8"; |
| 364 | id="BEIJING"; |
| 365 | print_dateline "$@"; |
| 366 | ); line_sep; |
| 367 | |
| 368 | # Taipei, Taiwan (pop (2019): 7,034,084) |
| 369 | ( |
| 370 | export TZ=Asia/Taipei; # [3] |
| 371 | export LANG="zh_TW.UTF-8"; |
| 372 | id="TAIPEI"; |
| 373 | print_dateline "$@"; |
| 374 | ); line_sep; |
| 375 | |
| 376 | # Tokyo, Japan (pop. (2018): 37,274,000) |
| 377 | ( |
| 378 | export TZ=Asia/Tokyo; |
| 379 | export LANG="ja_JP.UTF8"; |
| 380 | id="TOKYO"; |
| 381 | print_dateline "$@"; |
| 382 | ); line_sep; |
| 383 | |
| 384 | # Seoul, South Korea (pop. (2018): 25,514,000) |
| 385 | ( |
| 386 | export TZ=Asia/Seoul; |
| 387 | export LANG="ko_KR.UTF8"; |
| 388 | id="SEOUL"; |
| 389 | print_dateline "$@"; |
| 390 | ); line_sep; |
| 391 | |
| 392 | # Pyongyang, North Korea |
| 393 | ( |
| 394 | export TZ=Asia/Pyongyang; |
| 395 | export LANG="ko_KP.UTF8"; |
| 396 | id="PYONGYANG"; |
| 397 | print_dateline "$@"; |
| 398 | ); line_sep; |
| 399 | |
| 400 | # Sydney, Australia |
| 401 | ( |
| 402 | export TZ=Australia/Sydney; |
| 403 | export LANG="en_AU.UTF8"; |
| 404 | id="SYDNEY"; |
| 405 | print_dateline "$@"; |
| 406 | ); line_sep; |
| 407 | |
| 408 | # Guam |
| 409 | ( |
| 410 | export TZ=Pacific/Guam; |
| 411 | export LANG="en_GU.UTF8"; |
| 412 | id="GUAM"; |
| 413 | print_dateline "$@"; |
| 414 | ); line_sep; |
| 415 | |
| 416 | # Auckland, New Zealand |
| 417 | ( |
| 418 | export TZ=Pacific/Auckland; |
| 419 | export LANG="en_NZ.UTF8"; |
| 420 | id="AUCKLAND"; |
| 421 | print_dateline "$@"; |
| 422 | ); line_sep; |
| 423 | |
| 424 | return 0; |
| 425 | }; # main program |
| 426 | |
| 427 | main "$@"; |
| 428 | |
| 429 | # Author: Steven Baltakatei Sandoval |
| 430 | # License: GPLv3+ |