1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update doc.

Browse Source 
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@28591 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
akr 2010-07-09 12:21:43 +00:00
parent 85f10041b2
commit 98e949f7f8
1 changed files with 58 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
time.c
View File

@ -4297,8 +4297,23 @@ strftimev(const char *fmt, VALUE time)
* time.strftime( string ) -> string * time.strftime( string ) -> string
* *
* Formats <i>time</i> according to the directives in the given format * Formats <i>time</i> according to the directives in the given format
* string. Any text not listed as a directive will be passed through * string.
* to the output string. * The directives begins with a percent (%) character.
* Any text not listed as a directive will be passed through to the
* output string.
*
* The directive consists of a percent (%) character,
* zero or more flags, optional precision and a conversion specifier.
*
* Flags:
* - don't pad a numeric result string.
* _ use spaces for padding.
* 0 use zeros for padding.
* ^ upcase the result string.
* # change case.
* : use colons for %z.
*
* The precision specifies the minimum width.
* *
* Format directives: * Format directives:
* *
@ -4308,22 +4323,27 @@ strftimev(const char *fmt, VALUE time)
* %y - Year without a century (00..99) * %y - Year without a century (00..99)
* *
* %m - Month of the year (01..12) * %m - Month of the year (01..12)
* %_m blank-padded ( 1..12)
* %-m no-padded (1..12)
* %B - The full month name (``January'') * %B - The full month name (``January'')
* %^B uppercased (``JANUARY'')
* %b - The abbreviated month name (``Jan'') * %b - The abbreviated month name (``Jan'')
* %^b uppercased (``JAN'')
* %h - Equivalent to %b * %h - Equivalent to %b
* *
* %d - Day of the month (01..31) * %d - Day of the month, zero-padded (01..31)
* %-d no-padded (1..31)
* %e - Day of the month, blank-padded ( 1..31) * %e - Day of the month, blank-padded ( 1..31)
* *
* %j - Day of the year (001..366) * %j - Day of the year (001..366)
* *
* Time (Hour, Minute, Second, Subsecond): * Time (Hour, Minute, Second, Subsecond):
* %H - Hour of the day, 24-hour clock (00..23) * %H - Hour of the day, 24-hour clock, zero-padded (00..23)
* %k - hour, 24-hour clock, blank-padded ( 0..23) * %k - Hour of the day, 24-hour clock, blank-padded ( 0..23)
* %I - Hour of the day, 12-hour clock (01..12) * %I - Hour of the day, 12-hour clock, zero-padded (01..12)
* %l - hour, 12-hour clock, blank-padded ( 0..12) * %l - Hour of the day, 12-hour clock, blank-padded ( 0..12)
* %P - Meridian indicator (``am'' or ``pm'') * %P - Meridian indicator, lowercase (``am'' or ``pm'')
* %p - Meridian indicator (``AM'' or ``PM'') * %p - Meridian indicator, uppercase (``AM'' or ``PM'')
* *
* %M - Minute of the hour (00..59) * %M - Minute of the hour (00..59)
* *
@ -4342,15 +4362,15 @@ strftimev(const char *fmt, VALUE time)
* %Z - Time zone name * %Z - Time zone name
* *
* Weekday: * Weekday:
* %a - The abbreviated weekday name (``Sun'')
* %A - The full weekday name (``Sunday'') * %A - The full weekday name (``Sunday'')
* %^A uppercased (``SUNDAY'')
* %u - Day of the week (Monday is 1, 1..7) * %u - Day of the week (Monday is 1, 1..7)
* %w - Day of the week (Sunday is 0, 0..6) * %w - Day of the week (Sunday is 0, 0..6)
* *
* ISO 8601 week-based year: * ISO 8601 week-based year:
* %G - The week-based year according to ISO 8601 * %G - The week-based year
* %g - The last 2 digits of the week-based year according to ISO 8601 (00..99) * %g - The last 2 digits of the week-based year (00..99)
* %V - Week number of year according to ISO 8601 (01..53) * %V - Week number of the week-based year (01..53)
* *
* Week number: * Week number:
* %U - Week number of the current year, * %U - Week number of the current year,
@ -4379,9 +4399,25 @@ strftimev(const char *fmt, VALUE time)
* %R - 24-hour time (%H:%M) * %R - 24-hour time (%H:%M)
* %T - 24-hour time (%H:%M:%S) * %T - 24-hour time (%H:%M:%S)
* *
* t = Time.now #=> 2007-11-19 08:37:48 -0600 * Examples:
*
* t = Time.new(2007,11,19,8,37,48,"-06:00") #=> 2007-11-19 08:37:48 -0600
* t.strftime("Printed on %m/%d/%Y") #=> "Printed on 11/19/2007" * t.strftime("Printed on %m/%d/%Y") #=> "Printed on 11/19/2007"
* t.strftime("at %I:%M%p") #=> "at 08:37AM" * t.strftime("at %I:%M%p") #=> "at 08:37AM"
*
* # Various ISO 8601 formats:
* t.strftime("%Y%m%s") #=> "20071119" # Calendar date (basic format)
* t.strftime("%F") #=> "2007-11-19" # Calendar date (extended format)
* t.strftime("%Y%j") #=> "2007323" # Ordinal date (basic format)
* t.strftime("%Y-%j") #=> "2007-323" # Ordinal date (extended format)
* t.strftime("%GW%V%u") #=> "2007W471" # Week date (basic format)
* t.strftime("%G-W%V-%u") #=> "2007-W47-1" # Week date (extended format)
* t.strftime("%Y%m%dT%H%M%S%z") #=> "20071119T083748-0600" # Complete representation (basic format)
* t.strftime("%FT%T%:z") #=> "2007-11-19T08:37:48-06:00" # Complete representation (extended format)
* t.strftime("%FT%R") #=> "2007-11-19T08:37" # Calendar date and local time (extended format)
* t.strftime("%Y-%jT%RZ") #=> "2007-323T08:37Z" # Ordinal date and UTC of day (extended format)
* t.strftime("%G-W%V-%uT%R%:z") #=> "2007-W47-1T08:37-06:00" # Week date and local time and difference from UTC (extended format)
*
*/ */
static VALUE static VALUE