From: Steven Baltakatei Sandoval Date: Wed, 1 Jul 2020 03:07:43 +0000 (+0000) Subject: feat(unitprod):Created timeDuration function template X-Git-Tag: 0.2.0~20 X-Git-Url: https://zdv2.bktei.com/gitweb/BK-2020-03.git/commitdiff_plain/7ad273d8b48d1ae0e8d8e3eb5da0637da2bc9d6f?ds=inline;hp=--cc feat(unitprod):Created timeDuration function template Given positive integer seconds as first argument, timeDuration outputs a valid ISO-8601 duration string to stdout. Given positive integer ((precision)) as second argument, timeDuration formats the output string to carry at least ((precision)) number of time division elements (ex: higher precision lengthens output string). --- 7ad273d8b48d1ae0e8d8e3eb5da0637da2bc9d6f diff --git a/unitproc/bktemp-timeDuration b/unitproc/bktemp-timeDuration new file mode 100644 index 0000000..5aac0d5 --- /dev/null +++ b/unitproc/bktemp-timeDuration @@ -0,0 +1,237 @@ +#!/bin/bash + +# Desc: Template to indicate time duration in ISO-8601 format + +yell() { echo "$0: $*" >&2; } # Yell, Die, Try Three-Fingered Claw technique; # Ref/Attrib: https://stackoverflow.com/a/25515370 +die() { yell "$*"; exit 111; } +try() { "$@" || die "cannot $*"; } +timeDuration(){ + # Desc: Output approximate time duration string before given time (default:current date) + # Ref/Attrib: ISO-8601:2004(E), §4.4.4.2 Representations of time intervals by duration and context information + # Note: "1 month" ("P1M") is assumed to be "30 days" (see ISO-8601:2004(E), §2.2.1.2) + # Usage: timeDuration [arg1] ([arg2]) + # Input: arg1: seconds as base 10 integer >= 0 (ex: 3601) + # arg2: precision level (optional; default=2) + # Output: stdout: ISO-8601 duration string (ex: "P1H1S", "P2Y10M15DT10H30M20S") + # Example: 'timeDuration 111111 3' yields 'P1DT6H51M' + # Depends: date 8 (gnucoreutils) + local returnState fullHours fullMinutes fullSeconds; + ARG1="$1"; + ARG2="$2"; + precision=2; # set default precision + returnState="true"; # set default return state + + # Check that between one and two arguments is supplied + if ! { [[ $# -ge 1 ]] && [[ $# -le 2 ]]; }; then + yell "ERROR:Invalid number of arguments:$# . Exiting."; + returnState="ERROR_INPUT"; fi + + # Check that arg1 provided + if [[ $# -ge 1 ]]; then + # Check that arg1 is a positive integer + if [[ "$ARG1" =~ ^[[:digit:]]+$ ]]; then + arg1Valid="true"; + else + yell "ERROR:ARG1 not a digit."; + returnState="ERROR_INPUT"; + arg1Valid="false"; + fi + else + yell "ERROR:No argument provided. Exiting."; + exit 1; + fi + + # Consider whether arg2 was provided + if [[ $# -eq 2 ]]; then + # Check that the second arg is a positive integer + if [[ "$ARG2" =~ ^[[:digit:]]+$ ]] && [[ "ARG2" -gt 0 ]]; then + arg2Valid="true"; + precision="$ARG2"; + else + yell "ERROR:ARG2 not a positive integer. (is $ARG2 ). Leaving early."; + returnState="ERROR_INPUT"; + arg2Valid="false"; + fi; + else + arg2Valid="false"; + fi; + + remainder="$ARG1" ; # seconds + ## Calculate full years Y, update remainder + fullYears=$(( remainder / (365*24*60*60) )); + remainder=$(( remainder - (fullYears*365*24*60*60) )); + #yell "DEBUG:post-Y remainder:$remainder" + #yell "DEBUG:fullYears:$fullYears" + ## Calculate full months M, update remainder + fullMonths=$(( remainder / (30*24*60*60) )); + remainder=$(( remainder - (fullMonths*30*24*60*60) )); + #yell "DEBUG:post-m remainder:$remainder" + #yell "DEBUG:fullMonths:$fullMonths" + ## Calculate full days D, update remainder + fullDays=$(( remainder / (24*60*60) )); + remainder=$(( remainder - (fullDays*24*60*60) )); + #yell "DEBUG:post-d remainder:$remainder" + #yell "DEBUG:fullMonths:$fullDays" + ## Calculate full hours H, update remainder + fullHours=$(( remainder / (60*60) )); + remainder=$(( remainder - (fullHours*60*60) )); + #yell "DEBUG:post-H remainder:$remainder" + #yell "DEBUG:fullHours:$fullHours" + ## Calculate full minutes M, update remainder + fullMinutes=$(( remainder / (60) )); + remainder=$(( remainder - (fullMinutes*60) )); + #yell "DEBUG:post-M remainder:$remainder" + #yell "DEBUG:fullMinutes:$fullMinutes" + ## Calculate full seconds S, update remainder + fullSeconds=$(( remainder / (1) )); + remainder=$(( remainder - (remainder*1) )); + #yell "DEBUG:post-S remainder:$remainder" + #yell "DEBUG:fullSeconds:$fullSeconds" + ## Check which fields filled + if [[ $fullYears -gt 0 ]]; then hasYears="true"; else hasYears="false"; fi + if [[ $fullMonths -gt 0 ]]; then hasMonths="true"; else hasMonths="false"; fi + if [[ $fullDays -gt 0 ]]; then hasDays="true"; else hasDays="false"; fi + if [[ $fullHours -gt 0 ]]; then hasHours="true"; else hasHours="false"; fi + if [[ $fullMinutes -gt 0 ]]; then hasMinutes="true"; else hasMinutes="false"; fi + if [[ $fullSeconds -gt 0 ]]; then hasSeconds="true"; else hasSeconds="false"; fi + + ## Determine which fields to display (see ISO-8601:2004 §4.4.3.2) + witherPrecision="false" + + ### Years + if $hasYears && [[ $precision -gt 0 ]]; then + displayYears="true"; + witherPrecision="true"; + else + displayYears="false"; + fi; + if $witherPrecision; then ((precision--)); fi; + + ### Months + if $hasMonths && [[ $precision -gt 0 ]]; then + displayMonths="true"; + witherPrecision="true"; + else + displayMonths="false"; + fi; + if $witherPrecision && [[ $precision -gt 0 ]]; then + displayMonths="true"; + fi; + if $witherPrecision; then ((precision--)); fi; + + ### Days + if $hasDays && [[ $precision -gt 0 ]]; then + displayDays="true"; + witherPrecision="true"; + else + displayDays="false"; + fi; + if $witherPrecision && [[ $precision -gt 0 ]]; then + displayDays="true"; + fi; + if $witherPrecision; then ((precision--)); fi; + + ### Hours + if $hasHours && [[ $precision -gt 0 ]]; then + displayHours="true"; + witherPrecision="true"; + else + displayHours="false"; + fi; + if $witherPrecision && [[ $precision -gt 0 ]]; then + displayHours="true"; + fi; + if $witherPrecision; then ((precision--)); fi; + + ### Minutes + if $hasMinutes && [[ $precision -gt 0 ]]; then + displayMinutes="true"; + witherPrecision="true"; + else + displayMinutes="false"; + fi; + if $witherPrecision && [[ $precision -gt 0 ]]; then + displayMinutes="true"; + fi; + if $witherPrecision; then ((precision--)); fi; + + ### Seconds + + if $hasSeconds && [[ $precision -gt 0 ]]; then + displaySeconds="true"; + witherPrecision="true"; + else + displaySeconds="false"; + fi; + if $witherPrecision && [[ $precision -gt 0 ]]; then + displaySeconds="true"; + fi; + if $witherPrecision; then ((precision--)); fi; + + + + ## Determine whether or not the "T" separator is needed to separate date and time elements + # if ( $displayYears || $displayMonths || $displayDays ) && ( $displayHours || $displayMinutes || $displaySeconds); then + if ( $displayHours || $displayMinutes || $displaySeconds); then + displayDateTime="true"; else displayDateTime="false"; fi + + ## Construct duration output string + OUTPUT="P" + if $displayYears; then + OUTPUT=$OUTPUT$fullYears"Y"; fi + if $displayMonths; then + OUTPUT=$OUTPUT$fullMonths"M"; fi + if $displayDays; then + OUTPUT=$OUTPUT$fullDays"D"; fi + if $displayDateTime; then + OUTPUT=$OUTPUT"T"; fi + if $displayHours; then + OUTPUT=$OUTPUT$fullHours"H"; fi + if $displayMinutes; then + OUTPUT=$OUTPUT$fullMinutes"M"; fi + if $displaySeconds; then + OUTPUT=$OUTPUT$fullSeconds"S"; fi + + ## Output duration string to stdout + if [[ "$returnState" = "true" ]]; then echo "$OUTPUT"; fi + + + # if [[ "$OPTION_DATEPARSE" = "true" ]]; then + # echo "asdf"; + # # Get current time for parsing year/month/day idiosyncrasies + # DATE_NOW="$(TZ=":UTC" date --iso-8601 | tr -d '[:punct:]')"; # Produces YYYYMMDD + # #TIME_CURRENT="$(date --iso-8601=seconds)" ; # Produce `date`-parsable current timestamp with resolution of 1 second. + # # Get date : Given YYYY-MM-DDTHH:MM:SS+ZZ, outputs YYYYMMDD (also supports YYYYYY) + # DATE_AGO="$(TZ="UTC" date -d '$ARG1 seconds ago' --iso-8601=seconds | tr -d '[:punct:]' | cut -dT -f1)"; + # # Get day + # DAY_AGO=${DATE_AGO: -2} + # # Get month + # MONTH_AGO=${DATE_AGO: -4: -2} + # # Get year + # YEAR_AGO=${YEAR: 0: -4} + + # fi + + #===Determine function return code=== + if [ "$returnState" = "true" ]; then + return 0; + else + echo "$returnState" 1>&2; + return 1; + fi + +} # Get duration (ex: PT10M4S ) + +#==BEGIN sample code== +echo "Precision 6 duration:$(timeDuration "$(date +%s)" 6)" +echo "Precision 5 duration:$(timeDuration "$(date +%s)" 5)" +echo "Precision 4 duration:$(timeDuration "$(date +%s)" 4)" +echo "Precision 3 duration:$(timeDuration "$(date +%s)" 3)" +echo "Precision 2 duration:$(timeDuration "$(date +%s)" 2)" +echo "Precision 1 duration:$(timeDuration "$(date +%s)" 1)" +echo "Precision 6 duration:$(timeDuration $((60+60*60+60*60*24+60*60*24*30+60*60*24*365 - (60+60*60+60*60*24+60*60*24*30) )) 6)" +timeDuration "$@" +#==END sample code== + +# Author: Steven Baltakatei Sandoval +# License: GPLv3+