richardsjoqvist/silverstripe-localdate

There is no license information available for the latest version (1.3.2) of this package.

Translates formatted date strings to the locale set with i18n::set_locale() if there is a matching language file.

1.3.2 2020-05-15 06:40 UTC

This package is not auto-updated.

Last update: 2024-04-13 12:01:37 UTC


README

LocalDate translates formatted date strings if there is a matching language file.

Requirements

  • SilverStripe 3.1 (this module will probably not be updated to SilverStripe 4)

Notes

Installation

  1. Drop the module into your SilverStripe project and run /dev/build
  2. Set the correct locale in your project _config.php using i18n::set_locale('xx_XX');

You may also set the language manually using LocalDateHelper::setLocale('xx_XX'); at any time.

Usage

The module will extend and override SS_Datetime and Date. Existing dates will be automatically translated as long as a valid language file exists as long as they are of SS_Datetime or Date type.

The locale for the translated date is based on (in order):

  1. Any valid locale set with the LocalDateHelper::setLocale('xx_XX');
  2. The current locale for Translatable if the module is installed
  3. The current i18n-setting

If the language file for your locale is missing you can easily create it yourself. Simply use one of the included language files as a template and save it to your /mysite/lang folder. Better yet, fork this repo and add it to the lang-folder and send me a pull request. Sending me an email (mailto:richard@spiro.se) with the translated file attached will also do the trick.