Changes between Version 7 and Version 8 of Dev/i18n

Timestamp:

07/28/11 14:53:42 (22 months ago)

Author:

pferreir

Comment:

--

Dev/i18n

@@ -65 +65 @@
 === Dates/Times ===
 
+It is tempting to use Python stdlib's `strftime()` each time we want to convert a `datetime` to a string. However, this function uses the currently set locale by default (process-specific), which is not thread safe. Babel provides a `format_datetime` function that works more or less the same way and can take a locale as parameter. We put a wrapper around it so that it takes the currently defined (thread-specific) Indico locale, making things easier for everyone.
+
+{{{
+#!python
+>>> from indico.util.date_time import format_datetime, now_utc
+
+>>> format_datetime(now_utc())
+'28 Jul 2011 12:38:03'
+
+>>> format_datetime(now_utc(), locale="fr_FR")
+'28 juil. 2011 12:39:23'
+
+>>> format_datetime(now_utc(), locale="fr_FR", format="long", timezone='Europe/Zurich')
+'28 juillet 2011 12:40:05 +0000'
+}}}
+
+Timezones are also supported:
+
+{{{
+#!python
+>>> from pytz import timezone
+>>> format_datetime(now_utc(), locale='pt_PT', format='full', timezone=timezone('Europe/Zurich'))
+'quinta-feira, 28 de Julho de 2011 14H45m18s Horário Suíça'
+}}}
+
+Custom formats may be specified using [http://babel.edgewall.org/wiki/Documentation/dates.html#pattern-syntax LDML]:
+
+{{{
+#!python
+>>> format_datetime(now_utc(), locale='es_ES', format='yyyy G')
+'2011 d.C.'
+}}}
+
+More information can be found at [http://babel.edgewall.org/wiki/Documentation/dates.html Babel's docs on Date Formatting].
+
 === Others ===
+
+http://babel.edgewall.org/wiki/Documentation/numbers.html
+http://babel.edgewall.org/wiki/Documentation/display.html
 
 === Common mistakes ===