wp_checkdate() │ WP 3.5.0

Проверяет корректность даты по григорианскому календарю.

Эта обёртка для PHP функции checkdate().

1 раз — 0.00002 сек (очень быстро) | 50000 раз — 0.10 сек (скорость света)

Хуки из функции

wp_checkdate

Возвращает

true|false. Логический. true если дата является валидной, false в противном случае.

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

if( wp_checkdate( $month, $day, $year, $source_date ) ){
	// проверка пройдена, делаем что-нибудь
}

$month(число) (обязательный): Номер месяца (1-12).
$day(число) (обязательный): Номер дня (1-31).
$year(число) (обязательный): Год.
$source_date(строка) (обязательный): Исходная дата в которой проверяются указанные ранее год/месяц/день. Указывается для передачи в фильтр. Например 2008-10-24

Примеры

#1 Пример из ядра WordPress

/*
 * Если дата не установлена ( новый пост или черновик )
 * если не черновик или дата изменилась в процессе написания.
 */
if ( empty( $postarr['post_date'] ) || '0000-00-00 00:00:00' == $postarr['post_date'] ) {
	$post_date = current_time( 'mysql' );
}
else {
	$post_date = $postarr['post_date'];
}

// Валидация даты.
$mm = substr( $post_date, 5, 2 );
$jj = substr( $post_date, 8, 2 );
$aa = substr( $post_date, 0, 4 );
$valid_date = wp_checkdate( $mm, $jj, $aa, $post_date );

if ( ! $valid_date ) {
	if ( $wp_error ) {
		//Указанная дата некорректна.
		return new WP_Error( 'invalid_date', __( 'Whoops, the provided date is invalid.' ) );
	}
	else {
		return 0;
	}
}

#2 Еще одни пример из ядра WordPress

if ( get_query_var( 'day' ) && get_query_var( 'monthnum' ) && get_query_var( 'year' ) ) {
	$year  = get_query_var( 'year' );
	$month = get_query_var( 'monthnum' );
	$day   = get_query_var( 'day' );
	$date  = sprintf( '%04d-%02d-%02d', $year, $month, $day );
	if ( ! wp_checkdate( $month, $day, $year, $date ) ) {
		$redirect_url = get_month_link( $year, $month );
	}
}

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

С версии 3.5.0

Введена.

Код `wp_checkdate() wp checkdate` ^{WP 7.0}

wp-includes/functions.php

function wp_checkdate( $month, $day, $year, $source_date ) {
	$checkdate = false;
	if ( is_numeric( $month ) && is_numeric( $day ) && is_numeric( $year ) ) {
		$checkdate = checkdate( (int) $month, (int) $day, (int) $year );
	}

	/**
	 * Filters whether the given date is valid for the Gregorian calendar.
	 *
	 * @since 3.5.0
	 *
	 * @param bool   $checkdate   Whether the given date is valid.
	 * @param string $source_date Date to check.
	 */
	return apply_filters( 'wp_checkdate', $checkdate, $source_date );
}