get_the_time() - WordPress 函数参考中文文档

返回介绍

get_the_time()

发布于 2017-09-11 字数4051 浏览 840 评论 0

get_the_time( string $d = '',  int|WP_Post $post = null )

Retrieve the time at which the post was written.


描述


参数

$d

(string)
(Optional)
Format to use for retrieving the time the post was written. Either ‘G’, ‘U’, or php date format defaults to the value specified in the time_format option.

Default value: ”

$post

(int|WP_Post)
(Optional)
WP_Post object or ID. Default is global $post object.

Default value: null


返回值

(string|int|false) Formatted date string or Unix timestamp if $id is ‘U’ or ‘G’. False on failure.


源代码

File: wp-includes/general-template.php

function get_the_time( $d = '', $post = null ) {
	$post = get_post($post);

	if ( ! $post ) {
		return false;
	}

	if ( '' == $d )
		$the_time = get_post_time(get_option('time_format'), false, $post, true);
	else
		$the_time = get_post_time($d, false, $post, true);

	/**
	 * Filters the time a post was written.
	 *
	 * @since 1.5.0
	 *
	 * @param string      $the_time The formatted time.
	 * @param string      $d        Format to use for retrieving the time the post was written.
	 *                              Accepts 'G', 'U', or php date format value specified
	 *                              in 'time_format' option. Default empty.
	 * @param int|WP_Post $post     WP_Post object or ID.
	 */
	return apply_filters( 'get_the_time', $the_time, $d, $post );
}

更新日志

Version 描述
1.5.0 Introduced.

相关函数

Uses

  • wp-includes/general-template.php:
    get_post_time()
  • wp-includes/general-template.php:
    get_the_time
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/option.php:
    get_option()
  • wp-includes/post.php:
    get_post()

Used By

  • wp-admin/includes/class-wp-posts-list-table.php:
    WP_Posts_List_Table::column_date()
  • wp-admin/includes/dashboard.php:
    wp_dashboard_recent_posts()
  • wp-admin/includes/dashboard.php:
    wp_dashboard_recent_drafts()
  • wp-includes/general-template.php:
    the_time()

User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Basic Example

    Returns the time of the current post using the WordPress default format, and displays it using the PHP echo command.

    
    <?php echo get_the_time(); ?>
    

    Returns the time of the post with ID $post->ID in the WordPress default format.

    
    <?php echo get_the_time( '', $post->ID ); ?>
    
  2. Getting Unix Timestamp

    Assigns the local time of the current post in seconds (since January 1 1970, known as the Unix Epoch) to the variable $u_time.

    
    <?php $local_timestamp = get_the_time( 'U' ); ?>
    

    In most cases, you would probably want the epoch time for GMT (rather than for the local time zone), which you can get with the get_post_time() function, setting the $gmt option to true:

    
    <?php $gmt_timestamp = get_post_time( 'U', true ); ?>
    

上一篇:get_the_term_list()

下一篇:get_the_title()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!