<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* WC Wrapper for PHP DateTime which adds support for gmt/utc offset when a

[2] Fix | Delete

* timezone is absent

[3] Fix | Delete

*

[4] Fix | Delete

* @since 3.0.0

[5] Fix | Delete

* @package WooCommerce\Classes

[6] Fix | Delete

*/

[7] Fix | Delete

[8] Fix | Delete

defined( 'ABSPATH' ) || exit;

[9] Fix | Delete

[10] Fix | Delete

/**

[11] Fix | Delete

* Datetime class.

[12] Fix | Delete

*/

[13] Fix | Delete

class WC_DateTime extends DateTime {

[14] Fix | Delete

[15] Fix | Delete

/**

[16] Fix | Delete

* UTC Offset, if needed. Only used when a timezone is not set. When

[17] Fix | Delete

* timezones are used this will equal 0.

[18] Fix | Delete

*

[19] Fix | Delete

* @var integer

[20] Fix | Delete

*/

[21] Fix | Delete

protected $utc_offset = 0;

[22] Fix | Delete

[23] Fix | Delete

/**

[24] Fix | Delete

* Output an ISO 8601 date string in local (WordPress) timezone.

[25] Fix | Delete

*

[26] Fix | Delete

* @since 3.0.0

[27] Fix | Delete

* @return string

[28] Fix | Delete

*/

[29] Fix | Delete

public function __toString() {

[30] Fix | Delete

return $this->format( DATE_ATOM );

[31] Fix | Delete

}

[32] Fix | Delete

[33] Fix | Delete

/**

[34] Fix | Delete

* Set UTC offset - this is a fixed offset instead of a timezone.

[35] Fix | Delete

*

[36] Fix | Delete

* @param int $offset Offset.

[37] Fix | Delete

*/

[38] Fix | Delete

public function set_utc_offset( $offset ) {

[39] Fix | Delete

$this->utc_offset = intval( $offset );

[40] Fix | Delete

}

[41] Fix | Delete

[42] Fix | Delete

/**

[43] Fix | Delete

* Get UTC offset if set, or default to the DateTime object's offset.

[44] Fix | Delete

*/

[45] Fix | Delete

#[\ReturnTypeWillChange]

[46] Fix | Delete

public function getOffset() {

[47] Fix | Delete

return $this->utc_offset ?: parent::getOffset();

[48] Fix | Delete

}

[49] Fix | Delete

[50] Fix | Delete

/**

[51] Fix | Delete

* Set timezone.

[52] Fix | Delete

*

[53] Fix | Delete

* @param DateTimeZone $timezone DateTimeZone instance.

[54] Fix | Delete

* @return DateTime

[55] Fix | Delete

*/

[56] Fix | Delete

#[\ReturnTypeWillChange]

[57] Fix | Delete

public function setTimezone( $timezone ) {

[58] Fix | Delete

$this->utc_offset = 0;

[59] Fix | Delete

return parent::setTimezone( $timezone );

[60] Fix | Delete

}

[61] Fix | Delete

[62] Fix | Delete

/**

[63] Fix | Delete

* Missing in PHP 5.2 so just here so it can be supported consistently.

[64] Fix | Delete

*

[65] Fix | Delete

* @since 3.0.0

[66] Fix | Delete

* @return int

[67] Fix | Delete

*/

[68] Fix | Delete

#[\ReturnTypeWillChange]

[69] Fix | Delete

public function getTimestamp() {

[70] Fix | Delete

return method_exists( 'DateTime', 'getTimestamp' ) ? parent::getTimestamp() : $this->format( 'U' );

[71] Fix | Delete

}

[72] Fix | Delete

[73] Fix | Delete

/**

[74] Fix | Delete

* Get the timestamp with the WordPress timezone offset added or subtracted.

[75] Fix | Delete

*

[76] Fix | Delete

* @since 3.0.0

[77] Fix | Delete

* @return int

[78] Fix | Delete

*/

[79] Fix | Delete

public function getOffsetTimestamp() {

[80] Fix | Delete

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

[81] Fix | Delete

}

[82] Fix | Delete

[83] Fix | Delete

/**

[84] Fix | Delete

* Format a date based on the offset timestamp.

[85] Fix | Delete

*

[86] Fix | Delete

* @since 3.0.0

[87] Fix | Delete

* @param string $format Date format.

[88] Fix | Delete

* @return string

[89] Fix | Delete

*/

[90] Fix | Delete

public function date( $format ) {

[91] Fix | Delete

return gmdate( $format, $this->getOffsetTimestamp() );

[92] Fix | Delete

}

[93] Fix | Delete

[94] Fix | Delete

/**

[95] Fix | Delete

* Return a localised date based on offset timestamp. Wrapper for date_i18n function.

[96] Fix | Delete

*

[97] Fix | Delete

* @since 3.0.0

[98] Fix | Delete

* @param string $format Date format.

[99] Fix | Delete

* @return string

[100] Fix | Delete

*/

[101] Fix | Delete

public function date_i18n( $format = 'Y-m-d' ) {

[102] Fix | Delete

return date_i18n( $format, $this->getOffsetTimestamp() );

[103] Fix | Delete

}

[104] Fix | Delete

}

[105] Fix | Delete

[106] Fix | Delete