1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
# NAME
DateTime::Locale - Localization support for DateTime.pm
# VERSION
version 1.11
# SYNOPSIS
use DateTime::Locale;
my $loc = DateTime::Locale->load('en-GB');
print $loc->native_locale_name, "\n", $loc->datetime_format_long, "\n";
# but mostly just things like ...
my $dt = DateTime->now( locale => 'fr' );
print "Aujourd'hui le mois est " . $dt->month_name, "\n";
# DESCRIPTION
DateTime::Locale is primarily a factory for the various locale subclasses. It
also provides some functions for getting information on all the available
locales.
If you want to know what methods are available for locale objects, then please
read the `DateTime::Locale::FromData` documentation.
# USAGE
This module provides the following class methods:
## DateTime::Locale->load( $locale\_code | $locale\_name )
Returns the locale object for the specified locale code or name - see the
`DateTime::Locale::Catalog` documentation for the list of available codes and
names. The name provided may be either the English or native name.
If the requested locale is not found, a fallback search takes place to
find a suitable replacement.
The fallback search order is:
{language}-{script}-{territory}
{language}-{script}
{language}-{territory}-{variant}
{language}-{territory}
{language}
Eg. For the locale code `es-XX-UNKNOWN` the fallback search would be:
es-XX-UNKNOWN # Fails - no such locale
es-XX # Fails - no such locale
es # Found - the es locale is returned as the
# closest match to the requested id
Eg. For the locale code `es-Latn-XX` the fallback search would be:
es-Latn-XX # Fails - no such locale
es-Latn # Fails - no such locale
es-XX # Fails - no such locale
es # Found - the es locale is returned as the
# closest match to the requested id
If no suitable replacement is found, then an exception is thrown.
The loaded locale is cached, so that **locale objects may be
singletons**. Calling `DateTime::Locale->register()`, `DateTime::Locale->add_aliases()`, or `DateTime::Locale->remove_alias()`
clears the cache.
## DateTime::Locale->codes
my @codes = DateTime::Locale->codes;
my $codes = DateTime::Locale->codes;
Returns an unsorted list of the available locale codes, or an array reference if
called in a scalar context. This list does not include aliases.
## DateTime::Locale->names
my @names = DateTime::Locale->names;
my $names = DateTime::Locale->names;
Returns an unsorted list of the available locale names in English, or an array
reference if called in a scalar context.
## DateTime::Locale->native\_names
my @names = DateTime::Locale->native_names;
my $names = DateTime::Locale->native_names;
Returns an unsorted list of the available locale names in their native
language, or an array reference if called in a scalar context. All native
names in UTF-8 characters as appropriate.
# CLDR DATA BUGS
Please be aware that all locale data has been generated from the CLDR (Common
Locale Data Repository) project locales data). The data is incomplete, and may
contain errors in some locales.
When reporting errors in data, please check the primary data sources first,
then where necessary report errors directly to the primary source via the CLDR
bug report system. See http://unicode.org/cldr/filing\_bug\_reports.html for
details.
Once these errors have been confirmed, please forward the error report and
corrections to the DateTime mailing list, datetime@perl.org.
# AUTHOR EMERITUS
Richard Evans wrote the first version of DateTime::Locale, including the tools
to extract the CLDR data.
# SEE ALSO
[DateTime::Locale::Base](https://metacpan.org/pod/DateTime::Locale::Base)
datetime@perl.org mailing list
http://datetime.perl.org/
# SUPPORT
Bugs may be submitted through [https://github.com/houseabsolute/DateTime-Locale/issues](https://github.com/houseabsolute/DateTime-Locale/issues).
There is a mailing list available for users of this distribution,
[mailto:datetime@perl.org](mailto:datetime@perl.org).
I am also usually active on IRC as 'drolsky' on `irc://irc.perl.org`.
# DONATIONS
If you'd like to thank me for the work I've done on this module, please
consider making a "donation" to me via PayPal. I spend a lot of free time
creating free software, and would appreciate any support you'd care to offer.
Please note that **I am not suggesting that you must do this** in order for me
to continue working on this particular software. I will continue to do so,
inasmuch as I have in the past, for as long as it interests me.
Similarly, a donation made in this way will probably not make me work on this
software much more, unless I get so many donations that I can consider working
on free software full time (let's all have a chuckle at that together).
To donate, log into PayPal and send money to autarch@urth.org, or use the
button at [http://www.urth.org/~autarch/fs-donation.html](http://www.urth.org/~autarch/fs-donation.html).
# AUTHOR
Dave Rolsky <autarch@urth.org>
# CONTRIBUTORS
- Karen Etheridge <ether@cpan.org>
- Mohammad S Anwar <mohammad.anwar@yahoo.com>
# COPYRIGHT AND LICENSE
This software is copyright (c) 2016 by Dave Rolsky.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
|
