wp_checkdate()
Проверяет корректность даты по григорианскому календарю.
Эта обёртка для PHP функции checkdate().
1 раз — 0.00002 сек (очень быстро) | 50000 раз — 0.10 сек (скорость света)
Хуки из функции
Возвращает
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 6.4.3
function wp_checkdate( $month, $day, $year, $source_date ) { /** * 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( $month, $day, $year ), $source_date ); }