diff options
author | P. J. McDermott <pj@pehjota.net> | 2021-08-30 16:44:09 (EDT) |
---|---|---|
committer | P. J. McDermott <pj@pehjota.net> | 2021-08-30 16:44:09 (EDT) |
commit | 2cd65826013df34dc80c7441c4904cfa9c078fa9 (patch) | |
tree | 805ce9ce93f8adbe7439d1676238ea01ff480329 /README | |
parent | d65f1351dcfae6685c7ac6c21aec6c61a6a2714f (diff) | |
download | atsign-2cd65826013df34dc80c7441c4904cfa9c078fa9.zip atsign-2cd65826013df34dc80c7441c4904cfa9c078fa9.tar.gz atsign-2cd65826013df34dc80c7441c4904cfa9c078fa9.tar.bz2 |
README: Document formats and Git repository
Count the formats using:
grep '^".*",$' src/datetime-formats.c | wc -l
List the date formats using:
sed -n 's|^/\* \(.*\) \*/$|\1|p' src/datetime-formats.c
(But ignore 'Time only', 'ISO 8601: 1969-12-31 delimited by "T"',
'ISO 8601: 19691231 delimited by "T"', and '19691231'.)
Math to 704:
43 (date formats) * 2 (positions: before or after time) = 86
86 + 1 (time-only no-date format) = 87
87 * 8 (time formats) = 696
696 + 8 (special formats) = 704
Diffstat (limited to 'README')
-rw-r--r-- | README | 89 |
1 files changed, 89 insertions, 0 deletions
@@ -6,6 +6,95 @@ commands, e.g.: @ 18:00; 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 eight 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 + +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 --------- |