jc.parsers.date

jc - JSON CLI output utility date command output parser

The epoch calculated timestamp field is naive. (i.e. based on the local time of the system the parser is run on)

The epoch_utc calculated timestamp field is timezone-aware and is only available if the timezone field is UTC.

Usage (cli):

$ date | jc --date

or

$ jc date

Usage (module):

import jc.parsers.date
result = jc.parsers.date.parse(date_command_output)

Compatibility:

'linux', 'darwin', 'freebsd'

Examples:

$ date | jc --date -p
{
  "year": 2021,
  "month_num": 3,
  "day": 23,
  "hour": 8,
  "hour_24": 20,
  "minute": 45,
  "second": 29,
  "period": "PM",
  "month": "Mar",
  "weekday": "Tue",
  "weekday_num": 2,
  "timezone": "UTC",
  "epoch": 1616557529,
  "epoch_utc": 1616532329
}

$ date | jc --date -p -r
{
  "year": "2021",
  "month": "Mar",
  "day": "23",
  "weekday": "Tue",
  "hour": "08",
  "minute": "45",
  "second": "29",
  "period": "PM",
  "timezone": "UTC"
}

info

info()

process

process(proc_data)

Final processing to conform to the schema.

Parameters:

proc_data:   (Dictionary) raw structured data to process

Returns:

Dictionary. Structured data with the following schema:

{
  "year":         integer,
  "month_num":    integer,
  "day":          integer,
  "hour":         integer,       # originally parsed hour
  "hour_24":      integer,       # parsed hour converted to 24-hour value
  "minute":       integer,
  "second":       integer,
  "period":       string,        # 'AM' or 'PM'. null if 24-hour output
  "month":        string,
  "weekday":      string,
  "weekday_num":  integer,
  "timezone":     string,
  "epoch":        integer,       # naive timestamp
  "epoch_utc":    integer,       # timezone-aware timestamp. Only available if timezone field is UTC
}

parse

parse(data, raw=False, quiet=False)

Main text parsing function