X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.time.xml;h=0706cdf54a099df460cf38e76df83e609b204890;hp=3d13b573fa46ee8c1bb81e085375308205917712;hb=eb34cba76323ea673471e226f97721bd6bdbcbf6;hpb=6b4991cfde6c0a0b62e836ca75ae362779c474d4 diff --git a/man/systemd.time.xml b/man/systemd.time.xml index 3d13b573f..0706cdf54 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 @@ -222,7 +228,7 @@ In the date and time specifications, any component may be specified as * in which case any value will match. Alternatively, each - component can be specified as list of values separated + component can be specified as a list of values separated by commas. Values may also be suffixed with / and a repetition value, which indicates that the value and all values plus multiples @@ -231,7 +237,7 @@ Either time or date specification may be omitted, in which case the current day and 00:00:00 is implied, respectively. If the second component is not - specified :00 is assumed. + specified, :00 is assumed. Timezone names may not be specified.