Formatting

use Derafu\Date\Service\DateFormatter;

DateFormatter describes a date, a month and the time that has passed. It does not give text: every method gives a TranslatableMessage, and the language is decided by whoever translates it.

$formatter = new DateFormatter();

$message = $formatter->formatDate('2024-01-15');

$message->trans($translator, 'es');   // Lunes, 15 de Enero del 2024
(string) $message;                    // Monday, January 15, 2024

Without a translator the message is written in English, which is the language of its id.

formatElapsed() describes the time between the date and the clock (the system clock, or the one that is given to the constructor). It gives the two largest units (1 year, 5 days), or all of them with $full: years, months, weeks, days, hours, minutes and seconds. A difference of nothing is just now.

The catalogues

The names and phrases are in the translation domain date. The English text of each message is its id, and the catalogue of a language translates it:

// resources/translations/date+intl-icu.es.php
return [
    'Monday' => 'Lunes',
    'January' => 'Enero',
    '{weekday}, {month} {day}, {year}' => '{weekday}, {day} de {month} del {year}',
    '{month} {year}' => '{month} de {year}',
    '{count, plural, one {# day} other {# days}}' => '{count, plural, one {# día} other {# días}}',
    '{parts} ago' => 'hace {parts}',
    'just now' => 'recién',
];

The Spanish catalogue ships with the package. The order of the words, the plurals and the names are all in the catalogue, so another language is one more file (date+intl-icu.fr.php) and no code. The catalogue of a language must have every id of the domain date.

To have the catalogue in your translator, import the services of the package (see Errors and Translations).