feat(TODO.org):Add TODO list
[BK-2020-03.git] / unitproc / bktemp-setTimeZoneEV
index 548e1bf8157248d7ac3d8dc472ff426610789a58..f51e16a787f4d41f934988f5bdf58da91fefeda6 100644 (file)
@@ -8,41 +8,42 @@ try() { "$@" || die "cannot $*"; }
 setTimeZoneEV(){
     # Desc: Set time zone environment variable TZ
     # Usage: setTimeZoneEV arg1
-    # Input: arg1: 'date'-compatible timezone string (ex: "America/New_York")
+    # Version 0.1.3
+    # In : arg1: 'date'-compatible timezone string (ex: "America/New_York")
     #        TZDIR env var (optional; default: "/usr/share/zoneinfo")
-    # Output: exports TZ
+    # Out: exports TZ (env var)
     #         exit code 0 on success
     #         exit code 1 on incorrect number of arguments
     #         exit code 2 if unable to validate arg1
-    # Depends: yell, printenv, bash 5
-    # Tested on: Debian 10
-    ARG1="$1"
-    local tzDir returnState
+    # Depends: bash 5.0.3, printenv 8.30, yell()
+    local tzDir returnState argTimeZone
+
+    argTimeZone="$1";
     if ! [[ $# -eq 1 ]]; then
        yell "ERROR:Invalid argument count.";
        return 1;
-    fi
+    fi;
 
     # Read TZDIR env var if available
     if printenv TZDIR 1>/dev/null 2>&1; then
        tzDir="$(printenv TZDIR)";
     else
        tzDir="/usr/share/zoneinfo";
-    fi
+    fi;
     
     # Validate TZ string
-    if ! [[ -f "$tzDir"/"$ARG1" ]]; then
+    if ! [[ -f "$tzDir"/"$argTimeZone" ]]; then
        yell "ERROR:Invalid time zone argument.";
        return 2;
     else
     # Export ARG1 as TZ environment variable
-       TZ="$ARG1" && export TZ && returnState="true";
-    fi
+       TZ="$argTimeZone" && export TZ && returnState="true";
+    fi;
 
     # Determine function return code
     if [ "$returnState" = "true" ]; then
        return 0;
-    fi
+    fi;
 } # Exports TZ environment variable
 
 #==BEGIN sample code==