Cardinalities
-
CARDINALITY_ZERO
Matches
n = 0Example Integers:
0Example Decimals:
0.0, 0.00, 0.000, 0.0000 -
CARDINALITY_ONE
Matches
n = 1Example Integers:
1Example Decimals:
1.0, 1.00, 1.000, 1.0000 -
CARDINALITY_TWO
Matches
n = 2Example Integers:
2Example Decimals:
2.0, 2.00, 2.000, 2.0000 -
CARDINALITY_FEW
Matches
n = 3Example Integers:
3Example Decimals:
3.0, 3.00, 3.000, 3.0000 -
CARDINALITY_MANY
Matches
n = 6Example Integers:
6Example Decimals:
6.0, 6.00, 6.000, 6.0000 -
CARDINALITY_OTHER
Matches
all other valuesExample Integers:
4, 5, 7, 20, 100, 1000, 10000, 100000, 1000000, …Example Decimals:
0.1, 0.9, 1.1, 1.7, 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 cy 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_ZERO": "{{formattedCardinalityValue}} cŵn, {{formattedCardinalityValue}} cathod", "CARDINALITY_ONE": "{{formattedCardinalityValue}} ci, {{formattedCardinalityValue}} gath", "CARDINALITY_TWO": "{{formattedCardinalityValue}} gi, {{formattedCardinalityValue}} gath", "CARDINALITY_FEW": "{{formattedCardinalityValue}} chi, {{formattedCardinalityValue}} cath", "CARDINALITY_MANY": "{{formattedCardinalityValue}} chi, {{formattedCardinalityValue}} chath", "CARDINALITY_OTHER": "{{formattedCardinalityValue}} ci, {{formattedCardinalityValue}} cath" } } } } }
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("cy"); 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_ZERO Number zeroCardinalityValue = 0; String zeroFormattedCardinalityValue = numberFormat.format(zeroCardinalityValue); assertEquals(Cardinality.ZERO, Cardinality.forNumber(zeroCardinalityValue, locale)); // Expected: 0 cŵn, 0 cathod assertEquals( zeroFormattedCardinalityValue + " cŵn, " + zeroFormattedCardinalityValue + " cathod", strings.get( "Cardinality.MinimalPair", Map.of( "cardinalityValue", zeroCardinalityValue, "formattedCardinalityValue", zeroFormattedCardinalityValue ) ) ); // CARDINALITY_ONE Number oneCardinalityValue = 1; String oneFormattedCardinalityValue = numberFormat.format(oneCardinalityValue); assertEquals(Cardinality.ONE, Cardinality.forNumber(oneCardinalityValue, locale)); // Expected: 1 ci, 1 gath assertEquals( oneFormattedCardinalityValue + " ci, " + oneFormattedCardinalityValue + " gath", strings.get( "Cardinality.MinimalPair", Map.of( "cardinalityValue", oneCardinalityValue, "formattedCardinalityValue", oneFormattedCardinalityValue ) ) ); // CARDINALITY_TWO Number twoCardinalityValue = 2; String twoFormattedCardinalityValue = numberFormat.format(twoCardinalityValue); assertEquals(Cardinality.TWO, Cardinality.forNumber(twoCardinalityValue, locale)); // Expected: 2 gi, 2 gath assertEquals( twoFormattedCardinalityValue + " gi, " + twoFormattedCardinalityValue + " gath", strings.get( "Cardinality.MinimalPair", Map.of( "cardinalityValue", twoCardinalityValue, "formattedCardinalityValue", twoFormattedCardinalityValue ) ) ); // CARDINALITY_FEW Number fewCardinalityValue = 3; String fewFormattedCardinalityValue = numberFormat.format(fewCardinalityValue); assertEquals(Cardinality.FEW, Cardinality.forNumber(fewCardinalityValue, locale)); // Expected: 3 chi, 3 cath assertEquals( fewFormattedCardinalityValue + " chi, " + fewFormattedCardinalityValue + " cath", strings.get( "Cardinality.MinimalPair", Map.of( "cardinalityValue", fewCardinalityValue, "formattedCardinalityValue", fewFormattedCardinalityValue ) ) ); // CARDINALITY_MANY Number manyCardinalityValue = 6; String manyFormattedCardinalityValue = numberFormat.format(manyCardinalityValue); assertEquals(Cardinality.MANY, Cardinality.forNumber(manyCardinalityValue, locale)); // Expected: 6 chi, 6 chath assertEquals( manyFormattedCardinalityValue + " chi, " + manyFormattedCardinalityValue + " chath", strings.get( "Cardinality.MinimalPair", Map.of( "cardinalityValue", manyCardinalityValue, "formattedCardinalityValue", manyFormattedCardinalityValue ) ) ); // CARDINALITY_OTHER Number otherCardinalityValue = 4; String otherFormattedCardinalityValue = numberFormat.format(otherCardinalityValue); assertEquals(Cardinality.OTHER, Cardinality.forNumber(otherCardinalityValue, locale)); // Expected: 4 ci, 4 cath assertEquals( otherFormattedCardinalityValue + " ci, " + otherFormattedCardinalityValue + " cath", 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_ZERO - CARDINALITY_ONE
Matches
CARDINALITY_ONE -
CARDINALITY_ZERO - CARDINALITY_TWO
Matches
CARDINALITY_TWO -
CARDINALITY_ZERO - CARDINALITY_FEW
Matches
CARDINALITY_FEW -
CARDINALITY_ZERO - CARDINALITY_MANY
Matches
CARDINALITY_MANY -
CARDINALITY_ZERO - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER -
CARDINALITY_ONE - CARDINALITY_TWO
Matches
CARDINALITY_TWO -
CARDINALITY_ONE - CARDINALITY_FEW
Matches
CARDINALITY_FEW -
CARDINALITY_ONE - CARDINALITY_MANY
Matches
CARDINALITY_MANY -
CARDINALITY_ONE - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER -
CARDINALITY_TWO - CARDINALITY_FEW
Matches
CARDINALITY_FEW -
CARDINALITY_TWO - CARDINALITY_MANY
Matches
CARDINALITY_MANY -
CARDINALITY_TWO - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER -
CARDINALITY_FEW - CARDINALITY_MANY
Matches
CARDINALITY_MANY -
CARDINALITY_FEW - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER -
CARDINALITY_MANY - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER -
CARDINALITY_OTHER - CARDINALITY_ONE
Matches
CARDINALITY_ONE -
CARDINALITY_OTHER - CARDINALITY_TWO
Matches
CARDINALITY_TWO -
CARDINALITY_OTHER - CARDINALITY_FEW
Matches
CARDINALITY_FEW -
CARDINALITY_OTHER - CARDINALITY_MANY
Matches
CARDINALITY_MANY -
CARDINALITY_OTHER - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER
Cardinality range example
The start and end cardinalities select the locale's CLDR range result. The selected form wraps a separately formatted display range.
Sample localized strings file
{ "Delivery.Window": { "commentary": "Estimated delivery window, expressed as a range of days.", "translation": "{{window}}", "placeholders": { "window": { "range": { "start": "minDays", "end": "maxDays" }, "translations": { "CARDINALITY_ZERO": "{{formattedDayRange}} diwrnod", "CARDINALITY_ONE": "{{formattedDayRange}} diwrnod", "CARDINALITY_TWO": "{{formattedDayRange}} ddiwrnod", "CARDINALITY_FEW": "{{formattedDayRange}} diwrnod", "CARDINALITY_MANY": "{{formattedDayRange}} diwrnod", "CARDINALITY_OTHER": "{{formattedDayRange}} diwrnod" } } } } }
Usage and expected results
The Java code passes raw range endpoints for selection. Because NumberFormat formats one number at a time, it formats both endpoints separately and joins them for display; choose range punctuation appropriate to your application.
Locale locale = Locale.forLanguageTag("cy"); 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 range Number minDays = 0; String formattedMinDays = numberFormat.format(minDays); Number maxDays = 1; String formattedMaxDays = numberFormat.format(maxDays); String formattedDayRange = formattedMinDays + "-" + formattedMaxDays; assertEquals(Cardinality.ONE, Cardinality.forRange( Cardinality.forNumber(minDays, locale), Cardinality.forNumber(maxDays, locale), locale )); // Expected: 0-1 diwrnod assertEquals(formattedDayRange + " diwrnod", strings.get( "Delivery.Window", Map.of("minDays", minDays, "maxDays", maxDays, "formattedDayRange", formattedDayRange) ));
Ordinalities
-
ORDINALITY_ZERO
Matches
n = 0,7,8,9Example Integers:
0, 7, 9 -
ORDINALITY_ONE
Matches
n = 1Example Integers:
1 -
ORDINALITY_TWO
Matches
n = 2Example Integers:
2 -
ORDINALITY_FEW
Matches
n = 3,4Example Integers:
3, 4 -
ORDINALITY_MANY
Matches
n = 5,6Example Integers:
5, 6 -
ORDINALITY_OTHER
Matches
all other valuesExample Integers:
10, 25, 100, 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 cy 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_ZERO": "{{formattedOrdinalValue}}fed ci", "ORDINALITY_ONE": "ci {{formattedOrdinalValue}}af", "ORDINALITY_TWO": "{{formattedOrdinalValue}}il gi", "ORDINALITY_FEW": "{{formattedOrdinalValue}}ydd ci", "ORDINALITY_MANY": "{{formattedOrdinalValue}}ed ci", "ORDINALITY_OTHER": "ci rhif {{formattedOrdinalValue}}" } } } } }
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("cy"); 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_ZERO Number zeroOrdinalValue = 0; String zeroFormattedOrdinalValue = numberFormat.format(zeroOrdinalValue); assertEquals(Ordinality.ZERO, Ordinality.forNumber(zeroOrdinalValue, locale)); // Expected: 0fed ci assertEquals(zeroFormattedOrdinalValue + "fed ci", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", zeroOrdinalValue, "formattedOrdinalValue", zeroFormattedOrdinalValue) )); // ORDINALITY_ONE Number oneOrdinalValue = 1; String oneFormattedOrdinalValue = numberFormat.format(oneOrdinalValue); assertEquals(Ordinality.ONE, Ordinality.forNumber(oneOrdinalValue, locale)); // Expected: ci 1af assertEquals("ci " + oneFormattedOrdinalValue + "af", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", oneOrdinalValue, "formattedOrdinalValue", oneFormattedOrdinalValue) )); // ORDINALITY_TWO Number twoOrdinalValue = 2; String twoFormattedOrdinalValue = numberFormat.format(twoOrdinalValue); assertEquals(Ordinality.TWO, Ordinality.forNumber(twoOrdinalValue, locale)); // Expected: 2il gi assertEquals(twoFormattedOrdinalValue + "il gi", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", twoOrdinalValue, "formattedOrdinalValue", twoFormattedOrdinalValue) )); // ORDINALITY_FEW Number fewOrdinalValue = 3; String fewFormattedOrdinalValue = numberFormat.format(fewOrdinalValue); assertEquals(Ordinality.FEW, Ordinality.forNumber(fewOrdinalValue, locale)); // Expected: 3ydd ci assertEquals(fewFormattedOrdinalValue + "ydd ci", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", fewOrdinalValue, "formattedOrdinalValue", fewFormattedOrdinalValue) )); // ORDINALITY_MANY Number manyOrdinalValue = 5; String manyFormattedOrdinalValue = numberFormat.format(manyOrdinalValue); assertEquals(Ordinality.MANY, Ordinality.forNumber(manyOrdinalValue, locale)); // Expected: 5ed ci assertEquals(manyFormattedOrdinalValue + "ed ci", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", manyOrdinalValue, "formattedOrdinalValue", manyFormattedOrdinalValue) )); // ORDINALITY_OTHER Number otherOrdinalValue = 10; String otherFormattedOrdinalValue = numberFormat.format(otherOrdinalValue); assertEquals(Ordinality.OTHER, Ordinality.forNumber(otherOrdinalValue, locale)); // Expected: ci rhif 10 assertEquals("ci rhif " + otherFormattedOrdinalValue, 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:
nabsolute value of the source number (integer and decimals)iinteger digits ofnvnumber of visible fraction digits inn, with trailing zeroswnumber of visible fraction digits inn, without trailing zerosfvisible fractional digits inn, with trailing zerostvisible fractional digits inn, without trailing zerosc/ecompact decimal exponent operands used by some CLDR compact-number rules