Add hour, minute and second parser; Add this, next, last parser for hour, minute and second

Author: bjoern-hempel

README.md

@@ -1,7 +1,9 @@
 # PHP Date Parser
 
-This library parses different strings to DateTime or DateTimeImmutable classes.
-Can be used e.g. excellently for command line arguments and options.
+This library parses various given date and time strings into
+DateTime or DateTimeImmutable classes which return the time
+range. Can be used e.g. excellently for command line
+arguments and options to make database queries with.
 
 ## Installation
 
@@ -57,17 +59,26 @@ $dateParser = (new DateParser('<2023-07-01', 'America/New_York'))->formatTo('Y-m
 
 ### Supported words
 
-| Word         | Description                   |
-|--------------|-------------------------------|
-| `tomorrow`   | The day tomorrow (`'j' + 1`)  |
-| `today`      | The day today (`'j'`)         |
-| `yesterday`  | The day yesterday (`'j' - 1`) |
-| `next-month` | Next month (`'n' + 1`)        |
-| `this-month` | This month (`'n'`)            |
-| `last-month` | Last month (`'n' - 1`)        |
-| `next-year`  | Next year (`'Y' + 1`)         |
-| `this-year`  | This year (`'Y'`)             |
-| `last-year`  | Last year (`'Y' - 1`)         |
+| Word          | Description                   |
+|---------------|-------------------------------|
+| `next-second` | Next second (`'s' + 1`)       |
+| `this-second` | This second (`'s'`)           |
+| `last-second` | Last second (`'s' - 1`)       |
+| `next-minute` | Next minute (`'i' + 1`)       |
+| `this-minute` | This minute (`'i'`)           |
+| `last-minute` | Last minute (`'i' - 1`)       |
+| `next-hour`   | Next hour (`'G' + 1`)         |
+| `this-hour`   | This hour (`'G'`)             |
+| `last-hour`   | Last hour (`'G' - 1`)         |
+| `tomorrow`    | The day tomorrow (`'j' + 1`)  |
+| `today`       | The day today (`'j'`)         |
+| `yesterday`   | The day yesterday (`'j' - 1`) |
+| `next-month`  | Next month (`'n' + 1`)        |
+| `this-month`  | This month (`'n'`)            |
+| `last-month`  | Last month (`'n' - 1`)        |
+| `next-year`   | Next year (`'Y' + 1`)         |
+| `this-year`   | This year (`'Y'`)             |
+| `last-year`   | Last year (`'Y' - 1`)         |
 
 ### Overview
 

bin/header/phpmd

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+
+# ------------
+# This script prints the header for PHPMND - PHP Magic Number Detector
+#
+# @author    Björn Hempel <bjoern@hempel.li>
+# @version   0.1.0 (2022-12-18)
+# ------------
+
+HEADER="PHPMD - PHP Mess Detector"
+COMMAND="$1"
+DESCRIPTION="$2"
+
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+
+eval "$SCRIPT_DIR/global \"$HEADER\" \"$COMMAND\" \"$DESCRIPTION\" \"$DESCRIPTION\""
+RETURN_CODE=$?
+
+exit $RETURN_CODE
+

composer.json

@@ -1,9 +1,9 @@
 {
   "name": "ixnode/php-date-parser",
-  "description": "PHP Date Parser - This library parses different strings to DateTime or DateTimeImmutable classes.",
+  "description": "PHP Date Parser - This library parses various given date and time strings into DateTime or DateTimeImmutable classes which return the time range. Can be used e.g. excellently for command line arguments and options to make database queries with.",
   "type": "library",
   "license": "MIT",
-  "keywords": ["php", "date", "parser", "conversion"],
+  "keywords": ["php", "date", "time", "parser", "conversion", "DateTime", "DateTimeImmutable"],
   "authors": [
     {
       "name": "Björn Hempel",
@@ -22,7 +22,8 @@
     }
   },
   "require": {
-    "php": "^8.2"
+    "php": "^8.2",
+    "ixnode/php-naming-conventions": "^0.1.1"
   },
   "require-dev": {
     "phpunit/phpunit": "^9.5",
@@ -44,7 +45,7 @@
       "@phpmnd:all"
     ],
 
-    "phpmd": "bin/header/phpmnd 'phpmd src,tests text cleancode,codesize,controversial,design,naming,unusedcode' 'all'",
+    "phpmd": "bin/header/phpmd 'phpmd src,tests text cleancode,codesize,controversial,design,naming,unusedcode' 'all'",
 
     "phpunit": "bin/header/phpunit 'phpunit --stop-on-failure tests' 'Unit'",