ICU syntax: Cursillo acelerado

Esta libraría analiza y compila las traducciones creadas en la syntaxis ICU. Aunque la sintaxis ICU es un proyecto independiente este es un cursillo acelerado de porqué es interesante y como usar sus principales funcionalidades

¿Porqué usar la sintaxis ICU?

ICU son las siglas de International Components for Unicode. Aunque su popularidad comenzó con C/C++ y Java, es en el ecosistema javascript donde se ha convertido en el standard de facto para internacionalización, aunque también es popular en Python y PHP

Internacionalizar aplicaciones es mucho más que mapear una claves a la traducción apropiada en un diccionario. Aplicaciones internacionalizadas debidamente deben gestional todos los aspectos de la traducción, incluyendo la forma en que fechas y tiempos se formatean, que delimitadores se usan en los números para separar los millares o los decimales, formateo de divisas y soportar lenguages con géneros.

Incluso algo tan aparentemente sencillo como los plurales puede resultar muy complejo en algunos idiomas. El inglés, español y alemán tiene solo un singular y un plural pero algunos idiomas eslavos tienen tres, y otros como el árabe tienen 6 dependiendo del número de elementos. A veces el número a partir del cual se cambia de una forma del plural a la siguiente varía dependiendo de la variante regional.
El ingles no tiene muchas palabras con dos géneros, pero el francés y el español sí, y los adjetivos de esos sustantivos deben respetar su género. Formatear 123456789 en inglés americano resultará en 123,456,789 pero en inglés de la India será 12,34,56,789.
Formateando divisas el símbolo $ va antes de la cantidad pero el € va después.

La sintaxis ICU abstrae toda esta complejidad de los desarrolladores y da a los verdaderos traductores profesionales un meta-lenguage suficientemente expresivo para gestional todas las sutilezas por su cuenta

Interpolaciones

Las entradas ICU soportan interpolar valores, que serán adecuadamente saneados, por lo que pasar undefined not se interpolará como "undefined".

Your favorite color is {chosen}

Plurales

La segunda funcionalidad más usada en cualquier aplicación es la pluralización. La sintaxis ICU proporciona la utilidad plural para definir traducciones para los plurales desde los más sencillos a los más complejos, todo sin salir de la sintaxis en sí misma.

Your have {numCats, plural, one {one cat} other {# cats}}

Your have {numCats, plural, 
  =0 {no cats at all} 
  =1 {one single cat} 
  =2 {a couple cats} 
  =3 {a trio of cats} 
  =12 {a dozen cats} 
  other {exactly # cats}}

Mary {guestCount, plural, offset:1 
  =0 {does not give a party.} 
  =1 {invites {guest} to her party.} 
  =2 {invites {guest} and one other person to her party.} 
  other {invites {guest} and # other people to her party.}}

Algunos idiomas como el inglés solamente utilizan one y other pero otros idiomas serán capaces de seleccionar siempre el plural más adecuando. El límite particular que divide few y many es altamente cultural.

Puedes también especificar traducciones para cantidades específicas usando =N. Cuando un número específico es especificad de esta manera tomará precedencia sobre el comportamiento por defecto de los plurales en ese idioma.
Por ejemplo, en inglés puedes usar =2 o =12 para usar diferentes traducciones específicamente para un par y una docena de elementos en lugar de usar el plural genérico.

Por último, los plurales puedes utilizar la almoadilla para imprimir como número el valor usado para seleccionar el plural y opcionalmente la utilidad puede recibir un offset que se restará del valor antes de reemplazar la almoadilla.

Select

La utilidad select se usa para elegir entre varias posibles traducciones en base al valor de un argumento.
Aunque tener muchos usos el más común es para tener traducciones dependientes del género.

Your {childGender, select, male {son} female {daughter} other {child}} has won an award

Fechas

Your next holidays start on {holidayStart, date, full}

Horas

Idéntico a la utilidad para fechas pero para foratear únicamente la parte temporal de un objecto Date.

Your doctor's appointment is today at {appointment, time, short}

Números

Formatea un número de acuerdo a las reglas del idioma seleccionado.

Your account balance is {num, number}

También hay una funcionalidad avanzada llamada Number Skeletons que te permite personalizar hasta el extremo cómo quieres que los números se formateen.

Your account balance is {num, number, ::currency/EUR}

Your account balance is {num, number, ::currency/EUR sign-always}

Game progress {num, number, ::percent}

Game progress {num, number, ::percent .00}

Game progress {num, number, ::percent .00 scale/100}

Your destination is {num, number, ::unit/meter} away

Your destination is {num, number, ::unit/meter unit-width-full-name} away

Are you sure you want to bid {num, number, ::K} over asking?

Are you sure you want to bid {num, number, ::KK} over asking?

The chances of winning the lottery are 1 in {num, number, ::scientific/*ee}?

Las posibilidades de los number skeleton son ilimitadas.