diff --git a/docs/parsers/date.md b/docs/parsers/date.md index 5e2f4d42..e4966ba9 100644 --- a/docs/parsers/date.md +++ b/docs/parsers/date.md @@ -105,4 +105,4 @@ Returns: ### Parser Information Compatibility: linux, darwin, freebsd -Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 2.3 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/dig.md b/docs/parsers/dig.md index fa3d492d..d1459682 100644 --- a/docs/parsers/dig.md +++ b/docs/parsers/dig.md @@ -350,4 +350,4 @@ Returns: ### Parser Information Compatibility: linux, aix, freebsd, darwin, win32, cygwin -Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 2.3 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/dir.md b/docs/parsers/dir.md index db4651c9..02e08ac5 100644 --- a/docs/parsers/dir.md +++ b/docs/parsers/dir.md @@ -148,4 +148,4 @@ Returns: ### Parser Information Compatibility: win32 -Version 1.4 by Rasheed Elsaleh (rasheed@rebelliondefense.com) +Version 1.5 by Rasheed Elsaleh (rasheed@rebelliondefense.com) diff --git a/docs/parsers/ls.md b/docs/parsers/ls.md index f9acc3df..2ae42823 100644 --- a/docs/parsers/ls.md +++ b/docs/parsers/ls.md @@ -144,4 +144,4 @@ Returns: ### Parser Information Compatibility: linux, darwin, cygwin, aix, freebsd -Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/rpm_qi.md b/docs/parsers/rpm_qi.md index d3c4f71e..3d316d03 100644 --- a/docs/parsers/rpm_qi.md +++ b/docs/parsers/rpm_qi.md @@ -189,4 +189,4 @@ Returns: ### Parser Information Compatibility: linux -Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/stat.md b/docs/parsers/stat.md index 72566c41..b5db81dd 100644 --- a/docs/parsers/stat.md +++ b/docs/parsers/stat.md @@ -198,4 +198,4 @@ Returns: ### Parser Information Compatibility: linux, darwin, freebsd -Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/systeminfo.md b/docs/parsers/systeminfo.md index fa77289c..bd85b45f 100644 --- a/docs/parsers/systeminfo.md +++ b/docs/parsers/systeminfo.md @@ -239,4 +239,4 @@ Returns: ### Parser Information Compatibility: win32 -Version 1.1 by Jon Smith (jon@rebelliondefense.com) +Version 1.2 by Jon Smith (jon@rebelliondefense.com) diff --git a/docs/parsers/timedatectl.md b/docs/parsers/timedatectl.md index 8c4b1539..0e40adbe 100644 --- a/docs/parsers/timedatectl.md +++ b/docs/parsers/timedatectl.md @@ -92,4 +92,4 @@ Returns: ### Parser Information Compatibility: linux -Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/upower.md b/docs/parsers/upower.md index ffcbb334..be0384ad 100644 --- a/docs/parsers/upower.md +++ b/docs/parsers/upower.md @@ -226,4 +226,4 @@ Returns: ### Parser Information Compatibility: linux -Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/vmstat.md b/docs/parsers/vmstat.md index 2291fb79..c6e76a38 100644 --- a/docs/parsers/vmstat.md +++ b/docs/parsers/vmstat.md @@ -154,4 +154,4 @@ Returns: ### Parser Information Compatibility: linux -Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/parsers/who.md b/docs/parsers/who.md index b1d5996f..94953475 100644 --- a/docs/parsers/who.md +++ b/docs/parsers/who.md @@ -163,4 +163,4 @@ Returns: ### Parser Information Compatibility: linux, darwin, cygwin, aix, freebsd -Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com) +Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com) diff --git a/docs/utils.md b/docs/utils.md index 12d6b4cb..c8c24180 100644 --- a/docs/utils.md +++ b/docs/utils.md @@ -184,10 +184,10 @@ class timestamp() ### \_\_init\_\_ ```python -def __init__(datetime_string: str) -> None +def __init__(datetime_string: str, format_hint: Union[List, Tuple, None] = None) -> None ``` -Input a date-time text string of several formats and convert to a +Input a datetime text string of several formats and convert to a naive or timezone-aware epoch timestamp in UTC. Parameters: @@ -195,6 +195,13 @@ Parameters: datetime_string (str): a string representation of a datetime in several supported formats + format_hint (list | tuple): an optional list of format ID + integers to instruct the timestamp object to try those + formats first in the order given. Other formats will be + tried after the format hint list is exhausted. This can + speed up timestamp conversion so several different formats + don't have to be tried in brute-force fashion. + Returns a timestamp object with the following attributes: string (str): the input datetime string