初始化本地仓库

2026-08-31 11:33:59 +08:00
commit 663f74b633
2390 changed files with 402918 additions and 0 deletions
@@ -0,0 +1,80 @@
+<?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;
+    }
+}