Changes from Version 1 of ChapterLocale

Author:

keinfarbton (IP: 84.161.94.155)

Timestamp:

12/08/07 16:19:23 (16 years ago)

Comment:

Initial version. Copy of some ddoc and links to modules.

ChapterLocale

@@ +1 @@
+[[TOC()]]
+
+= Locale =
+
+== Culture ==
+
+'''Docs:''' [[docs(Culture,tango.text.locale.Core.html)]]
+
+Provides information about a culture, such as its name, calendar and date and number format patterns.
+'''Remarks:''' tango.text.locale adopts the RFC 1766 standard for culture names in the format <language>"-"<region>.
+<language> is a lower-case two-letter code defined by ISO 639-1. <region> is an upper-case
+two-letter code defined by ISO 3166. For example, "en-GB" is UK English.
+
+There are three types of culture: invariant, neutral and specific. The invariant culture is not tied to
+any specific region, although it is associated with the English language. A neutral culture is associated with
+a language, but not with a region. A specific culture is associated with a language and a region. "es" is a neutral
+culture. "es-MX" is a specific culture.
+
+Instances of [[docs(DateTimeFormat,tango.text.locale.Core.html)]] and [[docs(NumberFormat,tango.text.locale.Core.html)]] cannot be created for neutral cultures.
+Examples:
+
+{{{
+#!d
+import tango.io.Stdout, tango.text.locale.Core;
+
+void main() {
+  Culture culture = new Culture("it-IT");
+
+  Stdout.formatln("englishName: {}", culture.englishName);
+  Stdout.formatln("nativeName: {}", culture.nativeName);
+  Stdout.formatln("name: {}", culture.name);
+  Stdout.formatln("parent: {}", culture.parent.name);
+  Stdout.formatln("isNeutral: {}", culture.isNeutral);
+}
+}}}
+
+Produces the following output:
+{{{
+englishName: Italian (Italy)
+nativeName: italiano (Italia)
+name: it-IT
+parent: it
+isNeutral: false
+}}}
+
+The users Culture can be obtained by using the zero argument constructor:
+{{{
+#!d
+  Culture culture = new Culture(); // users culture
+}}}
+
+'''Note:''' On linux this first looks at the environment variable "LC_ALL" then at "LANG".
+
+== Convert ==
+
+'''Docs:''' [[docs(Convert,tango.text.locale.Convert.html)]]
+
+Convert date and time to culture specific output.
+
+== Collation ==
+
+'''Docs:''' [[docs(Collation,tango.text.locale.Collation.html)]]
+
+String comparison
+
+== Locale ==
+
+'''Docs:''' [[docs(Locale,tango.text.locale.Locale.html)]]
+
+A Layout which does number formating in a culture sensitive way.
+
+== Parse ==
+
+'''Docs:''' [[docs(Parse,tango.text.locale.Parse.html)]]
+
+Parse dates and time with given culture.
+
+
+