Download the PHP package dotzero/laravel-localized-carbon without Composer
On this page you can find all versions of the php package dotzero/laravel-localized-carbon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-localized-carbon
A localizable version of Carbon for Laravel 5
Localized Carbon is an extension of a popular Carbon package, designed specially for Laravel 5 framework.
By localization I mean its diffForHumans function, which returns a human-readable string of time interval.
This package also supports genitive months by introducing the %f key in formatLocalized method.
Installation
Require this package with Composer using the following command:
Next, add package's Service Provider to app/config/app.php in providers section:
After that you may want to add some Aliases (aliases section of the same config):
Run the command below to publish the lang files into resources/lang:
Usage
Note that DiffFormatter will only be used for extending default localizations.
If you want to use the power of LocalizedCarbon the same way as you did with original Carbon in your models,
you may want to use supplied trait for this in your models:
In this case LocalizedCarbon will be used for all dates in your Eloquent model instead of original Carbon.
This package provides a LocalizedCarbon class which inherits original Carbon, so its usage is absolutely the same as original Carbon's.
But imagine you have a Comment model for example, which has default timestamp fields (created_at and updated_at).
You want to display, how much time has gone since its created_at in a human-readable format.
One way to achieve may be such (in your Blade template):
In this case the class will output something like "5 minutes ago". Note that for just an English version of the string original Carbon would be enough.
This LocalizedCarbon is used to display the message in the current application language. For example, for Russian language it will display "5 минут назад".
But also, you may substitute Laravel's Eloquent model, so the timestamps would be converted to LocalizedCarbon instead of original Carbon.
So the usage could be as if your were using original Carbon:
As in original Carbon, diffForHumans functions has an optional first argument (which is another Carbon instance).
It specified the time to which difference should be calculated. By default (a missing or null value) current time is used.
Also LocalizedCarbon adds an optional second argument, in which you may specify the desired language, or directly a formatter class
which is used to format the difference-string. By default current application language is used. Also you may specify a Closure
in the second parameter which will do formatting. For its signature refer to extending Localized Carbon section.
Supported languages
Current version of Localized Carbon ships with these localizations:
- English (en) (full)
- Russian (ru) (full)
- Ukrainian (uk) (full)
- Dutch (nl) (no genitive)
- Spanish (es) (full)
- Portuguese (pt) (no genitive)
- French (fr) (no genitive)
- Bulgarian (bg) (no genitive)
- Slovakian (sk) (no genitive)
- Turkish (tr) (no genitive)
- Arabic (ar) (no genitive)
- Japanese (ja) (full)
- Bengali (bn) (full)
- Persian (fa) (full)
Extending Localized Carbon
If needed localization is not shipped with this package, you may write your own and extend Localized Carbon with it, not even touching the vendor folder itself.
There are a couple of ways to extend Localized Carbon.
First, you may write your own DiffFormatter class for this, implementing Laravelrus\LocalizedCarbon\DiffFormatters\DiffFormatterInterface.
This interface forces the class to have a single format method which looks like this:
$isNow is a boolean, which is true when the time difference is calculated relevant to current time.
$isFuture is boolean, which is true if the DateTime object is in the future relevant to comparable time.
$delta is an integer, equals to number of units of difference.
$unit is a time-"unit". It can be either: second, minute, hour, day, week, month or year.
So, your format method should return a string based on this arguments. As an example see an existing DiffFormatters
in vendor\laravelrus\localized-carbon\src\Laravelrus\LocalizedCarbon\DiffFormatters directory. You can also reference
a lang-files, using Lang::choice as it is done in Russian localization for example.
When your class is ready, you must register it within the Localized Carbon. For this you must call DiffFormatter::extend
method from within any file which is loaded by the framework. For example, you can do it somewhere in app/start/global.php.
The extend method expects two parameters: first is the language you want to be supported (most often it would be App::getLocale()
if you want just to use application's language). Next is the instance of your formatter, OR just a name of the class
if it can be autoloaded. Consider these examples:
In the latter case the formatter will be autoloaded when it is needed using IoC. Also note that formatter is loaded only once during application life-cycle due to optimization considerations.
The second way to extend is to pass a Closure as the second parameter. It must have the same signature as the format method
of DiffFormatterInterface interface. For example:
Also, there is a possibility to add an alias for an existing language. For example, Localized Carbon is shipped with Ukranian localization,
which is recognized by uk language key. But what if your application uses ua or ukr language, which still means it is Ukranian?
In this case you may add an alias for uk language in this way:
Contributing
If you've written a formatter for the language which is not supported by current version of Localized Carbon out of the box - feel free to make a pull request with it in the current version branch (1.3), but be sure to adjust your formatter for been used by the package.
The formatter should lie in src/Laravelrus/LocalizedCarbon/DiffFormatters directory, following a simple naming convention: the class name
should start with the desired language in lower-case, but the first letter in upper-case. The rest part of the name should be "DiffFormatter".
The file name should correspond to the class name.
For example, the formatter for fr language would lie in src/Laravelrus/LocalizedCarbon/DiffFormatters/FrDiffFormatter.php,
and the class name would be FrDiffFormatter.
Also I need the help of the community to complete the list of genitives for all supported languages. If you know a language
and it uses genitives in dates, feel free to contribute. See an example of Russian or Ukranian lang\XX\months.php files.
License
A localizable version of Carbon is licensed under MIT: http://www.opensource.org/licenses/mit-license.php
