Time Tools

time_tools.bsh

get_time_seconds

Print the epoch time in seconds

Output:: stdout - The epoch time, in seconds with nanosecond precision (if available)

Uses the date command to print nanosecond-accurate epoch time, if your date command supports that feature.

Else, uses python3, ruby, or perl if available to get microsecond-accurate time. If all else fails, use the date command, even if it does not support more than second precision.

get_time_nanoseconds

Print the epoch time in nanoseconds. Same as get_time_seconds, but in nanoseconds and always an integer

timeout

Arguments:

$1 - Timeout in integer seconds
$2… - Command to execute

Return Value:

142 - On time out

Uses:

perl

macOS function similar to linux timeout

Bugs

Since this uses SIGALRM, bash will print out “Alarm clock: 14” to indicate SIGALRM (14) has been raised. This could cause unexpected text in stderr if you are parsing it.

See also

toc, toc_ms, toc_ns

toc

Prints the time passed since calling toc in seconds (rounded).

Also stores the number of seconds passed in toc_time

toc_ms

Prints the time passed since calling toc in milliseconds (rounded).

Also stores the number of milliseconds passed in toc_time

Note

Older date commands that don’t support nanoseconds, will not be more accurate than a second.

toc_ns

Prints the time passed since calling toc in nanoseconds.

Also stores the number of nanoseconds passed in toc_time

Note

Older date commands that don’t support nanoseconds, will not be more accurate than a second.

get_timezone

Retrieves the Olson compliant timezone for the system. If this is not easily obtained, a POSIX compliant timezone will be returned instead.

Example

$ get_timezone
America/New_York
# Windows
$ get_timezone
EDT+04:00

get_posix_timezone

Retrieves a POSIX compliant timezone for the system. This POSIX timezone will not encapsulate daylight saving times change rules, however if the computer is currently in daylight saving time, the offset will be applied.

If all the methods to determine the timezone file, it will return UTC with no +/-

Example

$ get_posix_timezone
UTC+00:00
$ get_posix_timezone
EDT+04:00
$ get_posix_timezone
UTC