feat(TODO.org):Add TODO list
[BK-2020-03.git] / unitproc / bktemp-setTimeZoneEV
index 8b5370b6125965ff59c113339818c1dc45b179b7..f51e16a787f4d41f934988f5bdf58da91fefeda6 100644 (file)
@@ -8,29 +8,28 @@ try() { "$@" || die "cannot $*"; }
 setTimeZoneEV(){
     # Desc: Set time zone environment variable TZ
     # Usage: setTimeZoneEV arg1
-    # Version 0.1.1
-    # 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
+    # Depends: bash 5.0.3, printenv 8.30, yell()
     local tzDir returnState argTimeZone
 
-    argTimeZone="$1"
+    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"/"$argTimeZone" ]]; then
@@ -39,12 +38,12 @@ setTimeZoneEV(){
     else
     # Export ARG1 as TZ environment variable
        TZ="$argTimeZone" && export TZ && returnState="true";
-    fi
+    fi;
 
     # Determine function return code
     if [ "$returnState" = "true" ]; then
        return 0;
-    fi
+    fi;
 } # Exports TZ environment variable
 
 #==BEGIN sample code==