diff --git a/src/uu/date/date-usage.md b/src/uu/date/date-usage.md new file mode 100644 index 000000000..5489028e4 --- /dev/null +++ b/src/uu/date/date-usage.md @@ -0,0 +1,87 @@ +# `date` usage + + + +FORMAT controls the output. Interpreted sequences are: + +| Sequence | Description | Example | +| -------- | -------------------------------------------------------------------- | ---------------------- | +| %% | a literal % | % | +| %a | locale's abbreviated weekday name | Sun | +| %A | locale's full weekday name | Sunday | +| %b | locale's abbreviated month name | Jan | +| %B | locale's full month name | January | +| %c | locale's date and time | Thu Mar 3 23:05:25 2005| +| %C | century; like %Y, except omit last two digits | 20 | +| %d | day of month | 01 | +| %D | date; same as %m/%d/%y | 12/31/99 | +| %e | day of month, space padded; same as %_d | 3 | +| %F | full date; same as %Y-%m-%d | 2005-03-03 | +| %g | last two digits of year of ISO week number (see %G) | 05 | +| %G | year of ISO week number (see %V); normally useful only with %V | 2005 | +| %h | same as %b | Jan | +| %H | hour (00..23) | 23 | +| %I | hour (01..12) | 11 | +| %j | day of year (001..366) | 062 | +| %k | hour, space padded ( 0..23); same as %_H | 3 | +| %l | hour, space padded ( 1..12); same as %_I | 9 | +| %m | month (01..12) | 03 | +| %M | minute (00..59) | 30 | +| %n | a newline | \n | +| %N | nanoseconds (000000000..999999999) | 123456789 | +| %p | locale's equivalent of either AM or PM; blank if not known | PM | +| %P | like %p, but lower case | pm | +| %q | quarter of year (1..4) | 1 | +| %r | locale's 12-hour clock time | 11:11:04 PM | +| %R | 24-hour hour and minute; same as %H:%M | 23:30 | +| %s | seconds since 1970-01-01 00:00:00 UTC | 1615432800 | +| %S | second (00..60) | 30 | +| %t | a tab | \t | +| %T | time; same as %H:%M:%S | 23:30:30 | +| %u | day of week (1..7); 1 is Monday | 4 | +| %U | week number of year, with Sunday as first day of week (00..53) | 10 | +| %V | ISO week number, with Monday as first day of week (01..53) | 12 | +| %w | day of week (0..6); 0 is Sunday | 4 | +| %W | week number of year, with Monday as first day of week (00..53) | 11 | +| %x | locale's date representation (e.g., 12/31/99) | 03/03/2005 | +| %X | locale's time representation (e.g., 23:13:48) | 23:30:30 | +| %y | last two digits of year (00..99) | 05 | +| %Y | year | 2005 | +| %z | +hhmm numeric time zone (e.g., -0400) | -0400 | +| %:z | +hh:mm numeric time zone (e.g., -04:00) | -04:00 | +| %::z | +hh:mm:ss numeric time zone (e.g., -04:00:00) | -04:00:00 | +| %:::z | numeric time zone with : to necessary precision (e.g., -04, +05:30) | -04 | +| %Z | alphabetic time zone abbreviation (e.g., EDT) | EDT | + +By default, date pads numeric fields with zeroes. +The following optional flags may follow '%': + +* `-` (hyphen) do not pad the field +* `_` (underscore) pad with spaces +* `0` (zero) pad with zeros +* `^` use upper case if possible +* `#` use opposite case if possible + +After any flags comes an optional field width, as a decimal number; +then an optional modifier, which is either +E to use the locale's alternate representations if available, or +O to use the locale's alternate numeric symbols if available. + +Examples: +Convert seconds since the epoch (1970-01-01 UTC) to a date + +``` +date --date='@2147483647' +``` + +Show the time on the west coast of the US (use tzselect(1) to find TZ) + +``` +TZ='America/Los_Angeles' date +``` + +Show the local time for 9AM next Friday on the west coast of the US + +``` +date --date='TZ="America/Los_Angeles" 09:00 next Fri' +``` diff --git a/src/uu/date/date-usage.mkd b/src/uu/date/date-usage.mkd deleted file mode 100644 index 829001095..000000000 --- a/src/uu/date/date-usage.mkd +++ /dev/null @@ -1,78 +0,0 @@ -# `date` usage - - - -``` text -FORMAT controls the output. Interpreted sequences are: - - %% a literal % - %a locale's abbreviated weekday name (e.g., Sun) - %A locale's full weekday name (e.g., Sunday) - %b locale's abbreviated month name (e.g., Jan) - %B locale's full month name (e.g., January) - %c locale's date and time (e.g., Thu Mar 3 23:05:25 2005) - %C century; like %Y, except omit last two digits (e.g., 20) - %d day of month (e.g., 01) - %D date; same as %m/%d/%y - %e day of month, space padded; same as %_d - %F full date; same as %Y-%m-%d - %g last two digits of year of ISO week number (see %G) - %G year of ISO week number (see %V); normally useful only with %V - %h same as %b - %H hour (00..23) - %I hour (01..12) - %j day of year (001..366) - %k hour, space padded ( 0..23); same as %_H - %l hour, space padded ( 1..12); same as %_I - %m month (01..12) - %M minute (00..59) - %n a newline - %N nanoseconds (000000000..999999999) - %p locale's equivalent of either AM or PM; blank if not known - %P like %p, but lower case - %q quarter of year (1..4) - %r locale's 12-hour clock time (e.g., 11:11:04 PM) - %R 24-hour hour and minute; same as %H:%M - %s seconds since 1970-01-01 00:00:00 UTC - %S second (00..60) - %t a tab - %T time; same as %H:%M:%S - %u day of week (1..7); 1 is Monday - %U week number of year, with Sunday as first day of week (00..53) - %V ISO week number, with Monday as first day of week (01..53) - %w day of week (0..6); 0 is Sunday - %W week number of year, with Monday as first day of week (00..53) - %x locale's date representation (e.g., 12/31/99) - %X locale's time representation (e.g., 23:13:48) - %y last two digits of year (00..99) - %Y year - %z +hhmm numeric time zone (e.g., -0400) - %:z +hh:mm numeric time zone (e.g., -04:00) - %::z +hh:mm:ss numeric time zone (e.g., -04:00:00) - %:::z numeric time zone with : to necessary precision (e.g., -04, +05:30) - %Z alphabetic time zone abbreviation (e.g., EDT) - -By default, date pads numeric fields with zeroes. -The following optional flags may follow '%': - - - (hyphen) do not pad the field - _ (underscore) pad with spaces - 0 (zero) pad with zeros - ^ use upper case if possible - # use opposite case if possible - -After any flags comes an optional field width, as a decimal number; -then an optional modifier, which is either -E to use the locale's alternate representations if available, or -O to use the locale's alternate numeric symbols if available. - -Examples: -Convert seconds since the epoch (1970-01-01 UTC) to a date - $ date --date='@2147483647' - -Show the time on the west coast of the US (use tzselect(1) to find TZ) - $ TZ='America/Los_Angeles' date - -Show the local time for 9AM next Friday on the west coast of the US - $ date --date='TZ="America/Los_Angeles" 09:00 next Fri' -```