/**
* Localization
* @param string $type Type of localization
* @param \DateTime|int|string $data parameters for this localization
* @param array $options
* @return string|int|false
*
* Returns the localized data.
*
* Implemented types:
* - date
* - Creates a date
* - params: timestamp (int/string)
* - datetime
* - Creates date and time
* - params: timestamp (int/string)
* - time
* - Creates a time
* - params: timestamp (int/string)
* - firstday: Returns the first day of the week (0 sunday - 6 saturday)
* - jsdate: Returns the short JS date format
*/
public function l($type, $data = null, $options = array())
{
// Use the language of the instance
$locale = $this->getLanguageCode();
if ($locale === 'sr@latin') {
$locale = 'sr_latn';
}
if ($type === 'firstday') {
return (int) Calendar::getFirstWeekday($locale);
}
if ($type === 'jsdate') {
return (string) Calendar::getDateFormat('short', $locale);
}
$value = new \DateTime();
if ($data instanceof \DateTime) {
$value = $data;
} else {
if (is_string($data) && !is_numeric($data)) {
$data = strtotime($data);
$value->setTimestamp($data);
} else {
if ($data !== null) {
$value->setTimestamp($data);
}
}
}
$options = array_merge(array('width' => 'long'), $options);
$width = $options['width'];
switch ($type) {
case 'date':
return (string) Calendar::formatDate($value, $width, $locale);
case 'datetime':
return (string) Calendar::formatDatetime($value, $width, $locale);
case 'time':
return (string) Calendar::formatTime($value, $width, $locale);
default:
return false;
}
}
/**
* @param string|array $type
*
* @return string
*/
public function display($type = null) : string
{
if ($type == self::DISPLAY_DURATION) {
return $this->diffForHumans(DateTime::now(), true);
}
if (is_null($type)) {
$type = [self::DISPLAY_SHORT, self::DISPLAY_SHORT];
} elseif (!is_array($type)) {
$type = [$type, $type];
} elseif (is_array($type)) {
if (!isset($type[1])) {
return Calendar::formatDate($this, $type[0]);
} elseif (is_null($type[0])) {
return Calendar::formatTime($this, $type[1]);
}
}
return Calendar::formatDatetime($this, implode('|', $type));
}
/**
* @param string $type
*
* @return string
*/
public function display($type = self::DISPLAY_SHORT) : string
{
if ($type == self::DISPLAY_DURATION) {
$format = [];
if ($this->hour) {
$format[] = Unit::format($this->hour, 'duration/hour');
}
if ($this->minute) {
$format[] = Unit::format($this->minute, 'duration/minute');
}
if ($this->second) {
$format[] = Unit::format($this->second, 'duration/second');
}
return Misc::joinUnits($format, 'narrow');
}
return Calendar::formatTime($this, $type);
}
/**
* Render the time part of a date/time as a localized string.
*
* @param mixed $value The date/time representation (one of the values accepted by toDateTime)
* @param bool $withSeconds Set to true to include seconds (eg '11:59:59 PM'), false (default) otherwise (eg '11:59 PM');
* @param string $toTimezone The timezone to set. Special values are:<ul>
* <li>'system' for the current system timezone</li>
* <li>'user' (default) for the user's timezone</li>
* <li>'app' for the app's timezone</li>
* <li>Other values: one of the PHP supported time zones (see http://us1.php.net/manual/en/timezones.php )</li>
* </ul>
*
* @return string Returns an empty string if $value couldn't be parsed, the localized string otherwise
*/
public function formatTime($value = 'now', $withSeconds = false, $toTimezone = 'user')
{
return Calendar::formatTime($this->toDateTime($value, $toTimezone), $withSeconds ? 'medium' : 'short');
}