From: Pádraig Brady Date: Sat, 9 May 2026 16:46:48 +0000 (+0100) Subject: doc: date: group format sequences by function X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=77cf01877720de6260132c12bd2a4af47b7ef454;p=thirdparty%2Fcoreutils.git doc: date: group format sequences by function * src/date.c (usage): Grouping alphabetically is less useful. Suggested by Bruno Haible. --- diff --git a/src/date.c b/src/date.c index 98ff53eeea..88ea1279a3 100644 --- a/src/date.c +++ b/src/date.c @@ -202,125 +202,140 @@ FORMAT Example Description\n\ %% % a literal %\n\ "), stdout); fputs (_("\ - %a Sun locale's abbreviated weekday name\n\ + %n \\n a newline\n\ "), stdout); fputs (_("\ - %A Sunday locale's full weekday name\n\ + %t \\t a tab\n\ "), stdout); + + fputs ("\n", stdout); + fputs (_("\ - %b Mar locale's abbreviated month name\n\ + %C 20 century; like %Y, except omit last two digits\n\ "), stdout); fputs (_("\ - %B March locale's full month name\n\ + %y 99 year (last two digits; 00..99)\n\ "), stdout); fputs (_("\ - %c ... locale's date and time (e.g., Thu Mar 3 23:05:25 2005)\n\ + %Y 1999 year\n\ "), stdout); fputs (_("\ - %C 20 century; like %Y, except omit last two digits\n\ + %g 99 year of ISO week number (last 2 digits; 00-99); see %G\n\ "), stdout); fputs (_("\ - %d 01 day of month\n\ + %G 1999 year of ISO week number; normally useful only with %V\n\ "), stdout); + + fputs ("\n", stdout); + fputs (_("\ - %D 12/31/99 date (ambiguous); same as %m/%d/%y\n\ + %a Sun locale's abbreviated weekday name\n\ "), stdout); fputs (_("\ - %e 1 day of month, space padded; same as %_d\n\ + %A Sunday locale's full weekday name\n\ "), stdout); fputs (_("\ - %F 1999-12-31 full date; like %+4Y-%m-%d\n\ + %b Mar locale's abbreviated month name\n\ "), stdout); fputs (_("\ - %g 99 year of ISO week number (last two digits; 00-99); see %G\n\ + %h Mar same as %b\n\ "), stdout); fputs (_("\ - %G 1999 year of ISO week number; normally useful only with %V\n\ + %B March locale's full month name\n\ "), stdout); fputs (_("\ - %h Mar same as %b\n\ + %m 12 month (01..12)\n\ "), stdout); fputs (_("\ - %H 23 hour (00..23)\n\ + %d 31 day of month (01..31)\n\ "), stdout); fputs (_("\ - %I 01 hour (01..12)\n\ + %e 1 day of month, space padded; same as %_d\n\ "), stdout); fputs (_("\ - %j 365 day of year (001..366)\n\ + %D 12/31/99 date (ambiguous); same as %m/%d/%y\n\ "), stdout); fputs (_("\ - %k 8 hour, space padded ( 0..23); same as %_H\n\ + %F 1999-12-31 full date; like %+4Y-%m-%d\n\ "), stdout); fputs (_("\ - %l 9 hour, space padded ( 1..12); same as %_I\n\ + %x 12/31/99 locale's date (can be ambiguous)\n\ "), stdout); fputs (_("\ - %m 12 month (01..12)\n\ + %c ... locale's date and time (e.g., Thu Mar 3 23:05 2005)\n\ "), stdout); + + fputs ("\n", stdout); + fputs (_("\ - %M 59 minute (00..59)\n\ + %H 23 hour (00..23)\n\ "), stdout); fputs (_("\ - %n \\n a newline\n\ + %I 01 hour (01..12)\n\ "), stdout); fputs (_("\ - %N 123456789 nanoseconds (000000000..999999999)\n\ + %k 8 hour, space padded ( 0..23); same as %_H\n\ "), stdout); fputs (_("\ - %p PM locale's equivalent of AM or PM; blank if not known\n\ + %l 9 hour, space padded ( 1..12); same as %_I\n\ "), stdout); fputs (_("\ - %P pm like %p, but lower case\n\ + %M 59 minute (00..59)\n\ "), stdout); fputs (_("\ - %q 4 quarter of year (1..4)\n\ + %S 60 second (00..60)\n\ "), stdout); fputs (_("\ - %r 1:11:04 PM locale's 12-hour clock time\n\ + %N 123456789 nanoseconds (000000000..999999999)\n\ "), stdout); fputs (_("\ - %R 23:59 24-hour hour and minute; same as %H:%M\n\ + %s 1970010100 seconds since the Epoch (1970-01-01 00:00 UTC)\n\ "), stdout); fputs (_("\ - %s 1970010100 seconds since the Epoch (1970-01-01 00:00 UTC)\n\ + %p PM locale's equivalent of AM or PM; blank if not known\n\ "), stdout); fputs (_("\ - %S 60 second (00..60)\n\ + %P am like %p, but lower case\n\ "), stdout); fputs (_("\ - %t \\t a tab\n\ + %r 1:11:04 PM locale's 12-hour clock time\n\ "), stdout); fputs (_("\ - %T 23:59:59 time; same as %H:%M:%S\n\ + %R 23:59 24-hour hour and minute; same as %H:%M\n\ "), stdout); fputs (_("\ - %u 7 day of week (1..7); 1 is Monday\n\ + %T 23:59:59 time; same as %H:%M:%S\n\ "), stdout); fputs (_("\ - %U 52 week number of year; Sunday as first day of week (00..53)\n\ + %X 23:59:59 locale's time representation\n\ "), stdout); + + fputs ("\n", stdout); + fputs (_("\ - %V 52 ISO week number; Monday as first day of week (01..53)\n\ + %j 365 day of year (001..366)\n\ "), stdout); fputs (_("\ - %W 52 week number of year; Monday as first day of week (00..53)\n\ + %q 4 quarter of year (1..4)\n\ "), stdout); fputs (_("\ - %w 6 day of week (0..6); 0 is Sunday\n\ + %u 7 day of week (1..7); 1 is Monday\n\ "), stdout); fputs (_("\ - %x 12/31/99 locale's date (can be ambiguous)\n\ + %w 6 day of week (0..6); 0 is Sunday\n\ "), stdout); fputs (_("\ - %X 23:59:59 locale's time representation\n\ + %U 52 week of year; Sunday as first day of week (00..53)\n\ "), stdout); fputs (_("\ - %y 99 year (last two digits; 00..99)\n\ + %V 52 ISO week number; Monday as first day of week (01..53)\n\ "), stdout); fputs (_("\ - %Y 1999 year\n\ + %W 52 week of year; Monday as first day of week (00..53)\n\ "), stdout); + + fputs ("\n", stdout); + fputs (_("\ %z +0400 +hhmm numeric time zone\n\ "), stdout);