Diviner

Class PhutilTranslator

Defined	src/internationalization/PhutilTranslator.php:6
Group	Internationalization

Tasks

Unspecified

public addTranslations()
private chooseVariant()
public formatNumber()
public static getInstance()
public static setInstance()
public setLanguage()
public translate()
public translateDate()
public validateTranslation()

Methods

public PhutilTranslator addTranslations(array $translations)

parameters	array	$translations	Identifier in key, translation in value.
return	PhutilTranslator		Provides fluent interface.

Add translations which will be later used by translate(). The parameter is an array of strings (for simple translations) or arrays (for translastions with variants). The number of items in the array is language specific. It is array($singular, $plural) for English.

array(
  'color' => 'colour',
  '%d beer(s)' => array('%d beer', '%d beers'),
);

The arrays can be nested for strings with more variant parts:

array(
  '%d char(s) on %d row(s)' => array(
    array('%d char on %d row', '%d char on %d rows'),
    array('%d chars on %d row', '%d chars on %d rows'),
  ),
);

The translation should have the same placeholders as originals. Swapping parameter order is possible:

array(
  '%s owns %s.' => '%2$s is owned by %1$s.',
);

private chooseVariant(array $translations, $variant)

parameters	array	$translations
	wild	$variant
return	wild

This method is not documented.

public string formatNumber($number, $decimals = 0)

parameters	float	$number
	int	$decimals
return	string

Format number with grouped thousands and optional decimal part. Requires translations of '.' (decimal point) and ',' (thousands separator). Both these translations must be 1 byte long.

public static getInstance()

return

wild

This method is not documented.

public static setInstance(PhutilTranslator $instance)

parameters	PhutilTranslator	$instance
return	wild

This method is not documented.

public setLanguage($language)

parameters	wild	$language
return	wild

This method is not documented.

public translate($text)

parameters	wild	$text
return	wild

This method is not documented.

public string translateDate($format, DateTime $date)

parameters	string	$format	Format accepted by `DateTime::format()`.
	DateTime	$date
return	string		Formatted and translated date.

Translate date formatted by $date->format().

public validateTranslation($original, $translation)

parameters	wild	$original
	wild	$translation
return	wild

This method is not documented.