Locale Helper

Define the abbreviated weekday names for calendar systems with weeks of constant length, to be referenced by the %a field descriptor. The length of the week and a Gregorian date for the first weekday is defined by the "week" keyword. The operand consists of semicolon- separated strings. The first string is the abbreviated name of the day corresponding to the first day of the week (default Sunday), the second the abbreviated name of the day corresponding to the second day of the week (default Monday), and so on.

Define the appropriate representation of a person’s name and title. The operand consists of a string, and can contain any combination of characters and field descriptors. In addition, the string can contain field descriptors defined below.

%f

Family names.

%F

Family names in uppercase.

%g

First given name.

%G

First given initial.

%l

First given name with latin letters. In some cultures, eg on Taiwan it is customary to also have a first name written with Latin letters, although the rest of the name is written in another script.

%o

Other shorter name, eg. "Bill".

%m

Additional given names.

%M

Initials for additional given names.

%p

Profession.

%s

Salutation, such as "Doctor"

%S

Abbreviated salutation, such as "Mr." or "Dr."

%d

Salutation, using the FDCC-sets conventions, with 1 for the name_gen, 2 for name_mr, 3 for name_mrs, 4 for name_miss, 5 for name_ms.

%t

If the preceding field descriptor resulted in an empty string, then the empty string, else a .

Each field descriptor may have an after the <%> to specify that the information is taken from a Romanized version string of the entity. An initial is any string, normally consisting of one letter and a punctuation mark; the Dutch "IJ" is an example of a two character initial.

Define the appropriate representation of a postal address such as street and city. The proper formatting of a person’s name and title is done with the "name_fmt" keyword of the LC_NAME category. The operand consists of a string, and can contain any combination of characters and field descriptors. In addition, the string can contain field descriptors defined below.

%n

Person’s name, possibly constructed with LC_NAME.

%a

Care of person, or organization.

%f

Firm name.

%d

Department name.

%b

Building name.

%s

Street or block (eg. Japanese) name.

%h

House number or designation.

%N

Insert an <end-of-line> if the previous descriptor’s value was not an empty string; otherwise ignore.

%t

Insert a <space> if the previous descriptor’s value was not an empty string; otherwise ignore.

%r

Room number, door designation.

%e

Floor number.

%C

Country designation, from the keyword.

%l

Local township within town or city

%z

Zip number, postal code.

%T

Town, city.

%S

State, province, or prefecture.

%c

Country, as taken from data record.

Each field descriptor may have an <R> after the <%> to specify that the information is taken from a Romanized version string of the entity.

NOTE: There are a number of variations for specifying a location among the cultures. Some of the information, like the middle names, or even the family name, is not used in some cultures. The specification here should be regarded as a starting point for this problem.