docs: add user guide for isPast() and isFuture()

Author: datamweb

user_guide_src/source/changelogs/v4.7.0.rst

@@ -181,6 +181,7 @@ Libraries
 - **Image:** Added ``ImageMagickHandler::clearMetadata()`` method to remove image metadata for privacy protection.
 - **ResponseTrait:** Added ``paginate``` method to simplify paginated API responses. See :ref:`ResponseTrait::paginate() <api_response_trait_paginate>` for details.
 - **Time:** added methods ``Time::addCalendarMonths()`` and ``Time::subCalendarMonths()``
+- **Time:** Added ``Time::isPast()`` and ``Time::isFuture()`` convenience methods. See :ref:`isPast <time-comparing-two-times-isPast>` and :ref:`isFuture <time-comparing-two-times-isFuture>` for details.
 
 Commands
 ========

user_guide_src/source/libraries/time.rst

@@ -393,6 +393,30 @@ Works exactly the same as ``isBefore()`` except checks if the time is after the
 
 .. literalinclude:: time/037.php
 
+.. _time-comparing-two-times-isPast:
+
+isPast()
+--------
+
+.. versionadded:: 4.7.0
+
+Determines if the current instance's time is in the past, relative to "now".
+It returns a boolean true/false::
+
+.. literalinclude:: time/043.php
+
+.. _time-comparing-two-times-isFuture:
+
+isFuture()
+----------
+
+.. versionadded:: 4.7.0
+
+Determines if the current instance's time is in the future, relative to "now".
+It returns a boolean true/false::
+
+.. literalinclude:: time/044.php
+
 .. _time-viewing-differences:
 
 Viewing Differences

user_guide_src/source/libraries/time/043.php

@@ -0,0 +1,6 @@
+<?php
+
+use CodeIgniter\I18n\Time;
+
+$time = Time::parse('yesterday');
+echo $time->isPast(); // true

user_guide_src/source/libraries/time/044.php

@@ -0,0 +1,6 @@
+<?php
+
+use CodeIgniter\I18n\Time;
+
+$time = Time::parse('tomorrow');
+echo $time->isFuture(); // true