Mercurial > babel > mirror

annotate doc/formatting.txt @ 20:c4fc7b88206e trunk

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix typo in doc.
author cmlenz
date Thu, 31 May 2007 17:58:38 +0000
parents 990909fdf98b
children 72bf45adb926
rev   line source
2
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
1 .. -*- mode: rst; encoding: utf-8 -*-
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
2
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
3 ==========================
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
4 Number and Date Formatting
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
5 ==========================
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
6
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
7
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
8 .. contents:: Contents
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
9 :depth: 2
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
10 .. sectnum::
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
11
20896f1e91c6 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
12
18
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
13 Date Formatting
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
14 ===============
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
15
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
16 When working with date and time information in Python, you commonly use the
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
17 classes ``date``, ``datetime`` and/or ``time`` from the `datetime package`_.
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
18 Babel provides functions for locale-specific formatting of those objects in its
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
19 ``dates`` module::
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
20
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
21 >>> from datetime import date, datetime, time
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
22 >>> from babel.dates import format_date, format_datetime, format_time
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
23
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
24 >>> d = date(2007, 4, 1)
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
25 >>> format_date(d, locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
26 u'Apr 1, 2007'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
27 >>> format_date(d, locale='de_DE')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
28 u'01.04.2007'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
29
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
30 As this example demonstrates, Babel will automatically choose a date format
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
31 that is appropriate for the requested locale.
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
32
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
33 The ``format_*()`` functions also accept an optional ``format`` argument, which
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
34 allows you to choose between one of four format variations:
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
35
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
36 * ``short``,
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
37 * ``medium`` (the default),
20
c4fc7b88206e Fix typo in doc.
cmlenz
parents: 18
diff changeset
38 * ``long``, and
c4fc7b88206e Fix typo in doc.
cmlenz
parents: 18
diff changeset
39 * ``full``.
18
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
40
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
41 For example::
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
42
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
43 >>> format_date(d, format='short', locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
44 u'4/1/07'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
45 >>> format_date(d, format='long', locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
46 u'April 1, 2007'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
47 >>> format_date(d, format='full', locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
48 u'Sunday, April 1, 2007'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
49
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
50 .. _`datetime package`: http://docs.python.org/lib/module-datetime.html
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
51
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
52
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
53 Pattern Syntax
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
54 --------------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
55
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
56 While Babel makes it simple to use the appropriate date/time format for a given
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
57 locale, you can also force it to use custom patterns. Note that Babel uses
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
58 different patterns for specifying number and date formats compared to the
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
59 Python equivalents (such as ``time.strftime()``), which have mostly been
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
60 inherited from C and POSIX. The patterns used in Babel are based on the
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
61 `Locale Data Markup Language specification`_ (LDML), which defines them as
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
62 follows:
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
63
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
64 A date/time pattern is a string of characters, where specific strings of
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
65 characters are replaced with date and time data from a calendar when formatting
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
66 or used to generate data for a calendar when parsing. […]
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
67
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
68 Characters may be used multiple times. For example, if ``y`` is used for the
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
69 year, ``yy`` might produce "99", whereas ``yyyy`` produces "1999". For most
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
70 numerical fields, the number of characters specifies the field width. For
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
71 example, if ``h`` is the hour, ``h`` might produce "5", but ``hh`` produces
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
72 "05". For some characters, the count specifies whether an abbreviated or full
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
73 form should be used […]
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
74
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
75 Two single quotes represent a literal single quote, either inside or outside
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
76 single quotes. Text within single quotes is not interpreted in any way (except
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
77 for two adjacent single quotes).
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
78
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
79 For example::
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
80
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
81 >>> d = date(2007, 4, 1)
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
82 >>> format_date(d, "EEE, MMM d, ''yy", locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
83 u"Sun, Apr 1, '07"
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
84 >>> format_date(d, "EEEE, d.M.yyyy", locale='de')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
85 u'Sonntag, 1.4.2007'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
86
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
87 >>> t = time(15, 30)
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
88 >>> format_time(t, "hh 'o''clock' a", locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
89 u"03 o'clock PM"
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
90 >>> format_time(t, 'H:mm a', locale='de')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
91 u'15:30 nachm.'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
92
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
93 >>> dt = datetime(2007, 4, 1, 15, 30)
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
94 >>> format_datetime(dt, "yyyyy.MMMM.dd GGG hh:mm a", locale='en')
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
95 u'02007.April.01 AD 03:30 PM'
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
96
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
97 The syntax for custom datetime format patterns is described in detail in the
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
98 the `Locale Data Markup Language specification`_. The following table is just a
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
99 relatively brief overview.
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
100
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
101 .. _`Locale Data Markup Language specification`: http://unicode.org/reports/tr35/#Date_Format_Patterns
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
102
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
103 -----------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
104 Date Fields
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
105 -----------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
106
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
107 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
108 | Field | Symbol | Description |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
109 +==========+========+========================================================+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
110 | Era | ``G`` | Replaced with the era string for the current date. One |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
111 | | | to three letters for the abbreviated form, four |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
112 | | | lettersfor the long form, five for the narrow form |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
113 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
114 | Year | ``y`` | Replaced by the year. Normally the length specifies |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
115 | | | the padding, but for two letters it also specifies the |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
116 | | | maximum length. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
117 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
118 | | ``Y`` | Same as ``y`` but uses the ISO year-week calendar. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
119 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
120 | | ``u`` | ?? |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
121 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
122 | Quarter | ``Q`` | Use one or two for the numerical quarter, three for |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
123 | | | the abbreviation, or four for the full name. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
124 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
125 | | ``q`` | Use one or two for the numerical quarter, three for |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
126 | | | the abbreviation, or four for the full name. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
127 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
128 | Month | ``M`` | Use one or two for the numerical month, three for the |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
129 | | | abbreviation, or four for the full name, or five for |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
130 | | | the narrow name. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
131 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
132 | | ``L`` | Use one or two for the numerical month, three for the |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
133 | | | abbreviation, or four for the full name, or 5 for the |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
134 | | | narrow name. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
135 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
136 | Week | ``w`` | Week of year. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
137 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
138 | | ``W`` | Week of month. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
139 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
140 | Day | ``d`` | Day of month. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
141 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
142 | | ``D`` | Day of year. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
143 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
144 | | ``F`` | Day of week in month. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
145 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
146 | | ``g`` | ?? |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
147 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
148 | Week day | ``E`` | Day of week. Use one through three letters for the |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
149 | | | short day, or four for the full name, or five for the |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
150 | | | narrow name. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
151 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
152 | | ``e`` | Local day of week. Same as E except adds a numeric |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
153 | | | value that will depend on the local starting day of |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
154 | | | the week, using one or two letters. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
155 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
156 | | ``c`` | ?? |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
157 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
158
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
159 -----------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
160 Time Fields
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
161 -----------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
162
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
163 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
164 | Field | Symbol | Description |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
165 +==========+========+========================================================+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
166 | Period | ``a`` | AM or PM |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
167 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
168 | Hour | ``h`` | Hour [1-12]. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
169 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
170 | | ``H`` | Hour [0-23]. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
171 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
172 | | ``K`` | Hour [0-11]. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
173 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
174 | | ``k`` | Hour [1-24]. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
175 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
176 | Minute | ``m`` | Use one or two for zero places padding. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
177 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
178 | Second | ``s`` | Use one or two for zero places padding. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
179 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
180 | | ``S`` | Fractional second, rounds to the count of letters. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
181 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
182 | | ``A`` | Milliseconds in day. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
183 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
184 | Timezone | ``z`` | Use one to three letters for the short timezone or |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
185 | | | four for the full name. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
186 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
187 | | ``Z`` | Use one to three letters for RFC 822, four letters for |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
188 | | | GMT format. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
189 | +--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
190 | | ``v`` | Use one letter for short wall (generic) time, four for |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
191 | | | long wall time. |
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
192 +----------+--------+--------------------------------------------------------+
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
193
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
194
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
195 Parsing Dates
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
196 -------------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
197
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
198 Babel can also parse date and time information in a locale-sensitive manner::
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
199
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
200 >>> from babel.dates import parse_date, parse_datetime, parse_time
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
201
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
202
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
203 Number Formatting
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
204 =================
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
205
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
206
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
207 Pattern Syntax
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
208 --------------
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
209
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
210
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
211 Parsing Numbers
990909fdf98b Started documentation for date formatting, plus some code tweaks in that area.
cmlenz
parents: 2
diff changeset
212 ---------------
Copyright (C) 2012-2017 Edgewall Software