InteractsWithTime trait

use Illuminate\Support\InteractsWithTime;

class MyService
{
    use InteractsWithTime;

    public function scheduleAt(\DateTime $target): int
    {
        return $this->secondsUntil($target); // 從現在到 $target 的秒數
    }
}

$seconds = $this->secondsUntil(now()->addMinutes(5)); // 300
$seconds = $this->secondsUntil(now()->subMinutes(5)); // 0（過去為 0）
$seconds = $this->secondsUntil(60);                   // 60（整數直接視為秒數）

$timestamp = $this->availableAt(60);              // 60 秒後的 UNIX 時間戳記
$timestamp = $this->availableAt(new \DateTime('2026-12-31')); // 指定日期時間的 UNIX 時間戳記
$timestamp = $this->availableAt(new \DateInterval('PT5M'));    // 5 分後

$delay = $this->parseDateInterval(new \DateInterval('P1D')); // 明天的 Carbon
$delay = $this->parseDateInterval(now()->addHour());         // DateTimeInterface 原樣回傳
$delay = $this->parseDateInterval(3600);                     // 3600（整數原樣回傳）

$now = $this->currentTime(); // int（UNIX 時間戳記）

$start = microtime(true);

// ... 處理 ...

echo $this->runTimeForHumans($start); // 例：「42.15ms」或「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);

        // 以 $seconds（int）儲存至實際儲存位置
        $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);

        // ... 處理 ...

        $this->info("完成：{$this->runTimeForHumans($start)}");
    }
}

// 於測試中推進時間（Testing\Concerns\InteractsWithTime）
$this->travel(5)->days();
$this->travelTo(now()->addMonth());
$this->travelBack();