dillard
e58b86fc48
Off, once a day or every N hours from a time, each in its own time zone. Existing locations keep the time that held for all of them. A backup that has to wait shows as queued, and its restore point has the time it really began.
94 lines
3.4 KiB
PHP
94 lines
3.4 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
// SPDX-FileCopyrightText: 2026 Dillard Blom
|
|
// SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
namespace OCA\NgBackup\Service;
|
|
|
|
use OCA\NgBackup\AppInfo\Application;
|
|
use OCP\IAppConfig;
|
|
use OCP\IConfig;
|
|
use OCP\IGroupManager;
|
|
|
|
/**
|
|
* The time zone times are shown in, and the daily time from before each location had its own
|
|
* schedule (see LocationSchedule). Nextcloud runs PHP in UTC, so a time without a zone meant UTC
|
|
* (issue #19: 03:00 ran at 05:00 in Berlin). A time saved before there was a zone is converted once
|
|
* to the zone of the server or of an administrator, at today's offset: it then shows as it
|
|
* effectively ran (02:30 UTC becomes 04:30 Europe/Berlin in summer).
|
|
*/
|
|
final class Schedule {
|
|
public const TIME_KEY = 'schedule_time';
|
|
public const ZONE_KEY = 'schedule_timezone';
|
|
|
|
public function __construct(
|
|
private IAppConfig $appConfig,
|
|
private IConfig $config,
|
|
private IGroupManager $groups,
|
|
) {
|
|
}
|
|
|
|
/** @return array{time: string, timezone: non-empty-string} time "" = no schedule */
|
|
public function get(): array {
|
|
$time = $this->appConfig->getValueString(Application::APP_ID, self::TIME_KEY, '');
|
|
$zone = $this->appConfig->getValueString(Application::APP_ID, self::ZONE_KEY, '');
|
|
if ($zone === '' || !self::validZone($zone)) {
|
|
$zone = $this->guessZone();
|
|
if ($time !== '' && self::validTime($time)) {
|
|
$time = self::convert($time, 'UTC', $zone);
|
|
$this->appConfig->setValueString(Application::APP_ID, self::TIME_KEY, $time);
|
|
}
|
|
$this->appConfig->setValueString(Application::APP_ID, self::ZONE_KEY, $zone);
|
|
}
|
|
return ['time' => $time, 'timezone' => $zone];
|
|
}
|
|
|
|
/** @return non-empty-string the zone of a location's schedule, or else this one */
|
|
public function zoneOr(?string $zone): string {
|
|
return $zone !== null && self::validZone($zone) ? $zone : $this->get()['timezone'];
|
|
}
|
|
|
|
/**
|
|
* "HH:MM" in zone $from as "HH:MM" in zone $to, at today's offsets.
|
|
*
|
|
* @param non-empty-string $from
|
|
* @param non-empty-string $to
|
|
*/
|
|
public static function convert(string $time, string $from, string $to, ?int $now = null): string {
|
|
$day = (new \DateTimeImmutable('@' . ($now ?? time())))->setTimezone(new \DateTimeZone($from))->format('Y-m-d');
|
|
return (new \DateTimeImmutable($day . ' ' . $time, new \DateTimeZone($from)))->setTimezone(new \DateTimeZone($to))->format('H:i');
|
|
}
|
|
|
|
public static function validTime(string $time): bool {
|
|
return preg_match('/^([01]\d|2[0-3]):[0-5]\d$/', $time) === 1;
|
|
}
|
|
|
|
/** @psalm-assert-if-true non-empty-string $zone */
|
|
public static function validZone(string $zone): bool {
|
|
return in_array($zone, \DateTimeZone::listIdentifiers(), true);
|
|
}
|
|
|
|
/**
|
|
* The server's default_timezone when set, else the first administrator's, else UTC. A server
|
|
* zone of UTC is passed over on purpose: it is mostly what an image or installer left there,
|
|
* while the administrator who set the time read it as their own (#19).
|
|
*
|
|
* @return non-empty-string
|
|
*/
|
|
private function guessZone(): string {
|
|
$zone = $this->config->getSystemValueString('default_timezone', '');
|
|
if ($zone !== '' && $zone !== 'UTC' && self::validZone($zone)) {
|
|
return $zone;
|
|
}
|
|
foreach ($this->groups->get('admin')?->getUsers() ?? [] as $user) {
|
|
$zone = $this->config->getUserValue($user->getUID(), 'core', 'timezone', '');
|
|
if ($zone !== '' && self::validZone($zone)) {
|
|
return $zone;
|
|
}
|
|
}
|
|
return 'UTC';
|
|
}
|
|
}
|