X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.time.xml;h=f35ccd7f171b4bd6148d5b8294785896776a38ab;hp=a837f232c37cd6f1e797ce671dd01018754b02b5;hb=1cf3c30c0787f941b0f6d0b11ab504ddee3b0b8f;hpb=3563b896da77bb2e6abc2ca0f03d8e2f570f1cc7 diff --git a/man/systemd.time.xml b/man/systemd.time.xml index a837f232c..f35ccd7f1 100644 --- a/man/systemd.time.xml +++ b/man/systemd.time.xml @@ -153,14 +153,19 @@ When parsing, systemd will also accept relative time specifications. A time span (see above) that is prefixed with + is evaluated to the - current time plus the specified - time span. Correspondingly, a time span that is prefixed + current time plus the specified time + span. Correspondingly, a time span that is prefixed with - is evaluated to the current time minus the specified time span. Instead of - prefixing the time span with -, it - may also be suffixed with a space and the word + prefixing the time span with + or + -, it may also be suffixed with a + space and the word left or ago. + Finally, a timespan prefixed with + @ is evaluated relative to the UNIX + time epoch 1st Jan, 1970, 00:00. + Examples for valid timestamps and their normalized form (assuming the current time was 2012-11-23 18:15:22): @@ -177,7 +182,8 @@ tomorrow → Fri 2012-11-24 00:00:00 +3h30min → Fri 2012-11-23 21:45:22 -5s → Fri 2012-11-23 18:15:17 - 11min ago → Fri 2012-11-23 18:04:22 + 11min ago → Fri 2012-11-23 18:04:22 + @1395716396 → Tue 2014-03-25 03:59:56 Note that timestamps printed by systemd will not be parsed correctly by systemd, as the timezone @@ -236,13 +242,22 @@ Timezone names may not be specified. The special expressions + minutely, hourly, daily, - monthly and weekly - may be used as calendar events which refer to - *-*-* *:00:00, *-*-* - 00:00:00, *-*-01 00:00:00 and - Mon *-*-* 00:00:00, - respectively. + monthly, weekly, + yearly, + quarterly, + semiannually may be used as + calendar events which refer to + *-*-* *:*:00, + *-*-* *:00:00, + *-*-* 00:00:00, + *-*-01 00:00:00, + Mon *-*-* 00:00:00, + *-01-01 00:00:00, + *-01,04,07,10-01 00:00:0 and + *-01,07-01 00:00:00 respectively. + Examples for valid timestamps and their normalized form: @@ -271,6 +286,8 @@ Wed-Sat,Tue 12-10-15 1:2:3 → Tue-Sat 2012-10-15 01:02:03 daily → *-*-* 00:00:00 monthly → *-*-01 00:00:00 weekly → Mon *-*-* 00:00:00 + yearly → *-01-01 00:00:00 + annually → *-01-01 00:00:00 *:2/3 → *-*-* *:02/3:00 Calendar events are used by timer units, see