tai64nlocal

Section: Maintenance Commands (8)
Index Return to Main Contents

NAME

tai64nlocal - converts precise TAI64N timestamps to a human-readable format.

SYNOPSIS

tai64nlocal

DESCRIPTION

tai64nlocal reads lines from stdin. If a line does not begin with @, tai64nlocal writes it to stdout without change. If a line begins with @, tai64nlocal looks for a timestamp after the @, in the format printed by tai64n(8), and writes the line to stdout with the timestamp converted to local time in ISO format: YYYY-MM-DD HH:MM:SS.SSSSSSSSS.

For example, in the US/Pacific time zone, the input line

@4000000037c219bf2ef02e94 mark

should be printed as

1999-08-23 21:03:43.787492500 mark

Beware, however, that the current implementation of tai64nlocal relies on the UNIX localtime library routine to find the local time. Some localtime implementations use a broken time scale that does not account for leap seconds. On systems that use the Olson tz library (with an up-to-date leap-second table), you can fix this problem by setting your time zone to, e.g, right/US/Pacific instead of US/Pacific.

Beware also that most localtime implementations are not Y2038-compliant.

tai64nlocal does not allocate any memory after it starts, except possibly inside localtime.

EXIT CODES

tai64nlocal exits 0 when it sees end of input. It exits 111 without an error message if it has trouble reading stdin or writing stdout.