Localize Playground

Message

Locale

You have 3 unread messages.

Localize.Message.format(message, %{count: 3}, locale: "en-Latn-US")

MessageFormat 2 syntax — see messageformat.unicode.org for the spec. Bindings are Elixir source; use a map or keyword list.

.input {$count :number}
.match $count
0 {{You have no unread messages.}}
1 {{You have one unread message.}}
* {{You have {$count} unread messages.}}

Pattern	Meaning	Example
`y`	Calendar year. Truncates to min digits.	`2026 · 26`
`yy`	2-digit year.	`26`
`yyyy`	4-digit year (zero-padded).	`2026`
`Y`	Week-based year (ISO).	`2026`
`u`	Extended year.	`2026`
`U`	Cyclic year name (e.g., Chinese zodiac).	`丙午`
`r`	Related Gregorian year.	`2026`

Syntax	Meaning	Example output
`Hello, world!`	Simple message — plain text is a valid message.	`Hello, world!`
`{{Hello, {$name}!}}`	Quoted pattern — required when the message has declarations, matchers, or starts with { or .	`Hello, Aoife!`
`.local $x = {1} {{Value: {$x}}}`	Complex message — declarations followed by a quoted pattern.	`Value: 1`

Syntax	Meaning	Example output
`{$name}`	Variable reference — binds to the bindings map/keyword.	`Aoife`
`{\|literal text\|}`	Literal — explicit quoted value. Rare in practice.	`literal text`
`{42}`	Number literal.	`42`
`{$x :number}`	Annotated variable — applies a function to the value.	`3`
`{$x :number minimumFractionDigits=2}`	Annotated with options.	`3.00`

Syntax	Meaning	Example output
`:string`	Selects/formats a string value (default for strings).
`:number`	Formats a number. Options: minimumFractionDigits, maximumFractionDigits, minimumIntegerDigits, useGrouping, signDisplay, notation.	`1,234.50`
`:integer`	Formats an integer.	`1,234`
`:currency`	Formats as currency. Options: currency=ISO, currencyDisplay=code\|symbol\|name\|narrowSymbol.	`$1,234.56`
`:date`	Formats a date. Options: dateStyle=short\|medium\|long\|full.	`Apr 15, 2026`
`:time`	Formats a time. Options: timeStyle=short\|medium\|long\|full.	`3:04 PM`
`:datetime`	Formats a date and time.	`Apr 15, 2026, 3:04 PM`

Syntax	Meaning	Example output
`.match $count`	Select a variant based on one or more selectors.
`0 {{No items.}}`	Literal variant — matched when $count == 0.	`No items.`
`one {{1 item}}`	Plural keyword variant (:number selector).	`1 item`
`* {{N items.}}`	Default/wildcard variant. Required.	`N items.`
`.match $a $b hi hi {{both hi}} * * {{anything}}`	Multi-selector — one row per combination. Wildcards * act as catch-alls.

Syntax	Meaning	Example output
`.match {$count :number} one {{1 unread}} * {{{$count} unread}}`	Plural message using CLDR plural categories.	`3 unread`
`.match {$gender :string} feminine {{She}} masculine {{He}} * {{They}}`	Gender/string selection.	`They`
`{{Total: {$amount :currency currency=USD}}}`	Currency formatting with options.	`Total: $1,234.56`
`{{Today is {$d :date dateStyle=full}}}`	Long date.	`Today is Wednesday, April 15, 2026`

Pattern	Meaning	Example
`Q`	Quarter number.	`2`
`QQ`	Quarter number, 2-digit.	`02`
`QQQ`	Abbreviated quarter name.	`Q2`
`QQQQ`	Wide quarter name.	`2nd quarter`
`q`	Stand-alone quarter (same but in isolation).	`2`

Pattern	Meaning	Example
`d`	Day of month.	`15`
`dd`	Day of month, 2-digit.	`15`
`D`	Day of year.	`105`
`F`	Day of week in month (e.g., 3rd Tuesday).	`3`
`g`	Modified Julian Day.	`2460785`

Pattern	Meaning	Example
`E`	Abbreviated day name.	`Wed`
`EEEE`	Wide day name.	`Wednesday`
`EEEEE`	Narrow day name.	`W`
`e`	Local day of week (locale-dependent start).	`4`
`c`	Stand-alone day of week.	`4`
`cccc`	Stand-alone wide day name.	`Wednesday`

Pattern	Meaning	Example
`h`	Hour 1–12.	`6`
`hh`	Hour 1–12, 2-digit.	`06`
`H`	Hour 0–23.	`18`
`HH`	Hour 0–23, 2-digit.	`18`
`K`	Hour 0–11.	`6`
`k`	Hour 1–24.	`18`
`j`	Locale's preferred hour field (use in skeletons).	`6 PM`
`J`	Locale's preferred hour without day period.	`18`

Pattern	Meaning	Example
`'text'`	Literal text inside single quotes.	`'at' → at`
`''`	Escaped single quote.	`it's → it''s`
`:`	Time separator placeholder (locale-adjusted).	`:`

Syntax	Meaning	Example output
`.local $x = {expr}`	Bind a local variable to an expression (placeholder).
`.input {$x :number}`	Re-annotate an incoming binding with a function/options.

Syntax	Meaning	Example output
`{#link}Click here{/link}`	Open / close markup — the formatter can emit structured output (HTML, etc.).
`{#img src=\|photo.jpg\| /}`	Self-closing markup with options.

Syntax	Meaning	Example output
`\{`	Literal open brace.	`{`
`\}`	Literal close brace.	`}`
`\\`	Literal backslash.	`\`
`\\|`	Literal pipe inside \|...\| literals.	`\|`