CoreFiles by mySites.guru
Date.php86 lines, 2,435 bytes, from Joomla_4.2.0-Stable-Full_Package.zip
Raw History Compare with 4.1.5
md5
a914540a86241f35de3a892ab1420700
sha1
c459d9daf6e336b9a38c0264286aaab00d3f7cc4
sha256
2e0f85488442b7bc66e6f66fa930ad5f9e295b3e03ac77d8897421bd07c9ac21
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2011 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\HTML\Helpers;

use Joomla\CMS\Date\Date as DateHelper;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;

/**
 * Extended Utility class for handling date display.
 *
 * @since  2.5
 */
abstract class Date
{
    /**
     * Function to convert a static time into a relative measurement
     *
     * @param   string  $date    The date to convert
     * @param   string  $unit    The optional unit of measurement to return
     *                           if the value of the diff is greater than one
     * @param   string  $time    An optional time to compare to, defaults to now
     * @param   string  $format  An optional format for the HTMLHelper::date output
     *
     * @return  string  The converted time string
     *
     * @since   2.5
     */
    public static function relative($date, $unit = null, $time = null, $format = null)
    {
        if ($time === null) {
            // Get now
            $time = new DateHelper('now');
        }

        // Get the difference in seconds between now and the time
        $diff = strtotime($time) - strtotime($date);

        // Less than a minute
        if ($diff < 60) {
            return Text::_('JLIB_HTML_DATE_RELATIVE_LESSTHANAMINUTE');
        }

        // Round to minutes
        $diff = round($diff / 60);

        // 1 to 59 minutes
        if ($diff < 60 || $unit === 'minute') {
            return Text::plural('JLIB_HTML_DATE_RELATIVE_MINUTES', $diff);
        }

        // Round to hours
        $diff = round($diff / 60);

        // 1 to 23 hours
        if ($diff < 24 || $unit === 'hour') {
            return Text::plural('JLIB_HTML_DATE_RELATIVE_HOURS', $diff);
        }

        // Round to days
        $diff = round($diff / 24);

        // 1 to 6 days
        if ($diff < 7 || $unit === 'day') {
            return Text::plural('JLIB_HTML_DATE_RELATIVE_DAYS', $diff);
        }

        // Round to weeks
        $diff = round($diff / 7);

        // 1 to 4 weeks
        if ($diff <= 4 || $unit === 'week') {
            return Text::plural('JLIB_HTML_DATE_RELATIVE_WEEKS', $diff);
        }

        // Over a month, return the absolute time
        return HTMLHelper::_('date', $date, $format);
    }
}

The same content is in 5 releases, Joomla 4.2.0-beta3 to 4.2.1-rc2. See them all, or every version of this file.