require ABSPATH . WPINC . '/option.php';

/**

 * Convert given MySQL date string into a different format.

 *

 * `$format` should be a PHP date format string.

 * 'U' and 'G' formats will return a sum of timestamp with timezone offset.

 * `$date` is expected to be local time in MySQL format (`Y-m-d H:i:s`).

 *

 * Historically UTC time could be passed to the function to produce Unix timestamp.

 *

 * If `$translate` is true then the given date and format string will

 * be passed to `wp_date()` for translation.

 * @return string|int|false Formatted date string or sum of Unix timestamp and timezone offset.

 *                          False on failure.

	$datetime = date_create( $date, wp_timezone() );

	if ( false === $datetime ) {

		return false;

	}

	// Returns a sum of timestamp with timezone offset. Ideally should never be used.

	if ( 'G' === $format || 'U' === $format ) {

		return $datetime->getTimestamp() + $datetime->getOffset();

		return wp_date( $format, $datetime->getTimestamp() );

	}

	return $datetime->format( $format );

}

/**

 * Retrieves the current time based on specified type.

 * The 'timestamp' type will return the current timestamp or a sum of timestamp

 * and timezone offset, depending on `$gmt`.

 * @param string   $type Type of time to retrieve. Accepts 'mysql', 'timestamp',

 *                       or PHP date format string (e.g. 'Y-m-d').

	// Don't use non-GMT timestamp, unless you know the difference and really need to.

	if ( 'timestamp' === $type || 'U' === $type ) {

		return $gmt ? time() : time() + (int) ( get_option( 'gmt_offset' ) * HOUR_IN_SECONDS );

	}

	if ( 'mysql' === $type ) {

		$type = 'Y-m-d H:i:s';

	}

	$timezone = $gmt ? new DateTimeZone( 'UTC' ) : wp_timezone();

	$datetime = new DateTime( 'now', $timezone );

	return $datetime->format( $type );

}

/**

 * Retrieves the current time as an object with the timezone from settings.

 *

 * @since 5.3.0

 *

 * @return DateTimeImmutable Date and time object.

 */

function current_datetime() {

	return new DateTimeImmutable( 'now', wp_timezone() );

}

/**

 * Retrieves the timezone from site settings as a string.

 *

 * Uses the `timezone_string` option to get a proper timezone if available,

 * otherwise falls back to an offset.

 *

 * @since 5.3.0

 *

 * @return string PHP timezone string or a ±HH:MM offset.

 */

function wp_timezone_string() {

	$timezone_string = get_option( 'timezone_string' );

	if ( $timezone_string ) {

		return $timezone_string;

	}

	$offset  = (float) get_option( 'gmt_offset' );

	$hours   = (int) $offset;

	$minutes = ( $offset - $hours );

	$sign      = ( $offset < 0 ) ? '-' : '+';

	$abs_hour  = abs( $hours );

	$abs_mins  = abs( $minutes * 60 );

	$tz_offset = sprintf( '%s%02d:%02d', $sign, $abs_hour, $abs_mins );

	return $tz_offset;

}

/**

 * Retrieves the timezone from site settings as a `DateTimeZone` object.

 *

 * Timezone can be based on a PHP timezone string or a ±HH:MM offset.

 *

 * @since 5.3.0

 *

 * @return DateTimeZone Timezone object.

 */

function wp_timezone() {

	return new DateTimeZone( wp_timezone_string() );

}

/**

 * Retrieves the date in localized format, based on a sum of Unix timestamp and

 * Note that due to the way WP typically generates a sum of timestamp and offset

 * with `strtotime()`, it implies offset added at a _current_ time, not at the time

 * the timestamp represents. Storing such timestamps or calculating them differently

 * will lead to invalid output.

 *

 * @since 5.3.0 Converted into a wrapper for wp_date().

 *

 * @global WP_Locale $wp_locale WordPress date and time locale object.

 *

 * @param string   $format                Format to display the date.

 * @param int|bool $timestamp_with_offset Optional. A sum of Unix timestamp and timezone offset

 *                                        in seconds. Default false.

 * @param bool     $gmt                   Optional. Whether to use GMT timezone. Only applies

 *                                        if timestamp is not provided. Default false.

function date_i18n( $format, $timestamp_with_offset = false, $gmt = false ) {

	$timestamp = $timestamp_with_offset;

	// If timestamp is omitted it should be current time (summed with offset, unless `$gmt` is true).

	if ( ! is_numeric( $timestamp ) ) {

		$timestamp = current_time( 'timestamp', $gmt );

	 * This is a legacy implementation quirk that the returned timestamp is also with offset.

	 * Ideally this function should never be used to produce a timestamp.

	if ( 'U' === $format ) {

		$date = $timestamp;

	} elseif ( $gmt && false === $timestamp_with_offset ) { // Current time in UTC.

		$date = wp_date( $format, null, new DateTimeZone( 'UTC' ) );

	} elseif ( false === $timestamp_with_offset ) { // Current time in site's timezone.

		$date = wp_date( $format );

	} else {

		/*

		 * Timestamp with offset is typically produced by a UTC `strtotime()` call on an input without timezone.

		 * This is the best attempt to reverse that operation into a local time to use.

		 */

		$local_time = gmdate( 'Y-m-d H:i:s', $timestamp );

		$timezone   = wp_timezone();

		$datetime   = date_create( $local_time, $timezone );

		$date       = wp_date( $format, $datetime->getTimestamp(), $timezone );

	}

	 * @param string $date      Formatted date string.

	 * @param string $format    Format to display the date.

	 * @param int    $timestamp A sum of Unix timestamp and timezone offset in seconds.

	 *                          Might be without offset if input omitted timestamp but requested GMT.

	 * @param bool   $gmt       Whether to use GMT timezone. Only applies if timestamp was not provided.

	 *                          Default false.

	$date = apply_filters( 'date_i18n', $date, $format, $timestamp, $gmt );

	return $date;

}

/**

 * Retrieves the date, in localized format.

 *

 * This is a newer function, intended to replace `date_i18n()` without legacy quirks in it.

 *

 * Note that, unlike `date_i18n()`, this function accepts a true Unix timestamp, not summed

 * with timezone offset.

 *

 * @since 5.3.0

 *

 * @param string       $format    PHP date format.

 * @param int          $timestamp Optional. Unix timestamp. Defaults to current time.

 * @param DateTimeZone $timezone  Optional. Timezone to output result in. Defaults to timezone

 *                                from site settings.

 * @return string|false The date, translated if locale specifies it. False on invalid timestamp input.

 */

function wp_date( $format, $timestamp = null, $timezone = null ) {

	global $wp_locale;

	if ( null === $timestamp ) {

		$timestamp = time();

	} elseif ( ! is_numeric( $timestamp ) ) {

		return false;

	}

	if ( ! $timezone ) {

		$timezone = wp_timezone();

	}

	$datetime = date_create( '@' . $timestamp );

	$datetime->setTimezone( $timezone );

	if ( empty( $wp_locale->month ) || empty( $wp_locale->weekday ) ) {

		$date = $datetime->format( $format );

	} else {

		// We need to unpack shorthand `r` format because it has parts that might be localized.

		$format = preg_replace( '/(?<!\\\\)r/', DATE_RFC2822, $format );

		$new_format    = '';

		$format_length = strlen( $format );

		$month         = $wp_locale->get_month( $datetime->format( 'm' ) );

		$weekday       = $wp_locale->get_weekday( $datetime->format( 'w' ) );

		for ( $i = 0; $i < $format_length; $i ++ ) {

			switch ( $format[ $i ] ) {

				case 'D':

					$new_format .= addcslashes( $wp_locale->get_weekday_abbrev( $weekday ), '\\A..Za..z' );

					break;

				case 'F':

					$new_format .= addcslashes( $month, '\\A..Za..z' );

					break;

				case 'l':

					$new_format .= addcslashes( $weekday, '\\A..Za..z' );

					break;

				case 'M':

					$new_format .= addcslashes( $wp_locale->get_month_abbrev( $month ), '\\A..Za..z' );

					break;

				case 'a':

					$new_format .= addcslashes( $wp_locale->get_meridiem( $datetime->format( 'a' ) ), '\\A..Za..z' );

					break;

				case 'A':

					$new_format .= addcslashes( $wp_locale->get_meridiem( $datetime->format( 'A' ) ), '\\A..Za..z' );

					break;

				case '\\':

					$new_format .= $format[ $i ];

					// If character follows a slash, we add it without translating.

					if ( $i < $format_length ) {

						$new_format .= $format[ ++$i ];

					}

					break;

				default:

					$new_format .= $format[ $i ];

					break;

			}

		}

		$date = $datetime->format( $new_format );

		$date = wp_maybe_decline_date( $date, $format );

	}

	/**

	 * Filters the date formatted based on the locale.

	 *

	 * @since 5.3.0

	 *

	 * @param string       $date      Formatted date string.

	 * @param string       $format    Format to display the date.

	 * @param int          $timestamp Unix timestamp.

	 * @param DateTimeZone $timezone  Timezone.

	 */

	$date = apply_filters( 'wp_date', $date, $format, $timestamp, $timezone );

	return $date;

 * @since 5.4.0 The `$format` parameter was added.

 *

 * @global WP_Locale $wp_locale WordPress date and time locale object.

 *

 * @param string $date   Formatted date string.

 * @param string $format Optional. Date format to check. Default empty string.

function wp_maybe_decline_date( $date, $format = '' ) {

	// i18n functions are not available in SHORTINIT mode.

	/*

	 * translators: If months in your language require a genitive case,

		$months          = $wp_locale->month;

		$months_genitive = $wp_locale->month_genitive;

		/*

		 * Match a format like 'j F Y' or 'j. F' (day of the month, followed by month name)

		 * and decline the month.

		 */

		if ( $format ) {

			$decline = preg_match( '#[dj]\.? F#', $format );

		} else {

			// If the format is not passed, try to guess it from the date string.

			$decline = preg_match( '#\b\d{1,2}\.? [^\d ]+\b#u', $date );

		}

		if ( $decline ) {

				$months[ $key ] = '# ' . preg_quote( $month, '#' ) . '\b#u';

				$months_genitive[ $key ] = ' ' . $month;

		/*

		 * Match a format like 'F jS' or 'F j' (month name, followed by day with an optional ordinal suffix)

		 * and change it to declined 'j F'.

		 */

		if ( $format ) {

			$decline = preg_match( '#F [dj]#', $format );

		} else {

			// If the format is not passed, try to guess it from the date string.

			$decline = preg_match( '#\b[^\d ]+ \d{1,2}(st|nd|rd|th)?\b#u', trim( $date ) );

		}

		if ( $decline ) {

			foreach ( $months as $key => $month ) {

				$months[ $key ] = '#\b' . preg_quote( $month, '#' ) . ' (\d{1,2})(st|nd|rd|th)?([-–]\d{1,2})?(st|nd|rd|th)?\b#u';

			}

			foreach ( $months_genitive as $key => $month ) {

				$months_genitive[ $key ] = '$1$3 ' . $month;

			}

			$date = preg_replace( $months, $months_genitive, $date );

		}

	}

	// Used for locale-specific rules.

 * @global WP_Locale $wp_locale WordPress date and time locale object.

 * @return string|false Number string on success, false on failure.

		/* translators: Unit symbol for terabyte. */

		_x( 'TB', 'unit symbol' ) => TB_IN_BYTES,

		/* translators: Unit symbol for gigabyte. */

		_x( 'GB', 'unit symbol' ) => GB_IN_BYTES,

		/* translators: Unit symbol for megabyte. */

		_x( 'MB', 'unit symbol' ) => MB_IN_BYTES,

		/* translators: Unit symbol for kilobyte. */

		_x( 'KB', 'unit symbol' ) => KB_IN_BYTES,

		/* translators: Unit symbol for byte. */

		_x( 'B', 'unit symbol' )  => 1,

		/* translators: Unit symbol for byte. */

		return number_format_i18n( 0, $decimals ) . ' ' . _x( 'B', 'unit symbol' );