get_date_from_gmt

The timeline below displays how wordpress function get_date_from_gmt has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.2

/**
 * Given a date in UTC or GMT timezone, returns that date in the timezone of the site.
 *
 * Requires a date in the Y-m-d H:i:s format.
 * Default return format of 'Y-m-d H:i:s' can be overridden using the `$format` parameter.
 *
 * @since 1.2.0
 *
 * @param string $date_string The date to be converted, in UTC or GMT timezone.
 * @param string $format      The format string for the returned date. Default 'Y-m-d H:i:s'.
 * @return string Formatted version of the date, in the site's timezone.
 */
function get_date_from_gmt($date_string, $format = 'Y-m-d H:i:s')
{
    $datetime = date_create($date_string, new DateTimeZone('UTC'));
    if (false === $datetime) {
        return gmdate($format, 0);
    }
    return $datetime->setTimezone(wp_timezone())->format($format);
}

WordPress Version: 5.9

/**
 * Given a date in UTC or GMT timezone, returns that date in the timezone of the site.
 *
 * Requires a date in the Y-m-d H:i:s format.
 * Default return format of 'Y-m-d H:i:s' can be overridden using the `$format` parameter.
 *
 * @since 1.2.0
 *
 * @param string $string The date to be converted, in UTC or GMT timezone.
 * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
 * @return string Formatted version of the date, in the site's timezone.
 */
function get_date_from_gmt($string, $format = 'Y-m-d H:i:s')
{
    $datetime = date_create($string, new DateTimeZone('UTC'));
    if (false === $datetime) {
        return gmdate($format, 0);
    }
    return $datetime->setTimezone(wp_timezone())->format($format);
}

WordPress Version: 5.5

/**
 * Given a date in UTC or GMT timezone, returns that date in the timezone of the site.
 *
 * Requires and returns a date in the Y-m-d H:i:s format.
 * Return format can be overridden using the $format parameter.
 *
 * @since 1.2.0
 *
 * @param string $string The date to be converted, in UTC or GMT timezone.
 * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
 * @return string Formatted version of the date, in the site's timezone.
 */
function get_date_from_gmt($string, $format = 'Y-m-d H:i:s')
{
    $datetime = date_create($string, new DateTimeZone('UTC'));
    if (false === $datetime) {
        return gmdate($format, 0);
    }
    return $datetime->setTimezone(wp_timezone())->format($format);
}

WordPress Version: 5.4

/**
 * Given a date in UTC timezone, returns that date in the timezone of the site.
 *
 * Requires and returns a date in the Y-m-d H:i:s format.
 * Return format can be overridden using the $format parameter.
 *
 * @since 1.2.0
 *
 * @param string $string The date to be converted, in UTC timezone.
 * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
 * @return string Formatted version of the date, in the site's timezone.
 */
function get_date_from_gmt($string, $format = 'Y-m-d H:i:s')
{
    $datetime = date_create($string, new DateTimeZone('UTC'));
    if (false === $datetime) {
        return gmdate($format, 0);
    }
    return $datetime->setTimezone(wp_timezone())->format($format);
}

WordPress Version: 5.3

/**
 * Converts a GMT date into the correct format for the blog.
 *
 * Requires and returns a date in the Y-m-d H:i:s format.
 * Return format can be overridden using the $format parameter.
 *
 * @since 1.2.0
 *
 * @param string $string The date to be converted.
 * @param string $format The format string for the returned date. Default 'Y-m-d H:i:s'.
 * @return string Formatted date relative to the timezone.
 */
function get_date_from_gmt($string, $format = 'Y-m-d H:i:s')
{
    $datetime = date_create($string, new DateTimeZone('UTC'));
    if (false === $datetime) {
        return gmdate($format, 0);
    }
    return $datetime->setTimezone(wp_timezone())->format($format);
}

WordPress Version: 3.7

/**
 * Converts a GMT date into the correct format for the blog.
 *
 * Requires and returns a date in the Y-m-d H:i:s format. If there is a
 * timezone_string available, the returned date is in that timezone, otherwise
 * it simply adds the value of gmt_offset. Return format can be overridden
 * using the $format parameter
 *
 * @since 1.2.0
 *
 * @param string $string The date to be converted.
 * @param string $format The format string for the returned date (default is Y-m-d H:i:s)
 * @return string Formatted date relative to the timezone / GMT offset.
 */
function get_date_from_gmt($string, $format = 'Y-m-d H:i:s')
{
    $tz = get_option('timezone_string');
    if ($tz) {
        $datetime = date_create($string, new DateTimeZone('UTC'));
        if (!$datetime) {
            return date($format, 0);
        }
        $datetime->setTimezone(new DateTimeZone($tz));
        $string_localtime = $datetime->format($format);
    } else {
        if (!preg_match('#([0-9]{1,4})-([0-9]{1,2})-([0-9]{1,2}) ([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2})#', $string, $matches)) {
            return date($format, 0);
        }
        $string_time = gmmktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
        $string_localtime = gmdate($format, $string_time + get_option('gmt_offset') * HOUR_IN_SECONDS);
    }
    return $string_localtime;
}