localizer

README

#TODO

Documentation

Index

• func GetLocaleData(tag language.Tag) (*cldr.Locale, error)
• func NamedParameters(format string, params FmtParams) string
• type FmtParams
• type Locale
  • func GetLocale(tag language.Tag) *Locale
  • func NewLocale(tag language.Tag) (loc *Locale, err error)
  • func NewLocaleWithStore(tag language.Tag, source store.TranslationStore) (loc *Locale, err error)
  • func (l *Locale) FmtCurrency(currency string, number interface{}) (formatted string, err error)
  • func (l *Locale) FmtCurrencyWhole(currency string, number interface{}) (formatted string, err error)
  • func (l *Locale) FmtDateFull(tim time.Time) (string, error)
  • func (l *Locale) FmtDateLong(tim time.Time) (string, error)
  • func (l *Locale) FmtDateMedium(tim time.Time) (string, error)
  • func (l *Locale) FmtDateShort(tim time.Time) (string, error)
  • func (l *Locale) FmtDateTimeFull(tim time.Time) (string, error)
  • func (l *Locale) FmtDateTimeLong(tim time.Time) (string, error)
  • func (l *Locale) FmtDateTimeMedium(tim time.Time) (string, error)
  • func (l *Locale) FmtDateTimeShort(tim time.Time) (string, error)
  • func (l *Locale) FmtNumber(number interface{}) string
  • func (l *Locale) FmtNumberWhole(number interface{}) string
  • func (l *Locale) FmtPercent(number interface{}) string
  • func (l *Locale) FmtTimeFull(tim time.Time) (string, error)
  • func (l *Locale) FmtTimeLong(tim time.Time) (string, error)
  • func (l *Locale) FmtTimeMedium(tim time.Time) (string, error)
  • func (l *Locale) FmtTimeShort(tim time.Time) (string, error)
  • func (l *Locale) Get(key string) string
  • func (l *Locale) GetPlural(pluralID string, number interface{}, vars ...interface{}) string
  • func (l *Locale) GetTranslations() map[string]store.Translation
  • func (l *Locale) Load(source store.TranslationStore) error
  • func (l *Locale) NewPrinter() *message.Printer

Functions

func GetLocaleData

func GetLocaleData(tag language.Tag) (*cldr.Locale, error)

GetLocaleData finds the best match for tag and returns a *cldr.Locale, which contains data populated from the Unicode CLDR.

func NamedParameters

func NamedParameters(format string, params FmtParams) string

NamedParameters does string formatting on python-style format strings like "Hello %(name)s".

Types

type FmtParams

type FmtParams map[string]interface{}

type Locale

type Locale struct {
	Tag      language.Tag
	Number   cldr.Number
	Calendar cldr.Calendar
	Plural   cldr.Plural
	// contains filtered or unexported fields
}

func GetLocale

func GetLocale(tag language.Tag) *Locale

GetLocale returns a pointer to an existing, already-loaded locale (or nil if if doesn't exist)

func NewLocale

func NewLocale(tag language.Tag) (loc *Locale, err error)

NewLocale instantiates a new Locale for the supplied language tag. It does not load any translations, so it's useful when you only need to use the CLDR data (number/calendar etc). Use NewLocaleWithStore to load translations at initialization time, or call Load on the Locale returned by this function.

func NewLocaleWithStore

func NewLocaleWithStore(tag language.Tag, source store.TranslationStore) (loc *Locale, err error)

NewLocaleWithStore instantiates a new Locale for the supplied language tag. It loads the translations from the source store.TranslationStore. Use this if you know you want your Locale to be populated with translations.

func (*Locale) FmtCurrency

func (l *Locale) FmtCurrency(currency string, number interface{}) (formatted string, err error)

func (*Locale) FmtCurrencyWhole

func (l *Locale) FmtCurrencyWhole(currency string, number interface{}) (formatted string, err error)

func (*Locale) FmtDateFull

func (l *Locale) FmtDateFull(tim time.Time) (string, error)

func (*Locale) FmtDateLong

func (l *Locale) FmtDateLong(tim time.Time) (string, error)

func (*Locale) FmtDateMedium

func (l *Locale) FmtDateMedium(tim time.Time) (string, error)

func (*Locale) FmtDateShort

func (l *Locale) FmtDateShort(tim time.Time) (string, error)

func (*Locale) FmtDateTimeFull

func (l *Locale) FmtDateTimeFull(tim time.Time) (string, error)

func (*Locale) FmtDateTimeLong

func (l *Locale) FmtDateTimeLong(tim time.Time) (string, error)

func (*Locale) FmtDateTimeMedium

func (l *Locale) FmtDateTimeMedium(tim time.Time) (string, error)

func (*Locale) FmtDateTimeShort

func (l *Locale) FmtDateTimeShort(tim time.Time) (string, error)

func (*Locale) FmtNumber

func (l *Locale) FmtNumber(number interface{}) string

func (*Locale) FmtNumberWhole

func (l *Locale) FmtNumberWhole(number interface{}) string

func (*Locale) FmtPercent

func (l *Locale) FmtPercent(number interface{}) string

func (*Locale) FmtTimeFull

func (l *Locale) FmtTimeFull(tim time.Time) (string, error)

func (*Locale) FmtTimeLong

func (l *Locale) FmtTimeLong(tim time.Time) (string, error)

func (*Locale) FmtTimeMedium

func (l *Locale) FmtTimeMedium(tim time.Time) (string, error)

func (*Locale) FmtTimeShort

func (l *Locale) FmtTimeShort(tim time.Time) (string, error)

func (*Locale) Get

func (l *Locale) Get(key string) string

Get returns the raw translated string from the catalog, with no formatting.

func (*Locale) GetPlural

func (l *Locale) GetPlural(pluralID string, number interface{}, vars ...interface{}) string

GetPlural determines which plural form should be used for the supplied number. number can be an int type (including int64) or a float formatted as a string. It then determines which plural form should be used by calling the cldr plural function, and returns the corresponding plural translation, formatted with the optional vars.

func (*Locale) GetTranslations

func (l *Locale) GetTranslations() map[string]store.Translation

GetTranslations returns the entire catalog of translations currently loaded for this locale. This allows for enumeration of the catalog. Note that it returns a copy so that the internal store can continue to be protected by mutexes.

func (*Locale) Load

func (l *Locale) Load(source store.TranslationStore) error

Load retrieves all translations from the supplied store.TranslationStore and prepares them for use in this Locale.

func (*Locale) NewPrinter

func (l *Locale) NewPrinter() *message.Printer

NewPrinter creates a message.Printer for the Locale