Azerbaijani azərbaycan

Cardinalities

• CARDINALITY_ONE

  Matches n = 1

  Example Integers: 1

  Example Decimals: 1.0, 1.00, 1.000, 1.0000

• CARDINALITY_OTHER

  Matches all other values

  Example Integers: 0, 2, 16, 100, 1000, 10000, 100000, 1000000, …

  Example Decimals: 0.0, 0.9, 1.1, 1.6, 10.0, 100.0, 1000.0, 10000.0, 100000.0, 1000000.0, …

Cardinality example

This localized strings example uses complete, page-local CLDR minimal-pair patterns to demonstrate every Cardinality category defined for the locale. Minimal-pair text contrasts grammatical forms; it is language-reference data, not reusable application copy.

Source: Unicode CLDR 48.2 az locale data.

Sample localized strings file

{
  "Cardinality.MinimalPair": {
    "commentary": "Demonstrates every CLDR cardinal category defined for this locale.",
    "translation": "{{cardinalityExample}}",
    "placeholders": {
      "cardinalityExample": {
        "value": "cardinalityValue",
        "translations": {
          "CARDINALITY_ONE": "Alış-veriş kartınızda {{formattedCardinalityValue}} var. Alınsın?",
          "CARDINALITY_OTHER": "Alış-veriş kartınızda {{formattedCardinalityValue}} var. Alınsınlar?"
        }
      }
    }
  }
}

Usage and expected results

The Java code passes each raw number for cardinality selection and formats its display value separately with NumberFormat.

Locale locale = Locale.forLanguageTag("az");

Strings strings = Strings.withFallbackLocale(locale)
  .localizedStringSupplier(() -> LocalizedStringLoader.loadFromFilesystem(Paths.get("strings")))
  .localeSupplier((matcher) -> matcher.bestMatchFor(locale))
  .build();

NumberFormat numberFormat = NumberFormat.getNumberInstance(locale);

// Raw numbers select language forms; NumberFormat produces the display values

// CARDINALITY_ONE
Number oneCardinalityValue = 1;
String oneFormattedCardinalityValue = numberFormat.format(oneCardinalityValue);

assertEquals(Cardinality.ONE, Cardinality.forNumber(oneCardinalityValue, locale));

// Expected: Alış-veriş kartınızda 1 var. Alınsın?
assertEquals("Alış-veriş kartınızda " + oneFormattedCardinalityValue + " var. Alınsın?", strings.get(
  "Cardinality.MinimalPair",
  Map.of(
    "cardinalityValue", oneCardinalityValue,
    "formattedCardinalityValue", oneFormattedCardinalityValue
  )
));

// CARDINALITY_OTHER
Number otherCardinalityValue = 0;
String otherFormattedCardinalityValue = numberFormat.format(otherCardinalityValue);

assertEquals(Cardinality.OTHER, Cardinality.forNumber(otherCardinalityValue, locale));

// Expected: Alış-veriş kartınızda 0 var. Alınsınlar?
assertEquals(
  "Alış-veriş kartınızda " + otherFormattedCardinalityValue + " var. Alınsınlar?",
  strings.get(
    "Cardinality.MinimalPair",
    Map.of(
      "cardinalityValue", otherCardinalityValue,
      "formattedCardinalityValue", otherFormattedCardinalityValue
    )
  )
);

Cardinality Ranges

These are CLDR's explicit range mappings. For any start/end pair not listed, Cardinality.forRange(...) falls back to the ending cardinality.

• CARDINALITY_ONE - CARDINALITY_OTHER

  Matches CARDINALITY_OTHER

• CARDINALITY_OTHER - CARDINALITY_ONE

  Matches CARDINALITY_ONE

• CARDINALITY_OTHER - CARDINALITY_OTHER

  Matches CARDINALITY_OTHER

Ordinalities

• ORDINALITY_ONE

  Matches i % 10 = 1,2,5,7,8 or i % 100 = 20,50,70,80

  Example Integers: 1, 2, 5, 7, 8, 11, 12, 15, 17, 18, 20, 22, 25, 101, 1001, …

• ORDINALITY_FEW

  Matches i % 10 = 3,4 or i % 1000 = 100,200,300,400,500,600,700,800,900

  Example Integers: 3, 4, 13, 14, 23, 24, 33, 34, 43, 44, 53, 54, 63, 64, 73, 74, 100, 1003, …

• ORDINALITY_MANY

  Matches i = 0 or i % 10 = 6 or i % 100 = 40,60,90

  Example Integers: 0, 6, 16, 26, 36, 40, 46, 56, 106, 1006, …

• ORDINALITY_OTHER

  Matches all other values

  Example Integers: 9, 10, 19, 29, 30, 39, 49, 59, 69, 79, 109, 1000, 10000, 100000, 1000000, …

Ordinality example

This localized strings example uses complete CLDR minimal-pair patterns to demonstrate every Ordinality category defined for the locale.

Source: Unicode CLDR 48.2 az locale data.

Sample localized strings file

{
  "Ordinal.MinimalPair": {
    "commentary": "Demonstrates every CLDR ordinal category defined for this locale.",
    "translation": "{{ordinalExample}}",
    "placeholders": {
      "ordinalExample": {
        "value": "ordinalValue",
        "translations": {
          "ORDINALITY_ONE": "{{formattedOrdinalValue}}-ci sağ döngəni seçin.",
          "ORDINALITY_FEW": "{{formattedOrdinalValue}}-cü sağ döngəni seçin.",
          "ORDINALITY_MANY": "{{formattedOrdinalValue}}-cı sağ döngəni seçin.",
          "ORDINALITY_OTHER": "{{formattedOrdinalValue}}-cu sağ döngəni seçin."
        }
      }
    }
  }
}

Usage and expected results

The Java code passes each raw number to Ordinality.forNumber(...) and formats its display value separately with NumberFormat.

Locale locale = Locale.forLanguageTag("az");

Strings strings = Strings.withFallbackLocale(locale)
  .localizedStringSupplier(() -> LocalizedStringLoader.loadFromFilesystem(Paths.get("strings")))
  .localeSupplier((matcher) -> matcher.bestMatchFor(locale))
  .build();

NumberFormat numberFormat = NumberFormat.getNumberInstance(locale);

// Raw numbers select language forms; NumberFormat produces the display values

// ORDINALITY_ONE
Number oneOrdinalValue = 1;
String oneFormattedOrdinalValue = numberFormat.format(oneOrdinalValue);

assertEquals(Ordinality.ONE, Ordinality.forNumber(oneOrdinalValue, locale));

// Expected: 1-ci sağ döngəni seçin.
assertEquals(oneFormattedOrdinalValue + "-ci sağ döngəni seçin.", strings.get(
  "Ordinal.MinimalPair",
  Map.of("ordinalValue", oneOrdinalValue, "formattedOrdinalValue", oneFormattedOrdinalValue)
));

// ORDINALITY_FEW
Number fewOrdinalValue = 3;
String fewFormattedOrdinalValue = numberFormat.format(fewOrdinalValue);

assertEquals(Ordinality.FEW, Ordinality.forNumber(fewOrdinalValue, locale));

// Expected: 3-cü sağ döngəni seçin.
assertEquals(fewFormattedOrdinalValue + "-cü sağ döngəni seçin.", strings.get(
  "Ordinal.MinimalPair",
  Map.of("ordinalValue", fewOrdinalValue, "formattedOrdinalValue", fewFormattedOrdinalValue)
));

// ORDINALITY_MANY
Number manyOrdinalValue = 6;
String manyFormattedOrdinalValue = numberFormat.format(manyOrdinalValue);

assertEquals(Ordinality.MANY, Ordinality.forNumber(manyOrdinalValue, locale));

// Expected: 6-cı sağ döngəni seçin.
assertEquals(manyFormattedOrdinalValue + "-cı sağ döngəni seçin.", strings.get(
  "Ordinal.MinimalPair",
  Map.of("ordinalValue", manyOrdinalValue, "formattedOrdinalValue", manyFormattedOrdinalValue)
));

// ORDINALITY_OTHER
Number otherOrdinalValue = 9;
String otherFormattedOrdinalValue = numberFormat.format(otherOrdinalValue);

assertEquals(Ordinality.OTHER, Ordinality.forNumber(otherOrdinalValue, locale));

// Expected: 9-cu sağ döngəni seçin.
assertEquals(otherFormattedOrdinalValue + "-cu sağ döngəni seçin.", strings.get(
  "Ordinal.MinimalPair",
  Map.of("ordinalValue", otherOrdinalValue, "formattedOrdinalValue", otherFormattedOrdinalValue)
));

Addendum: Language Form Rules

The language form expressions above are specified by Unicode Technical Standard #35 and use the following notation:

• n absolute value of the source number (integer and decimals)
• i integer digits of n
• v number of visible fraction digits in n, with trailing zeros
• w number of visible fraction digits in n, without trailing zeros
• f visible fractional digits in n, with trailing zeros
• t visible fractional digits in n, without trailing zeros
• c/e compact decimal exponent operands used by some CLDR compact-number rules