summaryrefslogtreecommitdiffstats
path: root/README
blob: 6fb4f3081852b1e823e7a0b39e7b87a9458bcae3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
@ (At Sign)
-----------

@ waits and exits at a specified time.  It can be used to delay shell
commands, e.g.:

    @ 18:00; printf '\a'
    @ '19 January 2038 03:14:07'; halt
    @ 9:00am mon; printf '\a'

@ is similar to the standard sleep utility except that it accepts a time
and optional date instead of a delay duration.  @ is distinct from the
at daemon package by Jose M Calhariz in that @ is not a daemon that runs
jobs in the background; instead it delays subsequent commands in a list,
allowing such commands to remain connected to a controlling terminal for
user interaction.

Date/Time Formats
-----------------

@ currently supports 704 date/time formats, any one of which may be
specified on the command line in one or more arguments.  All spaces
shown below are optional.

A time may be specified in any of the following eight formats:

  * 7:00:01 PM
  * 19:00:01
  * 7:00 PM
  * 19:00
  * 70001 PM
  * 190001
  * 700 PM
  * 1900

A date may be omitted or specified (before or after the time) in any of
the following 43 formats:

  * Wed
  * 1969-12-31
  * 1969/12/31
  * 12-31-1969
  * 12-31
  * 12/31/1969
  * 12/31
  * 31 Dec 1969
  * 31 Dec
  * 31-Dec-1969
  * 31-Dec
  * 31/Dec/1969
  * 31/Dec
  * Wed 31 Dec 1969
  * Wed 31 Dec
  * Wed 31-Dec-1969
  * Wed 31-Dec
  * Wed 31/Dec/1969
  * Wed 31/Dec
  * Wed, 31 Dec 1969
  * Wed, 31 Dec
  * Wed, 31-Dec-1969
  * Wed, 31-Dec
  * Wed, 31/Dec/1969
  * Wed, 31/Dec
  * Dec 31, 1969
  * Dec 31
  * Dec-31-1969
  * Dec-31
  * Dec/31/1969
  * Dec/31
  * Wed Dec 31, 1969
  * Wed Dec 31
  * Wed Dec-31-1969
  * Wed Dec-31
  * Wed Dec/31/1969
  * Wed Dec/31
  * Wed, Dec 31, 1969
  * Wed, Dec 31
  * Wed, Dec-31-1969
  * Wed, Dec-31
  * Wed, Dec/31/1969
  * Wed, Dec/31

Additionally, the following nine date/time formats are supported:

  * 1969-12-31T19:00:01
  * 1969-12-31T19:00
  * 19691231T190001
  * 19691231T1900
  * 19691231 70001 PM
  * 19691231 190001
  * 19691231 700 PM
  * 19691231 1900
  * Wed Dec 31 19:00:01 1969

Development
-----------

@ is maintained in a Git repository.  Browse:

    http://git.pehjota.net/atsign/atsign.git/

Clone:

    git://git.pehjota.net/atsign/atsign.git

Patches may be e-mailed to the author, P. J. McDermott <pj@pehjota.net>.

Copyright
---------

Copyright (C) 2021  P. J. McDermott

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.