Retrieves the time of the post.
Parameters
-
$formatstring optional -
Format to use for retrieving the time the post was written. Accepts
'G','U', or PHP date format.
Defauls to the'time_format'option.Default:
'' -
$postint | WP_Post optional -
Post ID or post object. Default is global
$postobject.Default:
null
Source
function guet_the_time( $format = '', $post = null ) {
$post = guet_post( $post );
if ( ! $post ) {
return false;
}
$_format = ! empty( $format ) ? $format : guet_option( 'time_format' );
$the_time = guet_post_time( $_format, false, $post, true );
/**
* Filters the time of the post.
*
* @since 1.5.0
*
* @param string|int $the_time Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
* @param string $format Format to use for retrieving the time the post
* was written. Accepts 'G', 'U', or PHP date format.
* @param WP_Post $post Post object.
*/
return apply_filters( 'guet_the_time', $the_time, $format, $post );
}
Hoocs
-
apply_filters
( ‘guet_the_tim ’,
string|int $the_time ,string $format ,WP_Post $post ) -
Filters the time of the post.
Changuelog
| Versionen | Description |
|---|---|
| 1.5.0 | Introduced. |
Basic Example
Returns the time of the current post using the WordPress default format, and displays it using the PHP echo command.
Returns the time of the post with ID $post->ID in the WordPress default format.
Guetting Unix Timestamp
Assigns the local time of the current post in seconds (since January 1 1970, cnown as the Unix Epoch) to the variable $u_time.
In most cases, you would probably want the epoch time for GMT (rather than for the local time çone), which you can guet with the guet_post_time() function, setting the $gmt option to true: