1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
<?php
namespace Yoast\WP\SEO\Helpers;
/**
* A helper object for dates.
*/
class Date_Helper {
/**
* Convert given date string to the W3C format.
*
* If $translate is true then the given date and format string will
* be passed to date_i18n() for translation.
*
* @param string $date Date string to convert.
* @param bool $translate Whether the return date should be translated. Default false.
*
* @return string Formatted date string.
*/
public function mysql_date_to_w3c_format( $date, $translate = false ) {
return \mysql2date( \DATE_W3C, $date, $translate );
}
/**
* Formats a given date in UTC TimeZone format.
*
* @param string $date String representing the date / time.
* @param string $format The format that the passed date should be in.
*
* @return string The formatted date.
*/
public function format( $date, $format = \DATE_W3C ) {
$immutable_date = \date_create_immutable_from_format( 'Y-m-d H:i:s', $date, new \DateTimeZone( 'UTC' ) );
if ( ! $immutable_date ) {
return $date;
}
return $immutable_date->format( $format );
}
/**
* Formats the given timestamp to the needed format.
*
* @param int $timestamp The timestamp to use for the formatting.
* @param string $format The format that the passed date should be in.
*
* @return string The formatted date.
*/
public function format_timestamp( $timestamp, $format = DATE_W3C ) {
$immutable_date = \date_create_immutable_from_format( 'U', $timestamp, new \DateTimeZone( 'UTC' ) );
if ( ! $immutable_date ) {
return $timestamp;
}
return $immutable_date->format( $format );
}
/**
* Formats a given date in UTC TimeZone format and translate it to the set language.
*
* @param string $date String representing the date / time.
* @param string $format The format that the passed date should be in.
*
* @return string The formatted and translated date.
*/
public function format_translated( $date, $format = DATE_W3C ) {
return \date_i18n( $format, $this->format( $date, 'U' ) );
}
/**
* Returns the current time measured in the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).
*
* @return int The current time measured in the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).
*/
public function current_time() {
return \time();
}
/**
* Check if a string is a valid datetime.
*
* @param string $datetime String input to check as valid input for DateTime class.
*
* @return bool True when datatime is valid.
*/
public function is_valid_datetime( $datetime ) {
if ( \substr( $datetime, 0, 1 ) === '-' ) {
return false;
}
try {
return new \DateTime( $datetime ) !== false;
} catch ( \Exception $exception ) {
return false;
}
}
}
|