mirror of
https://github.com/RGBCube/uutils-coreutils
synced 2025-07-29 12:07:46 +00:00
Daniel Hofstetter
GitHub
commit
dffd2f082e
2 changed files with 87 additions and 78 deletions
87
src/uu/date/date-usage.md
Normal file
87
src/uu/date/date-usage.md
Normal file
|
|
@ -0,0 +1,87 @@
|
|||
# `date` usage
|
||||
|
||||
<!-- spell-checker:ignore (format) hhmm -->
|
||||
|
||||
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'
|
||||
```
|
||||
|
|
@ -1,78 +0,0 @@
|
|||
# `date` usage
|
||||
|
||||
<!-- spell-checker:ignore (format) hhmm -->
|
||||
|
||||
``` 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'
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue