NAME

Locale::Object::DB::Schemata - schema documentation for the Locale::Object database

VERSION

0.31

DESCRIPTION

This module documents the database used by the Locale::Object modules.

THE DATABASE

The database of locale information used by the Locale::Object modules uses DBD::SQLite, and contains several tables.

the 'country' table

    CREATE TABLE country (
        code_alpha2           char(2),
        code_alpha3           char(3),
        code_numeric          smallint,
        name                  char(100),
        dialing_code          smallint,
        utc_offset_main       char(5),
        utc_offsets_all       char(50),
        PRIMARY KEY           (code_alpha2)
    );

    * code_alpha2 , code_alpha3, code_numeric and name are data from ISO 3166 - see http://ftp.ics.uci.edu/pub/ietf/http/related/iso3166.txt.

    * dialing_code is an International Direct Dialing code - see http://kropla.com/dialcode.htm.

    * utc_offset_main is the time offset of the time zone of the country's capital from UTC, expressed decimally in hours. utc_offsets_all is a comma-separated list of offsets for all time zones that the country falls across, listed from west to east. If there is only one value this will match utc_offset_main.

the 'currency' table

    CREATE TABLE currency (
        country_code   char(2),
        name           char(100),
        code           char(3),
        code_numeric   smallint,
        symbol         char(20),
        subunit        char(100),
        subunit_amount smallint,
        PRIMARY KEY  (country_code)
    );

    * country_code contains ISO 3166 two-letter country codes, as in the previous table.

    * name and code contain ISO 4217 three-letter codes and names for world currencies - see http://fx.sauder.ubc.ca/iso4217.html.

    * symbol, subunit and subunit_amount contain currency symbols, subunits (such as cents) and the amounts of subunits that comprise a single currency unit (such as 100 [cents in a dollar]). This data was sourced from http://fx.sauder.ubc.ca/currency_table.html.

the 'continent' table

    CREATE TABLE continent (
        country_code char(2),
        name         char(13),
        PRIMARY KEY  (country_code)
    );

    * country_code contains ISO 3166 two-letter codes again, and name contains associated continent names (Africa, Asia, Europe, North America, Oceania and South America). Sourced from http://www.worldatlas.com/cntycont.htm.

the 'language' table

    CREATE TABLE language (
        code_alpha2  char(2),
        code_alpha3  char(3),
        name         char(100),
        PRIMARY KEY  (code_alpha2)
    );

    * code_alpha2 contains 2-letter ISO 639-1 language codes. See http://www.loc.gov/standards/iso639-2/englangn.html.

    * code_alpha3 contains 3-letter ISO 639-2. There two parts of ISO 639-2, B (for 'bibliographic') and T (for 'terminology'), which differ in 23 instances out of the full list of 464 codes. For simplicity, this module uses the ISO 639-2/T versions. For more information, see the URL above and also http://www.loc.gov/standards/iso639-2/develop.html.

    * name contains the standard names of languages in English as defined by ISO 639.

the 'language_mappings' table

    CREATE TABLE language_mappings (
        id           char(4),
        country      char(2),
        language     char(3),
        official     boolean,
        PRIMARY KEY (id)
    );
    

An example section of this table:

    ID   COUNTRY  LANGUAGE  OFFICIAL
    at_0   at       ger      true
    at_1   at       slv      false
    at_2   at       hrv      false
    at_3   at       hun      false

What this tells us is that in Austria, four languages are spoken: German, Slovenian, Croatian (Hrvatska) and Hungarian, and that only German is an official language of Austria. The mappings are ranked in order of prevalence of language, official languages first, followed by non-official. Please note that this is approximate at best.

My original source for the language-country mappings was http://www.infoplease.com/ipa/A0855611.html. However, there is no clear origin for this list, which occurs in several places on the Web, and it required some serious rationalization before data was able to be usefully extracted for it.

In addition to the preceding, the following sources were invaluable:

AUTHOR

Earle Martin <EMARTIN@cpan.org>

http://purl.oclc.org/net/earlemartin/

CREDITS

See the credits for Locale::Object.

LEGAL

Copyright 2003 Fotango Ltd. All rights reserved. http://opensource.fotango.com/

This module is released under the same license as Perl itself, and is provided on an "as is" basis. The author and Fotango Ltd make no warranties of any kind, either expressed or implied, as to the accuracy and/or utility of any results obtained from its use. However, if you do find something wrong with the results, please let the author know. Thanks.