2018-01-27 02:38:34 +00:00
|
|
|
<?php
|
|
|
|
/**
|
2022-01-02 07:27:47 +00:00
|
|
|
* @copyright Copyright (C) 2010-2022, the Friendica project
|
2020-02-09 15:18:46 +00:00
|
|
|
*
|
|
|
|
* @license GNU AGPL version 3 or any later version
|
|
|
|
*
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License as
|
|
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
|
|
* License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
*
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
namespace Friendica\Util;
|
|
|
|
|
2018-10-29 21:20:46 +00:00
|
|
|
use Friendica\Core\Logger;
|
2018-01-27 02:38:34 +00:00
|
|
|
use DateTime;
|
|
|
|
use DateTimeZone;
|
|
|
|
use Exception;
|
|
|
|
|
|
|
|
/**
|
2020-01-19 06:05:23 +00:00
|
|
|
* Temporal class
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
|
|
|
class DateTimeFormat
|
|
|
|
{
|
2021-06-01 22:32:05 +00:00
|
|
|
const ATOM = 'Y-m-d\TH:i:s\Z';
|
2018-01-27 02:38:34 +00:00
|
|
|
const MYSQL = 'Y-m-d H:i:s';
|
2021-06-01 22:32:05 +00:00
|
|
|
const HTTP = 'D, d M Y H:i:s \G\M\T';
|
2021-06-02 03:32:42 +00:00
|
|
|
const JSON = 'Y-m-d\TH:i:s.v\Z';
|
2021-11-18 21:43:13 +00:00
|
|
|
const API = 'D M d H:i:s +0000 Y';
|
2018-01-27 02:38:34 +00:00
|
|
|
|
2021-10-03 16:38:47 +00:00
|
|
|
static $localTimezone = 'UTC';
|
|
|
|
|
|
|
|
public static function setLocalTimeZone(string $timezone)
|
|
|
|
{
|
|
|
|
self::$localTimezone = $timezone;
|
|
|
|
}
|
|
|
|
|
2018-01-27 02:38:34 +00:00
|
|
|
/**
|
|
|
|
* convert() shorthand for UTC.
|
|
|
|
*
|
|
|
|
* @param string $time A date/time string
|
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
2019-01-06 21:06:53 +00:00
|
|
|
* @throws Exception
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
2021-12-02 14:07:54 +00:00
|
|
|
public static function utc(string $time, string $format = self::MYSQL): string
|
2018-01-27 02:38:34 +00:00
|
|
|
{
|
|
|
|
return self::convert($time, 'UTC', 'UTC', $format);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convert() shorthand for local.
|
|
|
|
*
|
|
|
|
* @param string $time A date/time string
|
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
2019-01-06 21:06:53 +00:00
|
|
|
* @throws Exception
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
|
|
|
public static function local($time, $format = self::MYSQL)
|
|
|
|
{
|
2021-10-03 16:38:47 +00:00
|
|
|
return self::convert($time, self::$localTimezone, 'UTC', $format);
|
2018-01-27 02:38:34 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convert() shorthand for timezoned now.
|
|
|
|
*
|
2019-01-06 21:06:53 +00:00
|
|
|
* @param $timezone
|
2018-01-27 02:38:34 +00:00
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
2019-01-06 21:06:53 +00:00
|
|
|
* @throws Exception
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
|
|
|
public static function timezoneNow($timezone, $format = self::MYSQL)
|
|
|
|
{
|
|
|
|
return self::convert('now', $timezone, 'UTC', $format);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convert() shorthand for local now.
|
|
|
|
*
|
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
2019-01-06 21:06:53 +00:00
|
|
|
* @throws Exception
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
|
|
|
public static function localNow($format = self::MYSQL)
|
|
|
|
{
|
|
|
|
return self::local('now', $format);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convert() shorthand for UTC now.
|
|
|
|
*
|
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
2019-01-06 21:06:53 +00:00
|
|
|
* @throws Exception
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
2021-12-02 14:07:54 +00:00
|
|
|
public static function utcNow(string $format = self::MYSQL): string
|
2018-01-27 02:38:34 +00:00
|
|
|
{
|
|
|
|
return self::utc('now', $format);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-01-19 06:05:23 +00:00
|
|
|
* General purpose date parse/convert/format function.
|
2018-01-27 02:38:34 +00:00
|
|
|
*
|
|
|
|
* @param string $s Some parseable date/time string
|
|
|
|
* @param string $tz_to Destination timezone
|
|
|
|
* @param string $tz_from Source timezone
|
|
|
|
* @param string $format Output format recognised from php's DateTime class
|
2019-01-06 21:06:53 +00:00
|
|
|
* http://www.php.net/manual/en/datetime.format.php
|
2018-01-27 02:38:34 +00:00
|
|
|
*
|
|
|
|
* @return string Formatted date according to given format
|
2019-01-06 21:06:53 +00:00
|
|
|
* @throws Exception
|
2018-01-27 02:38:34 +00:00
|
|
|
*/
|
|
|
|
public static function convert($s = 'now', $tz_to = 'UTC', $tz_from = 'UTC', $format = self::MYSQL)
|
|
|
|
{
|
|
|
|
// Defaults to UTC if nothing is set, but throws an exception if set to empty string.
|
|
|
|
// Provide some sane defaults regardless.
|
2018-02-12 15:08:28 +00:00
|
|
|
if ($tz_from === '') {
|
|
|
|
$tz_from = 'UTC';
|
2018-01-27 02:38:34 +00:00
|
|
|
}
|
|
|
|
|
2018-02-12 15:08:28 +00:00
|
|
|
if ($tz_to === '') {
|
|
|
|
$tz_to = 'UTC';
|
2018-01-27 02:38:34 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (($s === '') || (!is_string($s))) {
|
|
|
|
$s = 'now';
|
|
|
|
}
|
|
|
|
|
2022-10-03 16:12:22 +00:00
|
|
|
$s = self::fixDateFormat($s);
|
|
|
|
|
2018-01-27 02:38:34 +00:00
|
|
|
/*
|
|
|
|
* Slight hackish adjustment so that 'zero' datetime actually returns what is intended
|
|
|
|
* otherwise we end up with -0001-11-30 ...
|
|
|
|
* add 32 days so that we at least get year 00, and then hack around the fact that
|
|
|
|
* months and days always start with 1.
|
|
|
|
*/
|
|
|
|
if (substr($s, 0, 10) <= '0001-01-01') {
|
2018-04-04 18:58:25 +00:00
|
|
|
if ($s < '0000-00-00') {
|
|
|
|
$s = '0000-00-00';
|
|
|
|
}
|
2018-01-27 02:38:34 +00:00
|
|
|
$d = new DateTime($s . ' + 32 days', new DateTimeZone('UTC'));
|
|
|
|
return str_replace('1', '0', $d->format($format));
|
|
|
|
}
|
|
|
|
|
|
|
|
try {
|
|
|
|
$from_obj = new DateTimeZone($tz_from);
|
|
|
|
} catch (Exception $e) {
|
|
|
|
$from_obj = new DateTimeZone('UTC');
|
|
|
|
}
|
|
|
|
|
|
|
|
try {
|
|
|
|
$d = new DateTime($s, $from_obj);
|
|
|
|
} catch (Exception $e) {
|
2022-08-30 19:45:30 +00:00
|
|
|
Logger::warning('DateTimeFormat::convert: exception: ' . $e->getMessage());
|
2018-01-27 02:38:34 +00:00
|
|
|
$d = new DateTime('now', $from_obj);
|
|
|
|
}
|
|
|
|
|
|
|
|
try {
|
|
|
|
$to_obj = new DateTimeZone($tz_to);
|
|
|
|
} catch (Exception $e) {
|
|
|
|
$to_obj = new DateTimeZone('UTC');
|
|
|
|
}
|
|
|
|
|
2021-10-03 16:38:47 +00:00
|
|
|
$d->setTimezone($to_obj);
|
2018-01-27 02:38:34 +00:00
|
|
|
|
|
|
|
return $d->format($format);
|
|
|
|
}
|
2019-10-23 00:39:28 +00:00
|
|
|
|
2022-10-03 16:12:22 +00:00
|
|
|
/**
|
|
|
|
* Fix weird date formats
|
|
|
|
*
|
|
|
|
* @param string $dateString
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
private static function fixDateFormat(string $dateString): string
|
|
|
|
{
|
|
|
|
$pattern =
|
|
|
|
[
|
|
|
|
['#(\w+), (\d+/\d+/\d+) - (\d+:\d+)#', '$1, $2 $3'],
|
|
|
|
['#(\d+-\d+-\d+)T(\d+:\d+:\d+)ZZ#', '$1T$2Z'],
|
|
|
|
['#(\d+-\d+-\d+)T(\d+:\d+:\d+\.\d+)ZZ#', '$1T$2Z'],
|
|
|
|
['#(\w+), (\d+ \w+ \d+) (\d+:\d+:\d+) (.+)#', '$2 $3 $4'],
|
|
|
|
['#(\d+:\d+) (\w+), (\w+) (\d+), (\d+)#', '$1 $2 $3 $4 $5'],
|
|
|
|
];
|
|
|
|
|
|
|
|
foreach ($pattern as $search_replace) {
|
|
|
|
$dateString = preg_replace($search_replace[0], $search_replace[1], $dateString);
|
|
|
|
}
|
|
|
|
return $dateString;
|
|
|
|
}
|
|
|
|
|
2019-10-23 00:39:28 +00:00
|
|
|
/**
|
|
|
|
* Checks, if the given string is a date with the pattern YYYY-MM
|
|
|
|
*
|
|
|
|
* @param string $dateString The given date
|
|
|
|
*
|
|
|
|
* @return boolean True, if the date is a valid pattern
|
|
|
|
*/
|
|
|
|
public function isYearMonth(string $dateString)
|
|
|
|
{
|
|
|
|
// Check format (2019-01, 2019-1, 2019-10)
|
|
|
|
if (!preg_match('/^([12]\d{3}-(1[0-2]|0[1-9]|\d))$/', $dateString)) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
$date = DateTime::createFromFormat('Y-m', $dateString);
|
|
|
|
|
|
|
|
if (!$date) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
try {
|
|
|
|
$now = new DateTime();
|
|
|
|
} catch (\Throwable $t) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($date > $now) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
2020-01-15 04:06:30 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Checks, if the given string is a date with the pattern YYYY-MM-DD
|
|
|
|
*
|
|
|
|
* @param string $dateString The given date
|
|
|
|
*
|
|
|
|
* @return boolean True, if the date is a valid pattern
|
|
|
|
*/
|
|
|
|
public function isYearMonthDay(string $dateString)
|
|
|
|
{
|
|
|
|
$date = DateTime::createFromFormat('Y-m-d', $dateString);
|
|
|
|
if (!$date) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (DateTime::getLastErrors()['error_count'] || DateTime::getLastErrors()['warning_count']) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
2018-01-27 02:38:34 +00:00
|
|
|
}
|