wp_resolve_post_date() WordPress Function
The wp_resolve_post_date() function is used to resolve a post date for a given post. It is used internally by the Wordpress core to generate the correct post date when a post is published.
wp_resolve_post_date( string $post_date = '', string $post_date_gmt = '' ) #
Uses wp_checkdate to return a valid Gregorian-calendar value for post_date.
Description
If post_date is not provided, this first checks post_date_gmt if provided, then falls back to use the current time.
For back-compat purposes in wp_insert_post, an empty post_date and an invalid post_date_gmt will continue to return ‘1970-01-01 00:00:00’ rather than false.
Parameters
- $post_date
(string)(Optional)The date in mysql format.
Default value: ''
- $post_date_gmt
(string)(Optional)The GMT date in mysql format.
Default value: ''
Return
(string|false) A valid Gregorian-calendar date string, or false on failure.
Source
File: wp-includes/post.php
function wp_resolve_post_date( $post_date = '', $post_date_gmt = '' ) {
// If the date is empty, set the date to now.
if ( empty( $post_date ) || '0000-00-00 00:00:00' === $post_date ) {
if ( empty( $post_date_gmt ) || '0000-00-00 00:00:00' === $post_date_gmt ) {
$post_date = current_time( 'mysql' );
} else {
$post_date = get_date_from_gmt( $post_date_gmt );
}
}
// Validate the date.
$month = substr( $post_date, 5, 2 );
$day = substr( $post_date, 8, 2 );
$year = substr( $post_date, 0, 4 );
$valid_date = wp_checkdate( $month, $day, $year, $post_date );
if ( ! $valid_date ) {
return false;
}
return $post_date;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 5.7.0 | Introduced. |