DateTime::Language - base class for DateTime.pm-related language localization
package DateTime::Language::Gibberish; use base qw(DateTime::Language);
This class provides most of the methods needed to implement language localization for DateTime.pm. A subclass of this language simply provides a set of data structures containing things like day and months names.
This module is a factory for language subclasses, and can load a class either based on the language portion of its name, such as "English", or based on its ISO code, such as "en" or "eng".
This module provides the following methods:
This method loads the requested language and returns an object of the appropriate class. The "language" parameter may be the name of the language subclass to be used, such as "English", as returned by the languages() method. It can also be an ISO 639 two-letter language code. The language code may include an ISO 3166 two-letter country after a dash, so things like "en" or "en-us" are both legal. If a country code is given, then the most specific match is used. For example, if "en-au" (English, Australian) is given, then the nearest match will be "en", which will be used instead.
This tells the module to load the specified language without creating an object. The language given can be anything accepted by the new() method.
Returns a list of supported language names.
Returns a list of supported ISO language codes. See the new() method documentation for details.
People who want to add support for new languages may be interested in subclassing this module.
The simplest way to do this is to simply declare your new module, let's call it DateTime::Language::Inhumi, a subclass of DateTime::Language, and to define a set of global variables in your namespace.
These globals are:
The names of each day, starting with Monday.
Abbreviated names for each day.
The names of each month, starting with January.
Abbreviated names for each month.
The terms used for AM and PM in the language you are implementing.
The DateTime::Language module implements methods that use these globals as needed. If you need to implement more complex algorithms, you can override the following methods:
Returns a list of month names.
Given a DateTime object, this method should return the correct month name.
Returns a list of month abbreviations.
Given a DateTime object, this method should return the correct month abbreviation.
Returns a list of day names.
Given a DateTime object, this method should return the correct day name.
Returns a list of day abbreviations.
Given a DateTime object, this method should return the correct day abbreviation.
Returns a list of the AM/PM texts. First item should be the AM, the second should be the PM.
Given a DateTime object, returns the correct AM or PM abbreviation.
Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for more details.
Dave Rolsky <autarch@urth.org>
However, please see the CREDITS file for more details on who I really stole all the code from.
Copyright (c) 2003 David Rolsky. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Portions of the code in this distribution are derived from other works. Please see the CREDITS file for more details.
The full text of the license can be found in the LICENSE file included with this module.
datetime@perl.org mailing list
