epoch2utc

Package: WA2L/WinTools 1.2.09
Section: Library Commands (3)
Updated: 13 February 2026
Index Return to Main Contents

NAME

epoch2utc - convert epoch timestamp CSV columns to UTC/Zulu/GMT time

SYNOPSIS

WA2LWinTools/lib/[shell/]epoch2utc [ -h | -V ]

epoch2utc [ "field_separator" [ "column_list" ]] < file.csv

cat file.csv | epoch2utc [ "field_separator" [ "column_list" ]]

epoch2utc -t < file.csv

cat file.csv | epoch2utc -t

AVAILABILITY

WA2L/WinTools

DESCRIPTION

convert epoch timestamp columns of a CSV file or stream to UTC/Zulu/GMT time.

If no "column_list" is defined, all integer columns that have 10 or more digits are converted to UTC/Zulu/GMT time.

OPTIONS

-h

usage message.

-V

print program version.

-t

input is a plain TEXT stream.

The timestamp is converted to UTC time if it is separated by white space or special characters from the surrounding text.

"field_separator"

field separator (default=;).

"column_list"

separated list of columns to be converted from the CSV stream from stdin.

ENVIRONMENT

EXIT STATUS

0

no error.

4

usage displayed.

FILES

EXAMPLES

NOTES

BUGS

Due to the "Year 2038 Problem" epoch timestamps can be converted to local time to a maximum timestamp value of 2147483647 (2038-01-19 03:14:07 UTC).

AUTHOR

epoch2utc was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net .

COPYRIGHT

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

This document was created by man2html, using the manual pages.
Time: 20:20:59 GMT, March 02, 2026