user/bkdatev

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