Cardinalities
-
CARDINALITY_ONE
Matches
v = 0 and i % 10 = 1 and i % 100 != 11 or f % 10 = 1 and f % 100 != 11Example Integers:
1, 21, 31, 41, 51, 61, 71, 81, 101, 1001, …Example Decimals:
0.1, 1.1, 2.1, 3.1, 4.1, 5.1, 6.1, 7.1, 10.1, 100.1, 1000.1, … -
CARDINALITY_OTHER
Matches
all other valuesExample Integers:
0, 2, 16, 100, 1000, 10000, 100000, 1000000, …Example Decimals:
0.0, 0.2, 1.0, 1.2, 1.7, 10.0, 100.0, 1000.0, 10000.0, 100000.0, 1000000.0, …
Cardinality example
This localized strings file selects the localized form of “day” for a delivery estimate. Raw numbers choose the CLDR category; values formatted for display are interpolated.
Sample localized strings file
{ "Delivery.LeadTime": { "commentary": "Estimated delivery time, expressed in days.", "translation": "{{leadTime}}", "placeholders": { "leadTime": { "value": "dayCount", "translations": { "CARDINALITY_ONE": "{{formattedDayCount}} ден", "CARDINALITY_OTHER": "{{formattedDayCount}} дена" } } } } }
Usage and expected results
JavaScript
The JavaScript code passes each raw number for cardinality selection and formats its display value separately with Intl.NumberFormat.
import { cardinalityForNumber, createStrings } from "lokalized"; import { readStringsFromDirectory } from "lokalized/node"; const locale = "mk"; const strings = createStrings({ localizedStringSupplier: () => readStringsFromDirectory("strings").catalogs, fallbackLocale: locale, localeSupplier: () => locale, }); const numberFormat = new Intl.NumberFormat(locale); // Raw numbers select language forms; Intl.NumberFormat produces the display values // CARDINALITY_ONE const oneDayCount = 1; const oneFormattedDayCount = numberFormat.format(oneDayCount); cardinalityForNumber(oneDayCount, locale).name; // => "CARDINALITY_ONE" strings.get("Delivery.LeadTime", { dayCount: oneDayCount, formattedDayCount: oneFormattedDayCount, }); // => "1 ден" // CARDINALITY_OTHER const otherDayCount = 0; const otherFormattedDayCount = numberFormat.format(otherDayCount); cardinalityForNumber(otherDayCount, locale).name; // => "CARDINALITY_OTHER" strings.get("Delivery.LeadTime", { dayCount: otherDayCount, formattedDayCount: otherFormattedDayCount, }); // => "0 дена"
Java
The Java code passes each raw number for cardinality selection and formats its display value separately with NumberFormat.
Locale locale = Locale.forLanguageTag("mk"); 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 oneDayCount = 1; String oneFormattedDayCount = numberFormat.format(oneDayCount); assertEquals(Cardinality.ONE, Cardinality.forNumber(oneDayCount, locale)); // Expected: 1 ден assertEquals(oneFormattedDayCount + " ден", strings.get( "Delivery.LeadTime", Map.of("dayCount", oneDayCount, "formattedDayCount", oneFormattedDayCount) )); // CARDINALITY_OTHER Number otherDayCount = 0; String otherFormattedDayCount = numberFormat.format(otherDayCount); assertEquals(Cardinality.OTHER, Cardinality.forNumber(otherDayCount, locale)); // Expected: 0 дена assertEquals(otherFormattedDayCount + " дена", strings.get( "Delivery.LeadTime", Map.of("dayCount", otherDayCount, "formattedDayCount", otherFormattedDayCount) ));
Swift
Swift uses pinned CLDR rules for raw numeric values. The display strings in these assertions are fixed examples; applications format display values separately with Foundation. Default .rtlLocales bidi isolation adds FSI/PDI to interpolated values in right-to-left output.
import Foundation import Lokalized let locale = try LocaleTag("mk") let files = try LocalizedStringLoader.loadFromDirectory(URL(fileURLWithPath: "strings")) let catalogs = files.mapValues { LocalizedCatalog(strings: $0.strings) } let strings = try DefaultStrings(configuration: StringsConfiguration( localizedStringSupplier: { catalogs }, localeSupplier: { _ in locale }, fallbackLocale: locale )) // CARDINALITY_ONE let number1 = try NumericValue.forDecimal("1") let category1 = try Cardinality.forNumber(number1, locale: locale.tag) assert(category1 == .one) // This fixed display value makes the translation assertion reproducible. let display1 = "1" let message1 = try strings.get("Delivery.LeadTime", placeholders: [ "dayCount": .number(number1), "formattedDayCount": .text(display1), ]) assert(ExactString(message1) == ExactString("1 ден")) // CARDINALITY_OTHER let number2 = try NumericValue.forDecimal("0") let category2 = try Cardinality.forNumber(number2, locale: locale.tag) assert(category2 == .other) // This fixed display value makes the translation assertion reproducible. let display2 = "0" let message2 = try strings.get("Delivery.LeadTime", placeholders: [ "dayCount": .number(number2), "formattedDayCount": .text(display2), ]) assert(ExactString(message2) == ExactString("0 дена"))
Cardinality Ranges
These are CLDR's explicit range mappings. For any start/end pair not listed, the range falls back to the ending cardinality.
-
CARDINALITY_ONE - CARDINALITY_ONE
Matches
CARDINALITY_OTHER -
CARDINALITY_ONE - CARDINALITY_OTHER
Matches
CARDINALITY_OTHER -
CARDINALITY_OTHER - CARDINALITY_ONE
Matches
CARDINALITY_OTHER -
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_ONE": "{{formattedDayRange}} ден", "CARDINALITY_OTHER": "{{formattedDayRange}} дена" } } } } }
Usage and expected results
JavaScript
The JavaScript code passes raw range endpoints for selection, formats both endpoints separately with Intl.NumberFormat, and joins them for display; choose range punctuation appropriate to your application. Range rules are an optional import, lokalized/data/ranges.
import { cardinalityForNumber, createStrings } from "lokalized"; import { cardinalRangeData, cardinalityForRange } from "lokalized/data/ranges"; import { readStringsFromDirectory } from "lokalized/node"; const locale = "mk"; const strings = createStrings({ localizedStringSupplier: () => readStringsFromDirectory("strings").catalogs, fallbackLocale: locale, localeSupplier: () => locale, pluralData: { ranges: cardinalRangeData }, }); const numberFormat = new Intl.NumberFormat(locale); // Raw numbers select language forms; Intl.NumberFormat produces the display values // CARDINALITY_OTHER range const minDays = 1; const formattedMinDays = numberFormat.format(minDays); const maxDays = 21; const formattedMaxDays = numberFormat.format(maxDays); const formattedDayRange = formattedMinDays + "-" + formattedMaxDays; cardinalityForRange( cardinalityForNumber(minDays, locale), cardinalityForNumber(maxDays, locale), locale ).name; // => "CARDINALITY_OTHER" strings.get("Delivery.Window", { minDays, maxDays, formattedDayRange }); // => "1-21 дена"
Java
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("mk"); 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_OTHER range Number minDays = 1; String formattedMinDays = numberFormat.format(minDays); Number maxDays = 21; String formattedMaxDays = numberFormat.format(maxDays); String formattedDayRange = formattedMinDays + "-" + formattedMaxDays; assertEquals(Cardinality.OTHER, Cardinality.forRange( Cardinality.forNumber(minDays, locale), Cardinality.forNumber(maxDays, locale), locale )); // Expected: 1-21 дена assertEquals(formattedDayRange + " дена", strings.get( "Delivery.Window", Map.of("minDays", minDays, "maxDays", maxDays, "formattedDayRange", formattedDayRange) ));
Swift
Swift uses pinned CLDR rules for raw numeric values. The display strings in these assertions are fixed examples; applications format display values separately with Foundation. Default .rtlLocales bidi isolation adds FSI/PDI to interpolated values in right-to-left output.
import Foundation import Lokalized let locale = try LocaleTag("mk") let files = try LocalizedStringLoader.loadFromDirectory(URL(fileURLWithPath: "strings")) let catalogs = files.mapValues { LocalizedCatalog(strings: $0.strings) } let strings = try DefaultStrings(configuration: StringsConfiguration( localizedStringSupplier: { catalogs }, localeSupplier: { _ in locale }, fallbackLocale: locale )) let start = try NumericValue.forDecimal("1") let end = try NumericValue.forDecimal("21") let startForm = try Cardinality.forNumber(start, locale: locale.tag) let endForm = try Cardinality.forNumber(end, locale: locale.tag) let rangeForm = try Cardinality.forRange(startForm, endForm, locale: locale.tag) assert(rangeForm == .other) let message1 = try strings.get("Delivery.Window", placeholders: [ "minDays": .number(start), "maxDays": .number(end), "formattedDayRange": .text("1-21"), ]) assert(ExactString(message1) == ExactString("1-21 дена"))
Ordinalities
-
ORDINALITY_ONE
Matches
i % 10 = 1 and i % 100 != 11Example Integers:
1, 21, 31, 41, 51, 61, 71, 81, 101, 1001, … -
ORDINALITY_TWO
Matches
i % 10 = 2 and i % 100 != 12Example Integers:
2, 22, 32, 42, 52, 62, 72, 82, 102, 1002, … -
ORDINALITY_MANY
Matches
i % 10 = 7,8 and i % 100 != 17,18Example Integers:
7, 8, 27, 28, 37, 38, 47, 48, 57, 58, 67, 68, 77, 78, 87, 88, 107, 1007, … -
ORDINALITY_OTHER
Matches
all other valuesExample Integers:
0, 3, 6, 9, 19, 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 mk 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}}-вата улица десно.", "ORDINALITY_TWO": "Сврти на {{formattedOrdinalValue}}-рата улица десно.", "ORDINALITY_MANY": "Сврти на {{formattedOrdinalValue}}-мата улица десно.", "ORDINALITY_OTHER": "Сврти на {{formattedOrdinalValue}}-тата улица десно." } } } } }
Usage and expected results
JavaScript
The JavaScript code passes each raw number to ordinalityForNumber(...) and formats its display value separately with Intl.NumberFormat. Ordinal rules are an optional import, lokalized/data/ordinal.
import { createStrings } from "lokalized"; import { ordinalData, ordinalityForNumber } from "lokalized/data/ordinal"; import { readStringsFromDirectory } from "lokalized/node"; const locale = "mk"; const strings = createStrings({ localizedStringSupplier: () => readStringsFromDirectory("strings").catalogs, fallbackLocale: locale, localeSupplier: () => locale, pluralData: { ordinal: ordinalData }, }); const numberFormat = new Intl.NumberFormat(locale); // Raw numbers select language forms; Intl.NumberFormat produces the display values // ORDINALITY_ONE const oneOrdinalValue = 1; const oneFormattedOrdinalValue = numberFormat.format(oneOrdinalValue); ordinalityForNumber(oneOrdinalValue, locale).name; // => "ORDINALITY_ONE" strings.get("Ordinal.MinimalPair", { ordinalValue: oneOrdinalValue, formattedOrdinalValue: oneFormattedOrdinalValue, }); // => "Сврти на 1-вата улица десно." // ORDINALITY_TWO const twoOrdinalValue = 2; const twoFormattedOrdinalValue = numberFormat.format(twoOrdinalValue); ordinalityForNumber(twoOrdinalValue, locale).name; // => "ORDINALITY_TWO" strings.get("Ordinal.MinimalPair", { ordinalValue: twoOrdinalValue, formattedOrdinalValue: twoFormattedOrdinalValue, }); // => "Сврти на 2-рата улица десно." // ORDINALITY_MANY const manyOrdinalValue = 7; const manyFormattedOrdinalValue = numberFormat.format(manyOrdinalValue); ordinalityForNumber(manyOrdinalValue, locale).name; // => "ORDINALITY_MANY" strings.get("Ordinal.MinimalPair", { ordinalValue: manyOrdinalValue, formattedOrdinalValue: manyFormattedOrdinalValue, }); // => "Сврти на 7-мата улица десно." // ORDINALITY_OTHER const otherOrdinalValue = 3; const otherFormattedOrdinalValue = numberFormat.format(otherOrdinalValue); ordinalityForNumber(otherOrdinalValue, locale).name; // => "ORDINALITY_OTHER" strings.get("Ordinal.MinimalPair", { ordinalValue: otherOrdinalValue, formattedOrdinalValue: otherFormattedOrdinalValue, }); // => "Сврти на 3-тата улица десно."
Java
The Java code passes each raw number to Ordinality.forNumber(...) and formats its display value separately with NumberFormat.
Locale locale = Locale.forLanguageTag("mk"); 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-вата улица десно. assertEquals("Сврти на " + oneFormattedOrdinalValue + "-вата улица десно.", 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: Сврти на 2-рата улица десно. assertEquals("Сврти на " + twoFormattedOrdinalValue + "-рата улица десно.", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", twoOrdinalValue, "formattedOrdinalValue", twoFormattedOrdinalValue) )); // ORDINALITY_MANY Number manyOrdinalValue = 7; String manyFormattedOrdinalValue = numberFormat.format(manyOrdinalValue); assertEquals(Ordinality.MANY, Ordinality.forNumber(manyOrdinalValue, locale)); // Expected: Сврти на 7-мата улица десно. assertEquals("Сврти на " + manyFormattedOrdinalValue + "-мата улица десно.", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", manyOrdinalValue, "formattedOrdinalValue", manyFormattedOrdinalValue) )); // ORDINALITY_OTHER Number otherOrdinalValue = 3; String otherFormattedOrdinalValue = numberFormat.format(otherOrdinalValue); assertEquals(Ordinality.OTHER, Ordinality.forNumber(otherOrdinalValue, locale)); // Expected: Сврти на 3-тата улица десно. assertEquals("Сврти на " + otherFormattedOrdinalValue + "-тата улица десно.", strings.get( "Ordinal.MinimalPair", Map.of("ordinalValue", otherOrdinalValue, "formattedOrdinalValue", otherFormattedOrdinalValue) ));
Swift
Swift uses pinned CLDR rules for raw numeric values. The display strings in these assertions are fixed examples; applications format display values separately with Foundation. Default .rtlLocales bidi isolation adds FSI/PDI to interpolated values in right-to-left output.
import Foundation import Lokalized let locale = try LocaleTag("mk") let files = try LocalizedStringLoader.loadFromDirectory(URL(fileURLWithPath: "strings")) let catalogs = files.mapValues { LocalizedCatalog(strings: $0.strings) } let strings = try DefaultStrings(configuration: StringsConfiguration( localizedStringSupplier: { catalogs }, localeSupplier: { _ in locale }, fallbackLocale: locale )) let number1 = try NumericValue.forDecimal("1") let category1 = try Ordinality.forNumber(number1, locale: locale.tag) assert(category1 == .one) let message1 = try strings.get("Ordinal.MinimalPair", placeholders: [ "ordinalValue": .number(number1), "formattedOrdinalValue": .text("1"), ]) assert(ExactString(message1) == ExactString("Сврти на 1-вата улица десно.")) let number2 = try NumericValue.forDecimal("2") let category2 = try Ordinality.forNumber(number2, locale: locale.tag) assert(category2 == .two) let message2 = try strings.get("Ordinal.MinimalPair", placeholders: [ "ordinalValue": .number(number2), "formattedOrdinalValue": .text("2"), ]) assert(ExactString(message2) == ExactString("Сврти на 2-рата улица десно.")) let number3 = try NumericValue.forDecimal("7") let category3 = try Ordinality.forNumber(number3, locale: locale.tag) assert(category3 == .many) let message3 = try strings.get("Ordinal.MinimalPair", placeholders: [ "ordinalValue": .number(number3), "formattedOrdinalValue": .text("7"), ]) assert(ExactString(message3) == ExactString("Сврти на 7-мата улица десно.")) let number4 = try NumericValue.forDecimal("3") let category4 = try Ordinality.forNumber(number4, locale: locale.tag) assert(category4 == .other) let message4 = try strings.get("Ordinal.MinimalPair", placeholders: [ "ordinalValue": .number(number4), "formattedOrdinalValue": .text("3"), ]) assert(ExactString(message4) == ExactString("Сврти на 3-тата улица десно."))
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