DateTime::Locale::Base.3pm

Langue: en

Autres versions - même langue

Version: 2008-01-22 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

DateTime::Locale::Base - Base class for individual locale objects

SYNOPSIS

   use base 'DateTime::Locale::Base';

DEFAULT FORMATS

Each locale has a set of four default date and time formats. They are distinguished by length, and are called ``full'', ``long'', ``medium'', and ``short''. Each locale may have a different default length which it uses when its "default_date_format()", "default_time_format()", or "default_datetime_format()" methods are called.

This can be changed by calling the "set_default_date_format()" or "set_default_time_format()" methods. These methods accept a string which must be one of ``full'', ``long'', ``medium'', or ``short''.

SUBCLASSING

If you are writing a subclass of this class, then you must provide the following methods:
•
month_names

Returns an array reference containing the full names of the months, with January as the first month.

•
month_abbreviations

Returns an array reference containing the abbreviated names of the months, with January as the first month.

•
month_narrows

Returns an array reference containing the narrow names of the months, with January as the first month. Narrow names are the shortest possible names, and need not be unique.

•
day_names

Returns an array reference containing the full names of the days, with Monday as the first day.

•
day_abbreviations

Returns an array reference containing the abbreviated names of the days, with Monday as the first day.

•
day_narrows

Returns an array reference containing the narrow names of the days, with Monday as the first day. Narrow names are the shortest possible names, and need not be unique.

•
am_pms

Returns an array reference containing the localized forms of ``AM'' and ``PM''.

•
era_abbreviations

Returns an array reference containing the localized forms of the abbreviation for the eras, such as ``BCE'' and ``CE''.

•
era_names

Returns an array reference containing the localized forms the name of the eras, such as ``Before Common Era'' and ``Common Era''.

•
long_date_format, full_date_format, medium_date_format, short_date_format

Returns the date format of the appropriate length.

•
long_time_format, full_time_format, medium_time_format, short_time_format

Returns the date format of the appropriate length.

•
date_before_time

This returns a boolean value indicating whether or not the date comes before the time when formatting a complete date and time for presentation.

•
date_parts_order

This returns a string indicating the order of the parts of a date that is in the form XX/YY/ZZ. The possible values are ``dmy'', ``mdy'', ``ydm'' and ``ymd''.

•
_default_date_format_length

This should return a string which is one of ``long'', ``full'', ``medium'', or ``short''. It indicates the default date format length for the locale.

•
_default_time_format_length

This should return a string which is one of ``long'', ``full'', ``medium'', or ``short''. It indicates the default time format length for the locale.

SUPPORT

Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for more details.

AUTHORS

Richard Evans <rich@ridas.com>

Dave Rolsky <autarch@urth.org>

Copyright (c) 2003 Richard Evans. Copyright (c) 2004-2005 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.

The full text of the license can be found in the LICENSE file included with this module.