/var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/cakephp/src/View/Helper
Edit: /var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/cakephp/src/View/Helper/TimeHelper.php (15497B)
*/
protected $_defaultConfig = [
'outputTimezone' => null,
];
/**
* Get a timezone.
*
* Will use the provided timezone, or default output timezone if defined.
*
* @param \DateTimeZone|string|null $timezone The override timezone if applicable.
* @return \DateTimeZone|string|null The chosen timezone or null.
*/
protected function _getTimezone($timezone)
{
if ($timezone) {
return $timezone;
}
return $this->getConfig('outputTimezone');
}
/**
* Returns a UNIX timestamp, given either a UNIX timestamp or a valid strtotime() date string.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return \Cake\I18n\FrozenTime
*/
public function fromString($dateString, $timezone = null): FrozenTime
{
$time = new FrozenTime($dateString);
if ($timezone !== null) {
$time = $time->setTimezone($timezone);
}
return $time;
}
/**
* Returns a nicely formatted date string for given Datetime string.
*
* @param \DateTimeInterface|string|int|null $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @param string|null $locale Locale string.
* @return string Formatted date string
*/
public function nice($dateString = null, $timezone = null, ?string $locale = null): string
{
$timezone = $this->_getTimezone($timezone);
return (new FrozenTime($dateString))->nice($timezone, $locale);
}
/**
* Returns true, if the given datetime string is today.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if the given datetime string is today.
*/
public function isToday($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isToday();
}
/**
* Returns true, if the given datetime string is in the future.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if the given datetime string lies in the future.
*/
public function isFuture($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isFuture();
}
/**
* Returns true, if the given datetime string is in the past.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if the given datetime string lies in the past.
*/
public function isPast($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isPast();
}
/**
* Returns true if given datetime string is within this week.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if datetime string is within current week
*/
public function isThisWeek($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isThisWeek();
}
/**
* Returns true if given datetime string is within this month
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if datetime string is within the current month
*/
public function isThisMonth($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isThisMonth();
}
/**
* Returns true if given datetime string is within the current year.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if datetime string is within current year
*/
public function isThisYear($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isThisYear();
}
/**
* Returns true if given datetime string was yesterday.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if datetime string was yesterday
*/
public function wasYesterday($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isYesterday();
}
/**
* Returns true if given datetime string is tomorrow.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool True if datetime string was yesterday
*/
public function isTomorrow($dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isTomorrow();
}
/**
* Returns the quarter
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param bool $range if true returns a range in Y-m-d format
* @return array
|int 1, 2, 3, or 4 quarter of year or array if $range true
* @see \Cake\I18n\Time::toQuarter()
*/
public function toQuarter($dateString, $range = false)
{
return (new FrozenTime($dateString))->toQuarter($range);
}
/**
* Returns a UNIX timestamp from a textual datetime description.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return string UNIX timestamp
* @see \Cake\I18n\Time::toUnix()
*/
public function toUnix($dateString, $timezone = null): string
{
return (new FrozenTime($dateString, $timezone))->toUnixString();
}
/**
* Returns a date formatted for Atom RSS feeds.
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return string Formatted date string
* @see \Cake\I18n\Time::toAtom()
*/
public function toAtom($dateString, $timezone = null): string
{
$timezone = $this->_getTimezone($timezone) ?: date_default_timezone_get();
return (new FrozenTime($dateString))->setTimeZone($timezone)->toAtomString();
}
/**
* Formats date for RSS feeds
*
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return string Formatted date string
*/
public function toRss($dateString, $timezone = null): string
{
$timezone = $this->_getTimezone($timezone) ?: date_default_timezone_get();
return (new FrozenTime($dateString))->setTimeZone($timezone)->toRssString();
}
/**
* Formats a date into a phrase expressing the relative time.
*
* ### Additional options
*
* - `element` - The element to wrap the formatted time in.
* Has a few additional options:
* - `tag` - The tag to use, defaults to 'span'.
* - `class` - The class name to use, defaults to `time-ago-in-words`.
* - `title` - Defaults to the $dateTime input.
*
* @param \DateTimeInterface|string|int $dateTime UNIX timestamp, strtotime() valid
* string or DateTime object.
* @param array $options Default format if timestamp is used in $dateString
* @return string Relative time string.
* @see \Cake\I18n\Time::timeAgoInWords()
*/
public function timeAgoInWords($dateTime, array $options = []): string
{
$element = null;
$options += [
'element' => null,
'timezone' => null,
];
$options['timezone'] = $this->_getTimezone($options['timezone']);
/** @psalm-suppress UndefinedInterfaceMethod */
if ($options['timezone'] && $dateTime instanceof DateTimeInterface) {
$dateTime = $dateTime->setTimezone($options['timezone']);
unset($options['timezone']);
}
if (!empty($options['element'])) {
$element = [
'tag' => 'span',
'class' => 'time-ago-in-words',
'title' => $dateTime,
];
if (is_array($options['element'])) {
$element = $options['element'] + $element;
} else {
$element['tag'] = $options['element'];
}
unset($options['element']);
}
$relativeDate = (new FrozenTime($dateTime))->timeAgoInWords($options);
if ($element) {
$relativeDate = sprintf(
'<%s%s>%s',
$element['tag'],
$this->templater()->formatAttributes($element, ['tag']),
$relativeDate,
$element['tag']
);
}
return $relativeDate;
}
/**
* Returns true if specified datetime was within the interval specified, else false.
*
* @param string $timeInterval the numeric value with space then time type.
* Example of valid types: 6 hours, 2 days, 1 minute.
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool
* @see \Cake\I18n\Time::wasWithinLast()
*/
public function wasWithinLast(string $timeInterval, $dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->wasWithinLast($timeInterval);
}
/**
* Returns true if specified datetime is within the interval specified, else false.
*
* @param string $timeInterval the numeric value with space then time type.
* Example of valid types: 6 hours, 2 days, 1 minute.
* @param \DateTimeInterface|string|int $dateString UNIX timestamp, strtotime() valid string or DateTime object
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return bool
* @see \Cake\I18n\Time::wasWithinLast()
*/
public function isWithinNext(string $timeInterval, $dateString, $timezone = null): bool
{
return (new FrozenTime($dateString, $timezone))->isWithinNext($timeInterval);
}
/**
* Returns gmt as a UNIX timestamp.
*
* @param \DateTimeInterface|string|int|null $string UNIX timestamp, strtotime() valid string or DateTime object
* @return string UNIX timestamp
* @see \Cake\I18n\Time::gmt()
*/
public function gmt($string = null): string
{
return (new FrozenTime($string))->toUnixString();
}
/**
* Returns a formatted date string, given either a Time instance,
* UNIX timestamp or a valid strtotime() date string.
*
* This method is an alias for TimeHelper::i18nFormat().
*
* @param \DateTimeInterface|string|int|null $date UNIX timestamp, strtotime() valid string
* or DateTime object (or a date format string).
* @param string|int|null $format date format string (or a UNIX timestamp,
* `strtotime()` valid string or DateTime object).
* @param string|false $invalid Default value to display on invalid dates
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return string|int|false Formatted and translated date string
* @see \Cake\I18n\Time::i18nFormat()
*/
public function format($date, $format = null, $invalid = false, $timezone = null)
{
return $this->i18nFormat($date, $format, $invalid, $timezone);
}
/**
* Returns a formatted date string, given either a Datetime instance,
* UNIX timestamp or a valid strtotime() date string.
*
* @param \DateTimeInterface|string|int|null $date UNIX timestamp, strtotime() valid string or DateTime object
* @param string|int|null $format Intl compatible format string.
* @param string|false $invalid Default value to display on invalid dates
* @param \DateTimeZone|string|null $timezone User's timezone string or DateTimeZone object
* @return string|int|false Formatted and translated date string or value for `$invalid` on failure.
* @throws \Exception When the date cannot be parsed
* @see \Cake\I18n\Time::i18nFormat()
*/
public function i18nFormat($date, $format = null, $invalid = false, $timezone = null)
{
if ($date === null) {
return $invalid;
}
$timezone = $this->_getTimezone($timezone);
try {
$time = new FrozenTime($date);
return $time->i18nFormat($format, $timezone);
} catch (Exception $e) {
if ($invalid === false) {
throw $e;
}
return $invalid;
}
}
/**
* Event listeners.
*
* @return array
*/
public function implementedEvents(): array
{
return [];
}
}