From 0a4de2d3a1c235d1ac2d6e59346e77761fe51885 Mon Sep 17 00:00:00 2001 From: Kelly Brazil Date: Mon, 22 Mar 2021 20:22:35 -0700 Subject: [PATCH] add naive datetime calculation info to docs --- docs/parsers/last.md | 2 ++ docs/parsers/upower.md | 5 +++-- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/parsers/last.md b/docs/parsers/last.md index 7a853177..efd8811c 100644 --- a/docs/parsers/last.md +++ b/docs/parsers/last.md @@ -4,6 +4,8 @@ jc - JSON CLI output utility `last` and `lastb` command output parser Supports -w and -F options. +Calculated epoch time fields are naive (i.e. based on the local time of the system the parser is run on) since there is no timezone information in the `last` command output. + Usage (cli): $ last | jc --last diff --git a/docs/parsers/upower.md b/docs/parsers/upower.md index ea546349..5af5e2ac 100644 --- a/docs/parsers/upower.md +++ b/docs/parsers/upower.md @@ -2,6 +2,8 @@ # jc.parsers.upower jc - JSON CLI output utility `upower` command output parser +Calculated epoch time fields are naive (i.e. based on the local time of the system the parser is run on) since there is no unambiguous timezone information in the `upower` command output. + Usage (cli): $ upower -d | jc --upower @@ -74,7 +76,6 @@ Examples: "status": "charging" } ], - "updated_epoch": 1328841735, "updated_seconds_ago": 1 } ] @@ -157,7 +158,7 @@ Returns: "native_path": string, "power_supply": boolean, "updated": string, - "updated_epoch": integer, # as UTC. Works best with C locale. null if conversion fails + "updated_epoch": integer, # works best with C locale. null if conversion fails "updated_seconds_ago": integer, "has_history": boolean, "has_statistics": boolean,