--- org/strftime.3c Tue Dec 1 11:10:49 2009 +++ strftime.3c Tue Dec 15 17:28:27 2009 @@ -23,7 +23,8 @@ string pointed to by format. The format string consists of zero or more conversion specifications and ordinary charac- ters. A conversion specification consists of a '%' (per- - cent) character and one or two terminating conversion char- + cent) character, an optional flag character, an optional | + field width, and one or two terminating conversion char- | acters that determine the conversion specification's behavior. All ordinary characters (including the terminat- ing null byte) are copied unchanged into the array pointed @@ -43,9 +44,14 @@ ate characters are determined by the LC_TIME category of the program's locale and by the values contained in the struc- ture pointed to by timeptr for strftime() and ascftime(), - and by the time represented by clock for cftime(). + and by the time represented by clock for cftime(). Supported | + optional flag characters and optional field width are | + described at the end of the section. | %% Same as %. + | + %+ Locale's date and time representation as produced by | + date(1). | %a Locale's abbreviated weekday name. @@ -94,8 +100,8 @@ %e Day of month [1,31]; single digits are preceded by a space. - %F Equivalent to %Y-%m-%d (the ISO 8601:2000 standard - date format). + %F Equivalent to %Y-%m-%d (the ISO 8601:2004 standard | + date in exteded format). | %g Week-based year within century [00,99]. @@ -122,11 +128,17 @@ %n Insert a NEWLINE. %p Locale's equivalent of either a.m. or p.m. + | + %P Locale's equivalent of either a.m. or p.m. in lowercase if | + applicable for the current locale. | %r Appropriate time representation in 12-hour clock for- mat with %p. %R Time as %H:%M. + | + %s The number of seconds since the Epoch (00:00:00 UTC, | + January 1, 1970). | %S Seconds [00,60]; the range of values is [00,60] rather than [00,59] to allow for the occasional leap second. @@ -163,13 +175,13 @@ %Y Year, including the century (for example 1993). - %z Replaced by offset from UTC in ISO 8601:2000 standard + %z Replaced by offset from UTC in ISO 8601:2004 standard basic | format (+hhmm or -hhmm), or by no characters if no time zone is determinable. For example, "-0430" means 4 hours 30 minutes behind UTC (west of Greenwich). If tm_isdst is zero, the standard time offset is used. If tm_isdst is greater than zero, the daylight savings - time offset if used. If tm_isdst is negative, no char- + time offset is used. If tm_isdst is negative, no char- | acters are returned. %Z Time zone name or abbreviation, or no bytes if no time @@ -216,6 +228,9 @@ representation. %EY Full alternate year representation. + | + %OB Locale's full month name using the locale's alternate | + numeric symbols if applicable. | %Od Day of the month using the locale's alternate numeric symbols. @@ -244,6 +259,10 @@ %OU Week number of the year (Sunday as the first day of the week) using the locale's alternate numeric sym- bols. + | + %OV Week number of the year (Monday as the first day of | + the week as specified in the description for %V) using | + the locale's alternate numeric symbols. | %Ow Number of the weekday (Sunday=0) using the locale's alternate numeric symbols. @@ -266,6 +285,41 @@ Time Zone Local time zone information is used as though tzset(3C) were called. + | + Optional Flag Characters and Optional Field Width | + The following flag characters are accepted and supported to be | + compatible with some other operating systems: | + | + # If applicable, convert the case of the alphabetic | + characters to the other case, i.e., uppercase to | + lowercase or lowercase to uppercase, while trying to | + preserve the first so-called title case character in | + the conversion to uppercase. | + | + - (dash) Do not pad anything for numeric values. | + | + 0 Pad left with zeros for numeric values even in | + cases where the conversion character used with | + is specified with in the DESCRIPTION section such | + that digits are preceded by a space or a blank | + character. This is ignored if conversion characters | + specified with are using locale's alternate numeric | + symbols. | + | + ^ If applicable, convert lowercase characters | + into uppercase characters. | + | + _ (underscore) Pad left with space (0x20) characters for numeric | + values. | + | + When an optional field width is specified before the conversion | + characters, the resultant characters are padded at the left with | + appropriate padding characters if the field width is bigger than | + the width of the resultant characters. If the field width value | + specified is smaller than or equal to the actual width of | + the resultant characters, the resultant characters is presented | + without any truncation or change in length as if there is no | + field width value specified. | RETURN VALUES The strftime(), cftime(), and ascftime() functions return @@ -284,9 +338,21 @@ values corresponding to Thursday, August 28, 1986 at 12:44:36. - strftime (str, strsize, "%A %b %d %j", tmptr) + strftime(str, strsize, "%A %b %d %j", tmptr); | This results in str containing "Thursday Aug 28 240". + | + Example 2 Using flag and field width at conversion specification. | + | + Assuming the data structure pointed to by tmptr has the values | + corresponding to Sunday, December 5, 2009 at 12:00:00 and the current | + locale is POSIX, with the following: | + | + strftime(str, strsize, "Day:%#10A", tmptr); | + | + The result in str would be "Day: SUNDAY" where Sunday is | + converted to uppercase while preserving the initial title case | + character and with four space (0x20) characters padded at left. | ATTRIBUTES See attributes(5) for descriptions of the following attri- @@ -337,5 +403,12 @@ input date is outside the range 20:45:52 UTC, December 13, 1901 to 03:14:07 UTC, January 19, 2038, the timezone name may not be correct. + | + The conversion specifications for %+, %P, %s, %OB, and %OV | + and also optional flag characters and optional field width | + were added in the Solaris 11 and OpenSolaris releases for | + a better compatibility with other operating systems. The current | + form of %OV is also specified in the Single Unix Specification | + Version 2 and onward. | SunOS 5.11 Last change: 5 Sep 2006 1