Date - date and time

App\Helpers\Date - conversion between SQL strings and Unix timestamp. Localized output is delegated to Locales, old calls to Date::humanDate() and Date::datePhrase() retained for compatibility.

use App\Helpers\Date;

Current time

`nowSql()` - current time in SQL format `Y-m-d H:i:s`

$row['created_at'] = Date::nowSql();   // '2026-07-14 12:30:00'

`nowTimestamp()` — current Unix-timestamp (`time()`).

Input from forms → DB

###htmlDateTimeToSql($value) Value from <input type="datetime-local"> (2026-07-14T12:30) → SQL string. Empty value → null. Seconds are padded with zeros.

Date::htmlDateTimeToSql('2026-07-14T12:30');   // '2026-07-14 12:30:00'
Date::htmlDateTimeToSql('');                    // null

Conversions timestamp ↔ string

Method	Direction
`formatTimestamp($ts, $format = 'Y-m-d H:i:s')`	timestamp → format string
`timestampToDate($ts)` / `timestampToTime($ts)`	timestamp → date/time
`dateToTimestamp($date)` / `datetime2timestamp($s)`	string → timestamp
`sqlDateToTimestamp($d)` / `sqlTimeToTimestamp($dt)`	SQL string → timestamp
`_make_timestamp($string)`	arbitrary string → timestamp

Date::formatTimestamp($row['published'], 'd.m.Y H:i');   // '14.07.2026 12:30'
$ts = Date::sqlDateToTimestamp('2026-07-14');

Human readable view

###humanDate($date) Takes timestamp and returns "N units back" with the correct declination.

Date::humanDate(time() - 3600);        // '1 час назад'
Date::humanDate(time() - 5 * 86400);   // '5 дней назад'

###datePhrase($number, $titles) Only the correct word form (without number) according to Russian rules. $titles — [1, 2-4, 5-0].

Date::datePhrase(3, ['день', 'дня', 'дней']);   // 'дня'
echo $n . ' ' . Date::datePhrase($n, ['минута','минуты','минут']);

Recipes

Save publication date from form:

$data['document_published'] = Date::htmlDateTimeToSql($_POST['published']);

Show “modified N ago” in the list:

echo 'изменено ' . Date::humanDate($doc['document_changed']);

For localized display of months/days (“July 14, 2026”), see Locales: prettyDate(), translateDate().

2.3 KiB Raw Blame History