sda-php/nur-ture
11
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

modifs.mineures sans commentaires

Browse Source
This commit is contained in:
Jephté Clain 2025-10-22 15:40:38 +04:00
parent 81f666f90e
commit 3ef592aba5
4 changed files with 178 additions and 73 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
src/php/time/Hour.php
View File

@ -5,4 +5,12 @@ class Hour extends Time {
const UNIT = self::UNIT_MINUTES; const UNIT = self::UNIT_MINUTES;
const FORMAT = "%hh%M"; const FORMAT = "%hh%M";
function format(?string $format=null): string {
$string = parent::format($format);
if (substr($string, -3) == "h00") {
$string = substr($string, 0, -2);
}
return $string;
}
} }

155
src/php/time/Time.php
View File

@ -3,6 +3,8 @@ namespace nulib\php\time;
use DateTimeInterface; use DateTimeInterface;
use nulib\exceptions; use nulib\exceptions;
use nulib\php\types\vbool;
use nulib\php\types\vint;
/** /**
* Class Time: une heure allant de 0h à 24h inclus. * Class Time: une heure allant de 0h à 24h inclus.
@ -15,7 +17,10 @@ class Time {
const UNIT_MINUTES = 60; const UNIT_MINUTES = 60;
const UNIT_SECONDS = 1; const UNIT_SECONDS = 1;
const PATTERN = '/^(\d+):(\d+)(?::(\d+))?$/'; const PATTERNS = [
'/^(\d+)[:.h](\d+)(?:[:.](\d+))?$/',
'/^(\d+)h(?:(\d+)(?:[:.](\d+))?)?$/'
];
/** @var string format par défaut pour l'affichage */ /** @var string format par défaut pour l'affichage */
const FORMAT = "%H:%M:%S"; const FORMAT = "%H:%M:%S";
@ -33,46 +38,59 @@ class Time {
static function isa_time($time): bool { static function isa_time($time): bool {
if ($time === null) return false; if ($time === null) return false;
if ($time instanceof Time) return true; if ($time instanceof self) return true;
if (is_int($time)) return true; if (is_int($time)) return true;
if (is_string($time)) return preg_match(self::PATTERN, $time); if (is_string($time)) {
#XXX supporter tous les formats foreach (self::PATTERNS as $pattern) {
if (preg_match($pattern, $time)) return true;
}
}
if ($time instanceof DateTimeInterface) return true;
if (is_array($time) && count($time) == 3) return true;
return false; return false;
} }
static function seconds_now(): int { protected static function s_now(): int {
$hms = date('His'); $hms = date('His');
return intval(substr($hms, 0, 2)) * 3600 return intval(substr($hms, 0, 2)) * 3600
+ intval(substr($hms, 2, 2)) * 60 + intval(substr($hms, 2, 2)) * 60
+ intval(substr($hms, 4, 2)); + intval(substr($hms, 4, 2));
} }
static function seconds_get($time, int $unit=self::UNIT_SECONDS): int { protected static function s_get($time, int $unit=self::UNIT_SECONDS): int {
if ($time instanceof self) { if ($time === null) {
return 0;
} elseif ($time instanceof self) {
return $time->getSeconds(); return $time->getSeconds();
} elseif (is_int($time)) { } elseif (is_int($time)) {
return $time * $unit; return $time * $unit;
} elseif (is_array($time)) { } elseif (is_string($time)) {
[$h, $m, $s] = $time; $matched = false;
return $h * 3600 + $m * 60 + $s; foreach (self::PATTERNS as $pattern) {
} elseif (is_string($time) && preg_match(self::PATTERN, $time, $ms)) { if (preg_match($pattern, $time, $ms)) {
$h = $ms[1]; $matched = true;
$m = $ms[2]; break;
$s = $ms[3] ?? 0; }
return intval($h) * 3600 + intval($m) * 60 + intval($s); }
if ($matched) {
$h = $ms[1];
$m = $ms[2] ?? 0;
$s = $ms[3] ?? 0;
return intval($h) * 3600 + intval($m) * 60 + intval($s);
}
} elseif ($time instanceof DateTimeInterface) { } elseif ($time instanceof DateTimeInterface) {
$hms = $time->format('His'); $hms = $time->format('His');
return intval(substr($hms, 0, 2)) * 3600 return intval(substr($hms, 0, 2)) * 3600
+ intval(substr($hms, 2, 2)) * 60 + intval(substr($hms, 2, 2)) * 60
+ intval(substr($hms, 4, 2)); + intval(substr($hms, 4, 2));
} elseif ($time === null) { } elseif (is_array($time) && count($time) == 3) {
return 0; [$h, $m, $s] = $time;
} else { return $h * 3600 + $m * 60 + $s;
throw exceptions::invalid_value($time, "time");
} }
throw exceptions::invalid_value($time, "time");
} }
static function seconds_adjust(int &$seconds, int $unit=self::UNIT_SECONDS, ?int $step=null): int { protected static function s_adjust(int &$seconds, int $unit=self::UNIT_SECONDS, ?int $step=null): int {
if ($step !== null) $unit *= $step; if ($step !== null) $unit *= $step;
$adjust = $seconds % $unit; $adjust = $seconds % $unit;
if ($seconds < 0) $adjust = -$adjust; if ($seconds < 0) $adjust = -$adjust;
@ -80,46 +98,49 @@ class Time {
return $seconds; return $seconds;
} }
static function seconds_wrap_start(int &$seconds): int { protected static function s_wrap_start(int &$seconds): int {
while ($seconds < 0) $seconds += 86400; while ($seconds < 0) $seconds += 86400;
if ($seconds >= 86400) $seconds %= 86400; if ($seconds >= 86400) $seconds %= 86400;
return $seconds; return $seconds;
} }
static function seconds_wrap_end(int &$seconds): int { protected static function s_wrap_end(int &$seconds): int {
while ($seconds < 0) $seconds += 86400; while ($seconds < 0) $seconds += 86400;
if ($seconds > 86400) $seconds %= 86400; if ($seconds > 86400) $seconds %= 86400;
return $seconds; return $seconds;
} }
/** /**
* @return int la valeur de l'unité en secondes, pour le constructeur et les * @var int la valeur de l'unité en secondes, pour le constructeur et les
* méthodes {@link newu()}, {@link addu()} et {@link subu()} * méthodes {@link setu()}, {@link addu()} et {@link subu()}
*/ */
function UNIT(): int { const UNIT = self::UNIT_SECONDS;
return static::UNIT;
} const UNIT = self::UNIT_SECONDS;
/** /**
* @return int|null un nombre d'unité dont l'heure doit être multiple. par * @var int|null un nombre d'unité dont l'heure doit être multiple. par
* exemple, si l'unité est la minute, une valeur 5 permet d'avoir des heures * exemple, si l'unité est la minute, une valeur 5 permet d'avoir des heures
* qui vont de 5 en 5 minutes (0h00, 0h05, 0h10, etc.) * qui vont de 5 en 5 minutes (0h00, 0h05, 0h10, etc.)
*/ */
protected function STEP(): ?int { const STEP = null;
return static::STEP;
} const STEP = null;
/** @return bool s'il faut garder les heures dans la plage [0, 24h] */ /** @var bool s'il faut garder les heures dans la plage [0, 24h] */
protected function WRAP(): bool { const WRAP = true;
return static::WRAP;
} const WRAP = true;
function __construct($time=null) { function __construct($time=null, ?array $params=null) {
if ($time === null) $seconds = self::seconds_now(); $this->unit = vint::with($params["unit"] ?? static::UNIT);
else $seconds = self::seconds_get($time, $this->UNIT()); $this->step = vint::withn($params["step"] ?? self::STEP);
$this->wrap = vbool::with($params["wrap"] ?? self::WRAP);
if ($time === null) $seconds = self::s_now();
else $seconds = self::s_get($time, $this->unit);
$this->setSeconds($seconds); $this->setSeconds($seconds);
} }
protected int $unit;
protected ?int $step;
protected bool $wrap;
protected int $seconds; protected int $seconds;
function getSeconds(): int { function getSeconds(): int {
@ -135,13 +156,13 @@ class Time {
* @return int le nombre de seconde effectif, après correction * @return int le nombre de seconde effectif, après correction
*/ */
protected function setSeconds(?int $seconds): int { protected function setSeconds(?int $seconds): int {
$this->seconds = $seconds ?? self::seconds_now(); $this->seconds = $seconds ?? self::s_now();
return $this->afterUpdate(); return $this->afterUpdate();
} }
protected function afterUpdate(): int { protected function afterUpdate(): int {
self::seconds_adjust($this->seconds, $this->UNIT(), $this->STEP()); self::s_adjust($this->seconds, $this->unit, $this->step);
if ($this->WRAP()) $this->wrapEnd(); if ($this->wrap) $this->wrapEnd();
return $this->seconds; return $this->seconds;
} }
@ -150,7 +171,7 @@ class Time {
* propice à l'utilisation comme borne inférieure d'une période * propice à l'utilisation comme borne inférieure d'une période
*/ */
function wrapStart(): self { function wrapStart(): self {
self::seconds_wrap_start($this->seconds); self::s_wrap_start($this->seconds);
return $this; return $this;
} }
@ -159,7 +180,7 @@ class Time {
* propice à l'utilisation comme borne supérieure d'une période * propice à l'utilisation comme borne supérieure d'une période
*/ */
function wrapEnd(): self { function wrapEnd(): self {
self::seconds_wrap_end($this->seconds); self::s_wrap_end($this->seconds);
return $this; return $this;
} }
@ -174,11 +195,13 @@ class Time {
"%H", "%h", "%H", "%h",
"%M", "%m", "%M", "%m",
"%S", "%s", "%S", "%s",
"%%",
]; ];
$replaces = [ $replaces = [
sprintf("%02u", $h), strval($h), sprintf("%02u", $h), strval($h),
sprintf("%02u", $m), strval($m), sprintf("%02u", $m), strval($m),
sprintf("%02u", $s), strval($s), sprintf("%02u", $s), strval($s),
"%",
]; ];
return str_replace($searches, $replaces, $format); return str_replace($searches, $replaces, $format);
} }
@ -189,39 +212,51 @@ class Time {
/** @return int le nombre d'unités */ /** @return int le nombre d'unités */
function getu(): int { function getu(): int {
return intdiv($this->seconds, $this->UNIT()); return intdiv($this->seconds, $this->unit);
} }
/** créer une nouvelle heure avec le nombre d'unités spécifiées */ /** créer une nouvelle heure avec le nombre d'unités spécifiées */
function newu(int $count): self { function setu(int $count): self {
$this->setSeconds($count * $this->UNIT()); $this->setSeconds($count * $this->unit);
return $this; return $this;
} }
/** créer une nouvelle heure en ajoutant à cette heure le nombre d'unités spécifiées */ /** créer une nouvelle heure en ajoutant à cette heure le nombre d'unités spécifiées */
function addu(int $count=1): self { function addu(int $count=1): self {
$this->setSeconds($this->seconds + $count * $this->UNIT()); $count *= $this->unit;
if ($this->step !== null) $count *= $this->step;
$this->setSeconds($this->seconds + $count);
return $this; return $this;
} }
/** créer une nouvelle heure en soustrayant à cette heure le nombre d'unités spécifiées */ /** créer une nouvelle heure en soustrayant à cette heure le nombre d'unités spécifiées */
function subu(int $count=1): self { function subu(int $count=1): self {
$this->setSeconds($this->seconds - $count * $this->UNIT()); $count *= $this->unit;
if ($this->step !== null) $count *= $this->step;
$this->setSeconds($this->seconds - $count);
return $this; return $this;
} }
/** créer une nouvelle heure en ajoutant à cette heure l'heure spécifiée */ /** forcer cette heure à l'heure spécifiée */
function add(?self $time): self { function set($time): self {
if ($time === null) $seconds = self::s_now();
else $seconds = self::with($time)->getSeconds();
$this->setSeconds($seconds);
return $this;
}
/** ajouter à cette heure l'heure spécifiée */
function add($time): self {
if ($time !== null) { if ($time !== null) {
$this->setSeconds($this->seconds + $time->getSeconds()); $this->setSeconds($this->seconds + self::with($time)->getSeconds());
} }
return $this; return $this;
} }
/** créer une nouvelle heure en soustrayant à cette heure l'heure spécifiée */ /** soustraire à cette heure l'heure spécifiée */
function sub(?self $time): self { function sub($time): self {
if ($time !== null) { if ($time !== null) {
$this->setSeconds($this->seconds - $time->getSeconds()); $this->setSeconds($this->seconds - self::with($time)->getSeconds());
} }
return $this; return $this;
} }
@ -230,24 +265,24 @@ class Time {
* comparer avec l'heure spécifiée. retourner une valeur négative, égale à * comparer avec l'heure spécifiée. retourner une valeur négative, égale à
* zéro ou positive suivant le résultat de la comparaison * zéro ou positive suivant le résultat de la comparaison
*/ */
function compare(?self $time): int { function compare($time): int {
if ($time === null) return 1; if ($time === null) return 1;
else return $this->seconds - $time->getSeconds(); else return $this->seconds - self::with($time)->getSeconds();
} }
/** /**
* tester si cette heure est avant ou égale à l'heure spécifiée * tester si cette heure est avant ou égale à l'heure spécifiée
*/ */
function before(?self $other): bool { function before($other): bool {
if ($other === null) return false; if ($other === null) return false;
else return $this->seconds <= $other->getSeconds(); else return $this->seconds <= self::with($other)->getSeconds();
} }
/** /**
* tester si cette heure est après ou égale à l'heure spécifiée * tester si cette heure est après ou égale à l'heure spécifiée
*/ */
function after(?self $other): bool { function after($other): bool {
if ($other === null) return true; if ($other === null) return true;
else return $this->seconds >= $other->getSeconds(); else return $this->seconds >= self::with($other)->getSeconds();
} }
} }

55
tests/php/time/HourTest.php
View File

@ -2,24 +2,59 @@
namespace nulib\php\time; namespace nulib\php\time;
use nulib\tests\TestCase; use nulib\tests\TestCase;
use nulib\ValueException;
class HourTest extends TestCase { class HourTest extends TestCase {
function testParse() {
self::assertSame("8h", strval(new Hour("08:00:00")));
self::assertSame("8h", strval(new Hour("8:0")));
self::assertSame("8h", strval(new Hour("8.0")));
self::assertSame("8h", strval(new Hour("8h")));
self::assertSame("8h15", strval(new Hour("08:15:00")));
self::assertSame("8h15", strval(new Hour("8:15")));
self::assertSame("8h15", strval(new Hour("8.15")));
self::assertSame("8h15", strval(new Hour("8h15")));
self::assertSame("8h15", strval(new Hour("08:15:23")));
self::assertSame("8h15", strval(new Hour("8:15.23")));
self::assertSame("8h15", strval(new Hour("8.15.23")));
self::assertSame("8h15", strval(new Hour("8h15.23")));
self::assertSame("31h11", strval(new Hour("30:70:80", [
"wrap" => false,
])));
self::assertSame("7h11", strval(new Hour("30:70:80")));
self::assertException(ValueException::class, function() {
return strval(new Hour("bad format"));
});
}
function testFormat() { function testFormat() {
self::assertSame("0h00", (new Hour(0))->format()); self::assertSame("0h", (new Hour(0))->format());
self::assertSame("0h56", (new Hour(56))->format()); self::assertSame("0h56", (new Hour(56))->format());
self::assertSame("2h00", (new Hour(120))->format()); self::assertSame("2h", (new Hour(120))->format());
self::assertSame("23h59", (new Hour(1439))->format()); self::assertSame("23h59", (new Hour(1439))->format());
self::assertSame("24h00", (new Hour(1440))->format()); self::assertSame("24h", (new Hour(1440))->format());
self::assertSame("0h01", (new Hour(1441))->format()); self::assertSame("0h01", (new Hour(1441))->format());
} }
function testStep() { function testStep() {
$h = new class extends Hour { $h = new Hour(null, [
const STEP = 5; "step" => 5,
}; ]);
$h->newu(10); self::assertSame("0h10", strval($h)); $h->setu(10); self::assertSame("0h10", strval($h));
$h->newu(12); self::assertSame("0h10", strval($h)); $h->setu(12); self::assertSame("0h10", strval($h));
$h->newu(15); self::assertSame("0h15", strval($h)); $h->setu(15); self::assertSame("0h15", strval($h));
$h->newu(17); self::assertSame("0h15", strval($h)); $h->setu(17); self::assertSame("0h15", strval($h));
$h->set("8h");
$h->addu(); self::assertSame("8h05", strval($h));
$h->addu(); self::assertSame("8h10", strval($h));
$h->addu(); self::assertSame("8h15", strval($h));
$h->subu(); self::assertSame("8h10", strval($h));
$h->subu(); self::assertSame("8h05", strval($h));
$h->subu(); self::assertSame("8h", strval($h));
} }
} }

33
tests/php/time/TimeTest.php
View File

@ -2,9 +2,36 @@
namespace nulib\php\time; namespace nulib\php\time;
use nulib\tests\TestCase; use nulib\tests\TestCase;
use nulib\ValueException;
class TimeTest extends TestCase { class TimeTest extends TestCase {
function testGetc() { function testParse() {
self::assertSame("08:00:00", strval(new Time("08:00:00")));
self::assertSame("08:00:00", strval(new Time("8:0")));
self::assertSame("08:00:00", strval(new Time("8.0")));
self::assertSame("08:00:00", strval(new Time("8h")));
self::assertSame("08:15:00", strval(new Time("08:15:00")));
self::assertSame("08:15:00", strval(new Time("8:15")));
self::assertSame("08:15:00", strval(new Time("8.15")));
self::assertSame("08:15:00", strval(new Time("8h15")));
self::assertSame("08:15:23", strval(new Time("08:15:23")));
self::assertSame("08:15:23", strval(new Time("8:15.23")));
self::assertSame("08:15:23", strval(new Time("8.15.23")));
self::assertSame("08:15:23", strval(new Time("8h15.23")));
self::assertSame("31:11:20", strval(new Time("30:70:80", [
"wrap" => false,
])));
self::assertSame("07:11:20", strval(new Time("30:70:80")));
self::assertException(ValueException::class, function() {
return strval(new Time("bad format"));
});
}
function testGetu() {
self::assertSame(0, (new Time(0))->getu()); self::assertSame(0, (new Time(0))->getu());
self::assertSame(86399, (new Time(-1))->getu()); self::assertSame(86399, (new Time(-1))->getu());
self::assertSame(1, (new Time(1))->getu()); self::assertSame(1, (new Time(1))->getu());
@ -13,7 +40,7 @@ class TimeTest extends TestCase {
self::assertSame(0, (new Time(-86400))->getu()); self::assertSame(0, (new Time(-86400))->getu());
} }
function testAddc() { function testAddu() {
$t = new Time(0); $t = new Time(0);
$t->addu(0); self::assertSame(0, $t->getu()); $t->addu(0); self::assertSame(0, $t->getu());
$t->addu(10); self::assertSame(10, $t->getu()); $t->addu(10); self::assertSame(10, $t->getu());
@ -24,7 +51,7 @@ class TimeTest extends TestCase {
$t->addu(-86400); self::assertSame(0, $t->getu()); $t->addu(-86400); self::assertSame(0, $t->getu());
} }
function testSubc() { function testSubu() {
$t = new Time(0); $t = new Time(0);
$t->subu(-86400); self::assertSame(86400, $t->getu()); $t->subu(-86400); self::assertSame(86400, $t->getu());
$t->subu(86400); self::assertSame(0, $t->getu()); $t->subu(86400); self::assertSame(0, $t->getu());