|
4
|
1 .. -*- mode: rst; encoding: utf-8 -*-
|
|
|
2
|
|
|
3 ====================
|
|
|
4 Locale Display Names
|
|
|
5 ====================
|
|
|
6
|
|
|
7 .. contents:: Contents
|
|
|
8 :depth: 2
|
|
|
9 .. sectnum::
|
|
|
10
|
|
|
11
|
|
|
12 Introduction
|
|
|
13 ============
|
|
|
14
|
|
|
15 While `message catalogs <catalogs.html>`_ allow you to localize any messages
|
|
|
16 in your application, there are a number of strings that are used in many
|
|
|
17 applications for which translations are readily available.
|
|
|
18
|
|
|
19 Imagine for example you have a list of countries that users can choose from,
|
|
|
20 and you'd like to display the names of those countries in the language the
|
|
|
21 user prefers. Instead of translating all those country names yourself in your
|
|
|
22 application, you can make use of the translations provided by the locale data
|
|
|
23 included with Babel, which is based on the `Common Locale Data Repository
|
|
|
24 (CLDR) <http://unicode.org/cldr/>`_ developed and maintained by the `Unicode
|
|
|
25 Consortium <http://unicode.org/>`_.
|
|
|
26
|
|
|
27
|
|
|
28 The ``Locale`` Class
|
|
|
29 ====================
|
|
|
30
|
|
|
31 You normally access such locale data through the `Locale`_ class provided
|
|
|
32 by Babel::
|
|
|
33
|
|
|
34 >>> from babel import Locale
|
|
|
35 >>> locale = Locale('en', 'US')
|
|
|
36 >>> locale.territories['US']
|
|
|
37 u'United States'
|
|
|
38 >>> locale = Locale('es', 'MX')
|
|
|
39 >>> locale.territories['US']
|
|
|
40 u'Estados Unidos'
|
|
|
41
|
|
|
42 .. _`Locale`: api/babel.core.Locale-class.html
|
|
|
43
|
|
|
44 In addition to country/territory names, the locale data also provides access to
|
|
|
45 names of languages, scripts, variants, time zones, and more. Some of the data
|
|
|
46 is closely related to `number and date formatting`_.
|
|
|
47
|
|
|
48 Most of the corresponding ``Locale`` properties return dictionaries, where the
|
|
|
49 key is a code such as the ISO country and language codes. Consult the API
|
|
|
50 documentation for references to the relevant specifications.
|
|
|
51
|
|
|
52 .. _`number and date formatting`: formatting.html
|
|
27
|
53
|
|
|
54
|
|
|
55 Calender Display Names
|
|
|
56 ======================
|
|
|
57
|
|
|
58 The `Locale`_ class provides access to many locale display names related to
|
|
|
59 calendar display, such as the names of week days or months.
|
|
|
60
|
|
|
61 These display names are of course used for date formatting, but can also be
|
|
|
62 used, for example, to show a list of months to the user in their preferred
|
|
|
63 language::
|
|
|
64
|
|
|
65 >>> locale = Locale('es')
|
|
|
66 >>> month_names = locale.months['format']['wide'].items()
|
|
|
67 >>> month_names.sort()
|
|
|
68 >>> for idx, name in month_names:
|
|
|
69 ... print name
|
|
|
70 enero
|
|
|
71 febrero
|
|
|
72 marzo
|
|
|
73 abril
|
|
|
74 mayo
|
|
|
75 junio
|
|
|
76 julio
|
|
|
77 agosto
|
|
|
78 septiembre
|
|
|
79 octubre
|
|
|
80 noviembre
|
|
|
81 diciembre
|
