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();