feat: add firstSecond() and lastSecond()

.vscode/RockMigrations.code-snippets

@@ -58,6 +58,17 @@
     ],
     "description": "Add a text field via RockMigrations"
   },
+  "rmf-integer": {
+    "prefix": "rmf-integer",
+    "body": [
+      "$1 => [",
+      "  'type' => 'integer',",
+      "  'label' => '$3',",
+      "  'icon' => 'list-ol',",
+      "],"
+    ],
+    "description": "Add an integer field via RockMigrations"
+  },
   "rmf-url": {
     "prefix": "rmf-url",
     "body": [

RockMigrations.module.php

@@ -2,6 +2,7 @@
 
 namespace ProcessWire;
 
+use DateTime;
 use DirectoryIterator;
 use ProcessWire\WireArray as ProcessWireWireArray;
 use RockMatrix\Block as RockMatrixBlock;
@@ -64,7 +65,7 @@ public static function getModuleInfo()
   {
     return [
       'title' => 'RockMigrations',
-      'version' => '2.16.0',
+      'version' => '2.17.0',
       'summary' => 'The Ultimate Automation and Deployment-Tool for ProcessWire',
       'autoload' => 2,
       'singular' => true,
@@ -1441,6 +1442,17 @@ public function fireOnRefresh($module, $method = null, $priority = [])
     return;
   }
 
+  /**
+   * Get first second of year/month/day
+   */
+  public function firstSecond($year, $month = null, $day = null): int
+  {
+    $date = new DateTime();
+    $date->setDate($year, $month ?: 1, $day ?: 1);
+    $date->setTime(0, 0, 0);
+    return $date->getTimestamp();
+  }
+
   /**
    * Run migrations during development on every request
    * This is handy to code rapidly and get instant output via RockFrontend's
@@ -2082,6 +2094,21 @@ public function lastmodified()
     return $last;
   }
 
+  /**
+   * Get last second of year/month/day
+   */
+  public function lastSecond($year, $month = null, $day = null): int
+  {
+    $date = new DateTime();
+    $date->setDate($year, $month ?: 1, $day ?: 1);
+    $date->setTime(0, 0, 0);
+    if ($day) $date->modify("+1 day");
+    elseif ($month) $date->modify("+1 month");
+    elseif ($year) $date->modify("+1 year");
+    $date->modify("-1 second");
+    return $date->getTimestamp();
+  }
+
   /**
    * Load files on demand on local installation
    *