On this page
get_the_time( string $format = '', int|WP_Post $post = null ): string|int|false
Retrieves the time at which the post was written.
Parameters
$formatstring Optional-
Format to use for retrieving the time the post was written. Accepts
'G','U', or PHP date format.
Defaults to the'time_format'option.Default:
'' $postint|WP_Post Optional-
Post ID or post object. Default is global
$postobject.Default:
null
Return
string|int|false Formatted date string or Unix timestamp if $format is 'U' or 'G'.
False on failure.
Source
File: wp-includes/general-template.php. View all references
function get_the_time( $format = '', $post = null ) {
$post = get_post( $post );
if ( ! $post ) {
return false;
}
$_format = ! empty( $format ) ? $format : get_option( 'time_format' );
$the_time = get_post_time( $_format, false, $post, true );
/**
* Filters the time a post was written.
*
* @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( 'get_the_time', $the_time, $format, $post );
}
Hooks
- apply_filters( 'get_the_time',
string|int $the_time ,string $format ,WP_Post $post ) -
Filters the time a post was written.
Related
Uses
| Uses | Description |
|---|---|
| get_post_time() wp-includes/general-template.php | Retrieves the time at which the post was written. |
| apply_filters() wp-includes/plugin.php | Calls the callback functions that have been added to a filter hook. |
| get_option() wp-includes/option.php | Retrieves an option value based on an option name. |
| get_post() wp-includes/post.php | Retrieves post data given a post ID or post object. |
Used By
| Used By | Description |
|---|---|
| WP_Customize_Manager::customize_pane_settings() wp-includes/class-wp-customize-manager.php | Prints JavaScript settings for parent window. |
| WP_Posts_List_Table::column_date() wp-admin/includes/class-wp-posts-list-table.php | Handles the post date column output. |
| WP_Media_List_Table::column_date() wp-admin/includes/class-wp-media-list-table.php | Handles the date column output. |
| wp_dashboard_recent_posts() wp-admin/includes/dashboard.php | Generates Publishing Soon and Recently Published sections. |
| wp_dashboard_recent_drafts() wp-admin/includes/dashboard.php | Show recent drafts of the user on the dashboard. |
| the_time() wp-includes/general-template.php | Displays the time at which the post was written. |
Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_the_time