81 lines
1.7 KiB
PHP
81 lines
1.7 KiB
PHP
|
<?php
|
||
|
|
declare(strict_types=1);
|
||
|
|
/**
|
||
|
|
*+------------------
|
||
|
|
* madong
|
||
|
|
*+------------------
|
||
|
|
* Copyright (c) https://gitee.com/motion-code All rights reserved.
|
||
|
|
*+------------------
|
||
|
|
* Author: Mr. April (405784684@qq.com)
|
||
|
|
*+------------------
|
||
|
|
* Official Website: http://www.madong.tech
|
||
|
|
*/
|
||
|
|
|
||
|
|
namespace app\schema\request\traits;
|
||
|
|
|
||
|
|
use OpenApi\Attributes as OA;
|
||
|
|
|
||
|
|
trait WithTimeRange
|
||
|
|
{
|
||
|
|
#[OA\Property(
|
||
|
|
property: 'start_time',
|
||
|
|
description: '开始时间 (YYYY-MM-DD HH:mm:ss)',
|
||
|
|
type: 'string',
|
||
|
|
format: 'date-time',
|
||
|
|
example: '2024-01-01 00:00:00',
|
||
|
|
nullable: true
|
||
|
|
)]
|
||
|
|
public ?string $startTime = null;
|
||
|
|
|
||
|
|
#[OA\Property(
|
||
|
|
property: 'end_time',
|
||
|
|
description: '结束时间 (YYYY-MM-DD HH:mm:ss)',
|
||
|
|
type: 'string',
|
||
|
|
format: 'date-time',
|
||
|
|
example: '2024-12-31 23:59:59',
|
||
|
|
nullable: true
|
||
|
|
)]
|
||
|
|
public ?string $endTime = null;
|
||
|
|
|
||
|
|
public function getStartTime(): ?string
|
||
|
|
{
|
||
|
|
return $this->startTime;
|
||
|
|
}
|
||
|
|
|
||
|
|
public function getEndTime(): ?string
|
||
|
|
{
|
||
|
|
return $this->endTime;
|
||
|
|
}
|
||
|
|
|
||
|
|
public function hasTimeRange(): bool
|
||
|
|
{
|
||
|
|
return !empty($this->startTime) && !empty($this->endTime);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 获取时间范围数组
|
||
|
|
*/
|
||
|
|
public function getTimeRange(): array
|
||
|
|
{
|
||
|
|
return [
|
||
|
|
'start' => $this->startTime,
|
||
|
|
'end' => $this->endTime,
|
||
|
|
];
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 验证时间范围是否有效
|
||
|
|
*/
|
||
|
|
public function isValidTimeRange(): bool
|
||
|
|
{
|
||
|
|
if (!$this->hasTimeRange()) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
$start = strtotime($this->startTime);
|
||
|
|
$end = strtotime($this->endTime);
|
||
|
|
|
||
|
|
return $start && $end && $start <= $end;
|
||
|
|
}
|
||
|
|
}
|