InteractsWithTime-Trait

use Illuminate\Support\InteractsWithTime;

class MyService
{
    use InteractsWithTime;

    public function scheduleAt(\DateTime $target): int
    {
        return $this->secondsUntil($target); // Sekunden von jetzt bis $target
    }
}

$seconds = $this->secondsUntil(now()->addMinutes(5)); // 300
$seconds = $this->secondsUntil(now()->subMinutes(5)); // 0 (Vergangenheit ergibt 0)
$seconds = $this->secondsUntil(60);                   // 60 (Integer wird als Sekunden übernommen)

$timestamp = $this->availableAt(60);              // UNIX-Zeitstempel 60 Sekunden voraus
$timestamp = $this->availableAt(new \DateTime('2026-12-31')); // UNIX-Zeitstempel des angegebenen Datums
$timestamp = $this->availableAt(new \DateInterval('PT5M'));    // 5 Minuten voraus

$delay = $this->parseDateInterval(new \DateInterval('P1D')); // Carbon für morgen
$delay = $this->parseDateInterval(now()->addHour());         // DateTimeInterface bleibt gleich
$delay = $this->parseDateInterval(3600);                     // 3600 (Integer bleibt gleich)

$now = $this->currentTime(); // int (UNIX-Zeitstempel)

$start = microtime(true);

// ... Verarbeitung ...

echo $this->runTimeForHumans($start); // z. B. "42.15ms" oder "1s 234ms"

$elapsed = $this->runTimeForHumans($start, $end);

use Illuminate\Support\InteractsWithTime;

class MyStore
{
    use InteractsWithTime;

    public function put(string $key, mixed $value, mixed $ttl): void
    {
        $seconds = $this->secondsUntil($ttl);

        // Als $seconds (int) im tatsächlichen Storage speichern
        $this->storage[$key] = [
            'value'      => $value,
            'expires_at' => $this->availableAt($ttl),
        ];
    }
}

use Illuminate\Console\Command;
use Illuminate\Support\InteractsWithTime;

class ProcessDataCommand extends Command
{
    use InteractsWithTime;

    public function handle(): void
    {
        $start = microtime(true);

        // ... Verarbeitung ...

        $this->info("Fertig: {$this->runTimeForHumans($start)}");
    }
}

// Zeit im Test vorspulen (Testing\Concerns\InteractsWithTime)
$this->travel(5)->days();
$this->travelTo(now()->addMonth());
$this->travelBack();