Crate chrono_systemd_time[][src]

chrono systemd.time

chrono-systemd-time is a library which parses timestamps following the systemd.time specifications into chrono types.

Usage

Put this in your Cargo.toml:

[dependencies]
chrono-systemd-time = "0.1"

Timestamp Format

The supported timestamp formats are any defined by the systemd.time specifications, with a few exceptions:

  • time units must accompany all time span values.
  • time zone suffixes are not supported.
  • weekday prefixes are not supported.

The format of a timestamp may be either a time, a time span, or a combination of a time +/- a time span.

  • When only a time is given, the parsed time is returned.
  • When only a time span is given, the time span is added or subtracted from the current time (now).
  • When a combination of a time and a time span is given, the time span is added or subtracted from the parsed time.

Examples of parsing valid timestamps, assuming now is 2018-06-21 01:02:03:

This example is not tested
    parse_timestamp_tz("2018-08-20 09:11:12.123", Utc) == "2018-08-20T09:11:12.000123Z"
    parse_timestamp_tz("2018-08-20 09:11:12", Utc) == "2018-08-20T09:11:12Z"
    parse_timestamp_tz("18-08-20 09:11:12 +2m", Utc) == "2018-08-20T09:13:12Z"
    parse_timestamp_tz("2018-08-20 + 1h2m3s", Utc) == "2018-08-20T01:02:03Z"
    parse_timestamp_tz("18-08-20 - 1h 2m 3s", Utc) == "2018-08-19T22:57:57Z"
    parse_timestamp_tz("09:11:12 -1day", Utc) == "2018-06-20T09:11:12Z"
    parse_timestamp_tz("09:11:12.123", Utc) == "2018-06-21T09:11:12.000123Z"
    parse_timestamp_tz("11:12", Utc) == "2018-06-21T11:12:00Z"
    parse_timestamp_tz("now", Utc) == "2018-06-21T01:02:03.203918151Z"
    parse_timestamp_tz("today", Utc) == "2018-06-21T00:00:00Z"
    parse_timestamp_tz("yesterday -2days", Utc) == "2018-06-18T00:00:00Z"
    parse_timestamp_tz("tomorrow +1week", Utc) == "2018-06-29T00:00:00Z"
 
    parse_timestamp_tz("epoch +1529578800s", Utc) == "2018-06-21T11:00:00Z"
    parse_timestamp_tz("@1529578800s", Utc) == "2018-06-21T11:00:00Z"
    parse_timestamp_tz("now +4h50m", Utc) == "2018-06-21T05:52:03.203918151Z"
    parse_timestamp_tz("4h50m left", Utc) == "2018-06-21T05:52:03.203918151Z"
    parse_timestamp_tz("+4h50m", Utc) == "2018-06-21T05:52:03.203918151Z"
    parse_timestamp_tz("now -3s", Utc) == "2018-06-21T01:02:00.203918151Z"
    parse_timestamp_tz("3s ago", Utc) == "2018-06-21T01:02:00.203918151Z"
    parse_timestamp_tz("-3s", Utc) == "2018-06-21T01:02:00.203918151Z"

Time

The syntax of a time consists of a set of keywords and strftime formats:

  • "now", "epoch"
  • "today", "yesterday", "tomorrow"
  • "%y-%m-%d %H:%M:%S", "%Y-%m-%d %H:%M:%S"
  • "%y-%m-%d %H:%M", "%Y-%m-%d %H:%M"
  • "%y-%m-%d", "%Y-%m-%d"
  • "%H:%M:%S"
  • "%H:%M"

Strftime timestamps with a seconds component may also include a microsecond component, separated by a '.'.

  • When the date is omitted, today is assumed.
  • When the time is omitted, 00:00:00 is assumed.

Examples of valid times (assuming now is 2018-06-21 01:02:03):

This example is not tested
    "2018-08-20 09:11:12.123" == "2018-08-20T09:11:12.000123"
        "2018-08-20 09:11:12" == "2018-08-20T09:11:12"
          "18-08-20 09:11:12" == "2018-08-20T09:11:12"
                 "2018-08-20" == "2018-08-20T00:00:00"
                   "18-08-20" == "2018-08-20T00:00:00"
                   "09:11:12" == "2018-06-21T09:11:12"
               "09:11:12.123" == "2018-06-21T09:11:12.000123"
                      "11:12" == "2018-06-21T11:12:00"
                        "now" == "2018-06-21T01:02:03.203918151"
                      "epoch" == "1970-01-01T00:00:00"
                      "today" == "2018-06-21T00:00:00"
                  "yesterday" == "2018-06-20T00:00:00"
                   "tomorrow" == "2018-06-22T00:00:00"

Time span

A time span is made up of a combination of time units, with the following time units understood:

  • "usec", "us", "µs"
  • "msec", "ms"
  • "seconds", "second", "sec", "s"
  • "minutes", "minute", "min", "m"
  • "hours", "hour", "hr", "h"
  • "days", "day", "d"
  • "weeks", "week", "w"
  • "months", "month", "M" (defined as 30.44 days)
  • "years", "year", "y" (defined as 365.25 days)

All components of a time span are added to together.

Examples of valid time spans:

This example is not tested
          "3hours" == Duration::hours(3)
           "2d 5h" == Duration::days(2) + Duration::hours(5)
    "1y 10 months" == Duration::years(1) + Duration::months(10)
          "30m22s" == Duration::minutes(30) + Duration::seconds(22)
       "10m 2s 5m" == Duration::minutes(15) + Duration::seconds(2)
        "10d 2 5m" == Duration::days(10) + Duration::minutes(25)

Enums

InvalidTimestamp

Describes an error during the parsing of a timestamp.

Functions

parse_timestamp_tz

Parse a timestamp returning a DateTime with the specified timezone.