This library extends the Time class:
conversion between date string and time object.
date-time defined by RFC 2822
HTTP-date defined by RFC 2616
dateTime defined by XML Schema Part 2: Datatypes (ISO 8601)
various formats handled by Date._parse (string to time only)
This library provides methods dedicated to special purposes:
RFC 2822, RFC 2616 and XML Schema.
They makes usual life easier.
This library doesn’t use
strftime. Especially rfc2822 doesn’t
%a and %b are locale sensitive
Since they are locale sensitive, they may be replaced to invalid weekday/month name in some locales. Since ruby-1.6 doesn’t invoke setlocale by default, the problem doesn’t arise until some external library invokes setlocale. Ruby/GTK is the example of such library.
%z is not portable
%z is required to generate zone in date-time of RFC 2822 but it is not portable.
Commenting is here to help enhance the documentation. For example, sample code, or clarification of the documentation.
If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.
If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.