Skip to the content
Documentation

l10n

No ratings yet

Summary

Formats misc. numbers (times, dates, currencies, numbers, etc.).

Usage

input|l10n( type [, locale [, symbol ] ] )

Parameters

Name Type Description Required
type string The format that should be used. Yes.
locale string The locale that should be used (when type is set to "currency"). No.
symbol string The currency symbol that should be used (when type is set to "currency"). No.

Returns

A string containing a formatted version of the input parameter.

Description

This operator formats/localizes miscellaneous numeric values according to the current locale settings. The value that should be formatted must be input using the input parameter. The "type" parameter must be used to select the desired format. The following list reveals the available formats/types.

  • time
  • shorttime
  • date
  • shortdate
  • datetime
  • shortdatetime
  • currency
  • clean_currency
  • number

In addition, the operator also formats numeric values according to the specified "locale" and "symbol" parameters when the "type" parameter is set to "currency".

Examples

Example 1

{def $number=1234.567
     $timestamp=currentdate()}

time:           {$timestamp|l10n( 'time' )}
shorttime:      {$timestamp|l10n( 'shorttime' )}
date:           {$timestamp|l10n( 'date' )}
shortdate:      {$timestamp|l10n( 'shortdate' )}
datetime:       {$timestamp|l10n( 'datetime' )}
shortdatetime:  {$timestamp|l10n( 'shortdatetime' )}
currency:       {$number|l10n( 'currency' )}
clean_currency: {$number|l10n( 'clean_currency' )}
number:         {$number|l10n( 'number' )}

If the current locale is "eng-GB", the following output will be produced:

time : 1:46:05 pm
shorttime : 1:46 pm
date : Friday 06 February 2004
shortdate : 06/02/2004
datetime : Friday 06 February 2004 1:46:05 pm
shortdatetime : 06/02/2004 1:46 pm
currency : £ 1,234.57
clean_currency : 1,234.57
number : 1,234.57

Example 2

{def $price=1234.57}
The price in local currency : {$price|l10n( 'currency' )} <br />
The price in Norwegian Krone : {$price|l10n( 'currency', 'nor-NO' )} <br />
The price in Norwegian Krone with specified symbol : {$price|l10n( 'currency', 'nor-NO', 'nok' )}

If the current locale is "eng-GB", the following output will be produced:

The price in local currency : £ 1,234.57
The price in Norwegian Krone : kr 1.234,57
The price in Norwegian Krone with specified symbol : nok 1.234,57

Contributors

Comments (1 historical)

Written by readers of the earlier documentation sites, kept as they were.

  1. Get rid of whitespace

    Fabricio ·

    Hi,
    Is it possible to get rid of whitespace after currency sign??
    currently : £ 1,234.57
    can it be : £1,234.57

Comments

Add a comment

Comments are read by a moderator before they appear.