2018-01-27 02:38:34 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @file src/Util/DateTimeFormat.php
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace Friendica\Util;
|
|
|
|
|
|
|
|
use DateTime;
|
|
|
|
use DateTimeZone;
|
|
|
|
use Exception;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Temporal class
|
|
|
|
*/
|
|
|
|
class DateTimeFormat
|
|
|
|
{
|
|
|
|
const ATOM = 'Y-m-d\TH:i:s\Z';
|
|
|
|
const MYSQL = 'Y-m-d H:i:s';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convert() shorthand for UTC.
|
|
|
|
*
|
|
|
|
* @param string $time A date/time string
|
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public static function utc($time, $format = self::MYSQL)
|
|
|
|
{
|
|
|
|
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
|
|
|
|
*/
|
|
|
|
public static function local($time, $format = self::MYSQL)
|
|
|
|
{
|
|
|
|
return self::convert($time, date_default_timezone_get(), 'UTC', $format);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convert() shorthand for timezoned now.
|
|
|
|
*
|
|
|
|
* @param string $format DateTime format string or Temporal constant
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
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
|
|
|
|
*/
|
|
|
|
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
|
|
|
|
*/
|
|
|
|
public static function utcNow($format = self::MYSQL)
|
|
|
|
{
|
|
|
|
return self::utc('now', $format);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief General purpose date parse/convert/format function.
|
|
|
|
*
|
|
|
|
* @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
|
|
|
|
* http://www.php.net/manual/en/datetime.format.php
|
|
|
|
*
|
|
|
|
* @return string Formatted date according to given format
|
|
|
|
*/
|
|
|
|
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';
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* 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') {
|
|
|
|
$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) {
|
2018-02-04 01:44:19 +00:00
|
|
|
logger('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');
|
|
|
|
}
|
|
|
|
|
|
|
|
$d->setTimeZone($to_obj);
|
|
|
|
|
|
|
|
return $d->format($format);
|
|
|
|
}
|
|
|
|
}
|