Merge pull request #6426 from kenjis/fix-docs-date_helper

docs: update date helper

Author: kenjis

user_guide_src/source/helpers/date_helper.rst

@@ -9,6 +9,8 @@ dates.
     :local:
     :depth: 2
 
+.. note:: Many functions previously found in the CodeIgniter 3 ``date_helper`` have been moved to the :doc:`Time <../libraries/time>` class in CodeIgniter 4.
+
 Loading this Helper
 ===================
 
@@ -27,17 +29,18 @@ The following functions are available:
     :returns:    UNIX timestamp
     :rtype:    int
 
-    Returns the current time as a UNIX timestamp, referenced either to your server's
-    local time or any PHP supported timezone, based on the "time reference" setting
-    in your config file. If you do not intend to set your master time reference to
-    any other PHP supported timezone (which you'll typically do if you run a site
-    that lets each user set their own timezone settings) there is no benefit to using
-    this function over PHP's ``time()`` function.
+    .. note:: It is recommended to use the :doc:`Time <../libraries/time>` class instead. Use ``Time::now()->getTimestamp()`` to get the current UNIX timestamp.
+
+    If a timezone is not provided, it will return the current UNIX timestamp by ``time()``.
 
     .. literalinclude:: date_helper/002.php
 
-    If a timezone is not provided, it will return ``time()`` based on the
-    **time_reference** setting.
+    If any PHP supported timezone is provided, it will return a timestamp that is offset by the time difference. It is not the same as the current UNIX timestamp.
+
+    If you do not intend to set your master time reference to
+    any other PHP supported timezone (which you'll typically do if you run a site
+    that lets each user set their own timezone settings) there is no benefit to using
+    this function over PHP's ``time()`` function.
 
 .. php:function:: timezone_select([$class = '', $default = '', $what = \DateTimeZone::ALL, $country = null])
 
@@ -48,11 +51,8 @@ The following functions are available:
     :returns:    Preformatted HTML select field
     :rtype:    string
 
-    Generates a `select` form field of available timezones (optionally filtered by `$what` and `$country`).
+    Generates a `select` form field of available timezones (optionally filtered by ``$what`` and ``$country``).
     You can supply an option class to apply to the field to make formatting easier, as well as a default
     selected value.
 
     .. literalinclude:: date_helper/003.php
-
-Many functions previously found in the CodeIgniter 3 ``date_helper`` have been moved to the ``I18n``
-module in CodeIgniter 4.

user_guide_src/source/helpers/date_helper/002.php

@@ -1,3 +1,3 @@
 <?php
 
-echo now('Australia/Victoria');
+echo now();