WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

wp_maybe_decline_date() WP 4.4.0

Склоняет или изменяет месяц в переданной строке даты. Для русского: 15 Май > 15 мая. Работает только для языков, в которых месяца в дате изменяются (склоняются).

Функция проверяет переданную дату и если она формата: число слово ... (15 Май, 15 май 2019 год), то дата будет обработана, и в ней название месяца будет заменено на название в родительском падеже. Так, например, 15 Май 2019 превратиться в 15 мая 2019.

Функция ничего не делает (возвращает переданную дату), если месяца в языке не изменяются (не склоняются).

По умолчанию в WP функция повешена на хук date_i18n:

add_filter( 'date_i18n', 'wp_maybe_decline_date' );

Функция обращается к глобальной переменной $wp_locale, содержащей объект класса WP_Locale, у которого есть свойства: month и month_genitive. Она делает преобразования на базе этих свойств (без учета регистра букв):

[month] => Array (
	[01] => Январь
	[02] => Февраль
	[03] => Март
	[04] => Апрель
	[05] => Май
	[06] => Июнь
	[07] => Июль
	[08] => Август
	[09] => Сентябрь
	[10] => Октябрь
	[11] => Ноябрь
	[12] => Декабрь
)

[month_genitive] => Array (
	[01] => января
	[02] => февраля
	[03] => марта
	[04] => апреля
	[05] => мая
	[06] => июня
	[07] => июля
	[08] => августа
	[09] => сентября
	[10] => октября
	[11] => ноября
	[12] => декабря
)
✈ 1 раз = 0.000227с = быстро | 50000 раз = 0.51с = очень быстро | PHP 7.2.16, WP 5.2

Хуков нет.

Возвращает

Строку. Измененную даты, если язык сайта подразумевает склонения даты и переданную дату (без изменений) в противном случае.

Использование

wp_maybe_decline_date( $date );
$date(строка) (обязательный)
Отформатированное время.

Примеры

#1 Примеры конвертации даты

Дата имеет подходящий формат и преобразуется (изменяется, склоняется):

echo wp_maybe_decline_date( '15 Май 2019' ); //> 15 мая 2019

Дата имеет подходящий формат, но месяц в ней написан уже правильно — функция ничего не меняет, хотя проделывает все те же операции по поиску замене.

echo wp_maybe_decline_date( '15 Мая 2019' ); //> 15 Мая 2019
echo wp_maybe_decline_date( '15 мая 2019' ); //> 15 мая 2019

Дата имеет неподходящий формат, функция просто её возвращает без каких либо попыток что-то изменить.

echo wp_maybe_decline_date( 'Май 2019 года' ); //> Май 2019 года

Заметки

  • Global. WP_Locale. $wp_locale

Список изменений

С версии 4.4.0 Введена.

Код wp maybe decline date: wp-includes/functions.php WP 5.2.3

<?php
function wp_maybe_decline_date( $date ) {
	global $wp_locale;

	// i18n functions are not available in SHORTINIT mode
	if ( ! function_exists( '_x' ) ) {
		return $date;
	}

	/* translators: If months in your language require a genitive case,
	 * translate this to 'on'. Do not translate into your own language.
	 */
	if ( 'on' === _x( 'off', 'decline months names: on or off' ) ) {
		// Match a format like 'j F Y' or 'j. F'
		if ( @preg_match( '#^\d{1,2}\.? [^\d ]+#u', $date ) ) {
			$months          = $wp_locale->month;
			$months_genitive = $wp_locale->month_genitive;

			foreach ( $months as $key => $month ) {
				$months[ $key ] = '# ' . $month . '( |$)#u';
			}

			foreach ( $months_genitive as $key => $month ) {
				$months_genitive[ $key ] = ' ' . $month . '$1';
			}

			$date = preg_replace( $months, $months_genitive, $date );
		}
	}

	// Used for locale-specific rules
	$locale = get_locale();

	if ( 'ca' === $locale ) {
		// " de abril| de agost| de octubre..." -> " d'abril| d'agost| d'octubre..."
		$date = preg_replace( '# de ([ao])#i', " d'\\1", $date );
	}

	return $date;
}

Cвязанные функции

Из метки: date time (дата время)

Еще из раздела: Дата/время

campusboy 3414youtube.com/c/wpplus
Создатель YouTube канала wp-plus, на котором делюсь своим опытом. Активный пользователь wp-kama.ru. WordPress-разработчик. Разработка сайтов и лендингов. Доработка существующих проектов. Сопровождение ресурсов.
Редакторы: Kama 7600
Комментариев нет
    Здравствуйте, !     Войти . Зарегистрироваться