MODX. Даты и их форматирование в MODX

Отредактировано: 24 Февраля 2025

В стандартных ресурсах MODX предусмотрены следующие плейсхолдеры с датами:

• createdon — дата создания;
• deletedon — дата удаления;
• editedon — дата последнего редактирования;
• publishedon — дата когда ресурс был опубликован;
• pub_date — дата когда ресурс должен появиться в публикации;
• unpub_date — дата снятия с публикации.

Выведем дату редактирования текущего ресурса в формате день, месяц прописью, год:

[[*editedon:date=`%d %b %Y`]] 

Если возникла проблема с выводом русского языка, в начале шаблона, или в системных параметрах попробуйте добавить локаль (подробнее о локалях):

<?php
setlocale(LC_TIME, "ru_RU.UTF8");

 Если возникла проблема с правильностью отображения даты, попробуйте преобразовать с помощью модификатора :strtotime

[[*editedon:strtotime:date=`%d %b %Y`]] 

Формат вывода даты задается с использованием функции strftime. 

strftime — форматирует текущую дату / время с учетом текущих настроек локали.

Параметры функции strftime

Для вывода текущей даты без использования сторонних сниппетов можно использовать этот код:

// только год
[[!+nowdate:default=`now`:strtotime:date=`%Y`]]

// дата в формате: 01 января 2025
[[!+nowdate:default=`now`:strtotime:date=`%d %B %Y`]]

Текущая дата при помощи fenom:

получение и вывод текущего timestamp
{set $time = time()}
{$time}

// форматировать можно при помощи модификаторов date или date_format
{$time|date:"Y.m.d"} // гггг.мм.дд
{$time|date_format:"%Y/%m/%d %H:%M:%S"} // гггг/мм/дд чч:мм:сс

// пример арифметических функций с датами
{$time|date_format:"-1 day"} 

// либо при помощи форматирования даты через date
// год
{'' | date : 'Y'}

// дата полностью
{'2025-01-01 00:00' | date : 'd.m.Y'} // 01.01.2025

Арифметика с датами (можно использовать любые числа):

// дата завтра
{'+1 days' | date : 'Y-m-d'}

// дата вчера
{'-1 days' | date : 'Y-m-d'}

Если необходимо вывести месяц на русском полностью, можно поменять локаль в настройках контекста:

• Системные настройки (шестерёнка) → пункт контексты (contexts);
• Нажимаете на «редактировать» в нужном контексте;
• Добавляем новый пункт «locale» (или редактируем если уже есть) в значении указываем: ru_RU.UTF-8.

Если необходимо вывести месяц в формате не доступном на сервере, можно использовать подобный сниппет для преобразования, к примеру назовём dateRU:

<?php
$month_arr = array(
        '01' => 'Января',
        '02' => 'Февраля',
        '03' => 'Марта',
        '04' => 'Апреля',
        '05' => 'Мая',
        '06' => 'Июня',
        '07' => 'Июля',
        '08' => 'Августа',
        '09' => 'Сентября',
        '10' => 'Октября',
        '11' => 'Ноября',
        '12' => 'Декабря'
    );
  
$time = strtotime($input);
$month = strftime('%m', $time);
$day = strftime('%d', $time);
$year = strftime('%Y', $time);
    
return "$day $month_arr[$month] $year";

 Вызов сниппета:

[[*editedon:dateRU]] 

 Условное выражение с использованием тегов MODX:

[[*publishedon:notempty=`
    [[*publishedon:date=`%D`:ge=`[[!*editedon:date=`%D`]]`:then=`
        Опубликовано: [[*publishedon:strtotime:dateRU]]`:else=`
        Отредактировано: [[*editedon:strtotime:dateRU]]`]]
`]]

Тоже самое но в сниппете:

function dateRu($input){
    $month_arr = array(
        '01' => 'Января',
        '02' => 'Февраля',
        '03' => 'Марта',
        '04' => 'Апреля',
        '05' => 'Мая',
        '06' => 'Июня',
        '07' => 'Июля',
        '08' => 'Августа',
        '09' => 'Сентября',
        '10' => 'Октября',
        '11' => 'Ноября',
        '12' => 'Декабря'
    );
    
    $month = strftime("%m",$input);
    $year = strftime("%Y",$input);
    $day = strftime("%d",$input);
    $month = $month_arr[$month];
    
    return "$day $month $year";
}

$publishedon = dateRu($modx->resource->get('publishedon','%s'));
$editedon = dateRu($modx->resource->get('editedon', '%s'));

if ($publishedon) {
    $out = '';
    if ($publishedon == $editedon){
        $out = 'Опубликовано: '.$publishedon;
    }else{
        $out = 'Отредактировано: '.$editedon;
    }
    return $out;
}

Для установки даты через xPDO или для TV полей с типом data можно использовать следующие сущности:

• today — будет установлена сегодняшняя дата.
• now — текущая дата и время.
• yesterday — вчера.
• tomorrow — завтра.
• + / - (любое число)h — почему-то в перепутанном порядке, +24h высчитывается как (сегодня - 24 часа), и наоборот со знаком минус.