summaryrefslogtreecommitdiffstats
path: root/README
blob: 77e0090d3b49ff6ff6a69ab5a3575f946e43203b (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
@ (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'

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.