akr	2011-08-26 01:39:37 +0900 (Fri, 26 Aug 2011)

  New Revision: 33070

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=33070

  Log:
    update doc.

  Modified files:
    trunk/time.c

Index: time.c
===================================================================
--- time.c	(revision 33069)
+++ time.c	(revision 33070)
@@ -4473,12 +4473,23 @@
  *  This method is similar to strftime() function defined in ISO C and POSIX.
  *  Several directives (%a, %A, %b, %B, %c, %p, %r, %x, %X, %E*, %O* and %Z)
  *  are locale dependent in the function.
- *  However this method is locale independent since Ruby 1.9.
+ *  However this method is almost locale independent since Ruby 1.9.
+ *  (%Z is only the locale dependent directive.)
  *  So, the result may differ even if a same format string is used in other
  *  systems such as C.
  *  It is good practice to avoid %x and %X because there are corresponding
  *  locale independent representations, %D and %T.
  *
+ *  %z is recommended over %Z.
+ *  %Z doesn't identify the timezone.
+ *  For example, "CST" is used at America/Chicago (-06:00),
+ *  America/Havana (-05:00), Asia/Harbin (+08:00), Australia/Darwin (+09:30)
+ *  and Australia/Adelaide (+10:30).
+ *  Also, %Z is highly dependent for OS.
+ *  For example, it may generate a non ASCII string on Japanese Windows.
+ *  i.e. the result can be different to "JST".
+ *  So the numeric time zone offset, %z, is recommended.
+ *
  *  Examples:
  *
  *    t = Time.new(2007,11,19,8,37,48,"-06:00") #=> 2007-11-19 08:37:48 -0600

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/