1 Module locale🔗ℹ

This module has functions for managing locale strings, for getting and setting locales and retrieving locale-specific conventions. It is important to understand that there isn’t a single locale value that encompasses all purposes, there are a set of categories such as date/time handling, number and currency formatting, and string/character encoding, each of which may have a separate locale identified. In this module there are functions of the form get-category-locale and set-category-locale for each supported category.

1.1 Locale Strings🔗ℹ

The locale strings "C" and "POSIX" are defined for all systems and have well-known behavior.

1.2 Locale Accessors🔗ℹ

procedure (set-monetary-locale locale) → (or/c locale-string? #f)

locale : locale-string?

1.3 Locale Conventions🔗ℹ

• decimal-point - Decimal-point separator used for non-monetary quantities.

• thousands-separator - Separators used to delimit groups of digits to the left of the decimal point for non-monetary quantities.

• grouping - Specifies the amount of digits that form each of the groups to be separated by thousands-separator separator for non-monetary quantities. This is a vector? of nonnegative-integer? values that may contain different grouping sizes for each successive group starting from the right, each number indicating the amount of digits for the group. If the last number in the vector is grouping-repeats the previous value will be used for all remaining groups. For example, assuming thousands-separator is set to "," and the number to represent is one million (1000000):

  • with grouping set to '#(3 grouping-repeats), the number would be represented as: 1,000,000

  • with grouping set to '#(1 2 3 grouping-repeats), the number would be represented as: 1,000,00,0

  • with grouping set to '#(3 1 grouping-repeats), the number would be represented as: 1,0,0,0,000

  • grouping-ends indicates that no further grouping is to be performed.

• international-currency-symbol - International currency symbol. This is formed by the three-letter ISO-4217 entry code for the currency, like "USD" for U.S.-Dollar or "GBP" for Pound Sterling, followed by the character used to separate this symbol from the monetary quantity.

• currency-symbol - Local currency symbol, like "$".

• monetary-decimal-point - Decimal-point separator used for monetary quantities.

• monetary-thousands-separator - Separators used to delimit groups of digits to the left of the decimal point for monetary quantities.

• monetary-grouping - Specifies the amount of digits that form each of the groups to be separated by monetary-thousands-separator separator for monetary quantities. See grouping description above.

• positive-sign - Sign to be used for nonnegative (positive or zero) monetary quantities.

• negative-sign - Sign to be used for negative monetary quantities.

• international-fractional-digits - Same as fractional-digits, but for the international format (instead of the local format).

• fractional-digits - Amount of fractional digits to the right of the decimal point for monetary quantities in the local format.

• pos-cs-precedes - Whether the currency symbol should precede nonnegative (positive or zero) monetary quantities. If this value is 1, the currency symbol should precede; if it is 0, it should follow.

• neg-cs-precedes - Whether the currency symbol should precede negative monetary quantities. If this value is 1, the currency symbol should precede; if it is 0 it should follow.

• pos-sep-by-space - Whether a space should appear between the currency symbol and nonnegative (positive or zero) monetary quantities. If this value is 1, a space should appear; if it is 0 it should not.

• neg-sep-by-space - Whether a space should appear between the currency symbol and negative monetary quantities. If this value is 1, a space should appear; if it is 0 it should not.

• pos-sign-posn - Position of the sign for nonnegative (positive or zero) monetary quantities:

  • 0 : Currency symbol and quantity surrounded by parentheses.

  • 1 : Sign before the quantity and currency symbol.

  • 2 : Sign after the quantity and currency symbol.

  • 3 : Sign right before currency symbol.

  • 4 : Sign right after currency symbol.

  • unspecified-sign-posn : unspecified.

• neg-sign-posn - Position of the sign for negative monetary quantities. See pos-sign-posn above.

• international-pos-cs-precedes - Same as pos-cs-precedes, but for the international format.

• international-neg-cs-precedes - Same as neg-cs-precedes, but for the international format.

• international-pos-sep-by-space - Same as pos-sep-by-space, but for the international format.

• international-neg-sep-by-space - Same as neg-sep-by-space, but for the international format.

• international-pos-sign-posn - Same as pos-sign-posn, but for the international format.

• international-neg-sign-posn - Same as neg-sign-posn, but for the international format.

For example, given the currency value 1.25 the table below shows the effect of the various formatting options above.