Add description of the totable() method for an interval object; correct the list of the datetime functions and methods

Part of #2835

Author: veod32

doc/reference/reference_lua/datetime.rst

@@ -28,15 +28,26 @@ Below is a list of the ``datetime`` module functions and methods.
         *   -   :ref:`format() <datetime-format>`
             -   Convert the standard presentation of a ``datetime`` object into a formatted string.
 
-        *   -   :ref:`totable() <datetime-totable>`
+        *   -   :ref:`datetime_object:totable() <datetime-totable>`
             -   Convert the information from a ``datetime`` object into the table format.
 
         *   -   :ref:`set() <datetime-set>`
             -   Update the field values in the existing ``datetime`` object.
 
+        *   -   :ref:`parse() <datetime-parse>`
+            -   Convert an input string with the date and time information into a ``datetime`` object.
+
+        *   -   :ref:`add() <datetime-add>`
+            -   Modify an existing datetime object by adding ... [TBD]
+
+        *   -   :ref:`sub() <datetime-sub>`
+            -   Modify an existing datetime object by subtracting ... [TBD]
+
         *   -   :doc:`./datetime/interval_new`
             -   Create an ``interval`` object from a table of time units.
 
+        *   -   :ref:`interval_object:totable() <interval-totable>`
+            -   Convert the information from an ``interval`` object into the table format.
 
 ..  toctree::
     :hidden:

doc/reference/reference_lua/datetime/datetime_object.rst

@@ -11,7 +11,7 @@ datetime_object
 
     ..  method:: totable()
 
-        Convert the information from the ``datetime`` object into the table format.
+        Convert the information from a ``datetime`` object into the table format.
         Resulting table has the following fields:
 
         ..  container:: table
@@ -245,7 +245,7 @@ datetime_object
 
     ..  _datetime-add:
 
-    ..  method:: add( { input[, adjust ] } )
+    ..  method:: add( input[, { adjust } ] )
 
         Modify an existing datetime object by adding values of the input argument. [TBD]
 

doc/reference/reference_lua/datetime/interval_new.rst

@@ -3,22 +3,22 @@
 datetime.interval.new()
 =======================
 
-..  function:: datetime.interval.new( [{ units }] )
+..  function:: datetime.interval.new( [{ input }] )
 
     Since :doc:`2.10.0 </release/2.10.0>`.
 
     Create an object of the :ref:`interval type <index-box_interval>` from a table of time units.
     See :ref:`description of units <interval-new-args>` and :ref:`examples <interval-new-example>` below.
 
-    :param table units: Table of :ref:`time units <interval-new-args>`. For all possible time units, the values are not restricted.
+    :param table input: Table with :ref:`time units and parameters<interval-new-args>`. For all possible time units, the values are not restricted.
                                 If an empty table or no arguments are passed, the ``interval`` object with the default value ``0 seconds`` is created.
 
     :return: :doc: interval object
     :rtype: cdata
 
     ..  _interval-new-args:
 
-    **Possible input time units for ``datetime.interval.new()**
+    **Possible input time units and parameters for ``datetime.interval.new()**
 
     ..  container:: table
 
@@ -68,10 +68,15 @@ datetime.interval.new()
                 -   0
 
             *   -   year
-                -   Year
+                -   Year. ... [TBD year range and huge year number support]
                 -   number
                 -   0
 
+            *   -   adjust
+                -   ... [TBD]
+                -   string
+                -   'none'
+
     ..  _interval-new-example:
 
     **Examples:**

doc/reference/reference_lua/datetime/interval_object.rst

@@ -0,0 +1,75 @@
+.. _inverval_object:
+
+inverval_object
+===============
+
+..  class:: interval_object
+
+    Since :doc:`2.10.0 </release/2.10.0>`.
+
+    ..  _inverval-totable:
+
+    ..  method:: totable()
+
+        Convert the information from an ``interval`` object into the table format.
+        Resulting table has the following fields:
+
+        ..  container:: table
+
+            ..  list-table::
+                :widths: 30 70
+                :header-rows: 1
+
+                *   -   Field name
+                    -   Description
+
+                *   -   nsec
+                    -   Nanosecods
+
+                *   -   sec
+                    -   Seconds
+
+                *   -   min
+                    -   Minutes
+
+                *   -   hour
+                    -   Hours
+
+                *   -   day
+                    -   Day number
+
+                *   -   month
+                    -   Month number
+
+                *   -   year
+                    -   Year
+
+                *   -   week
+                    -   Week number
+
+                *   -   adjust
+                    -   ... [TBD]
+
+        :return: table with the date and time parameters
+        :rtype: table
+
+        **Example:**
+
+        ..  code-block:: tarantoolsession
+
+            tarantool> iv = datetime.interval.new{month = 1, adjust = 'last'}
+            ---
+            ...
+
+            tarantool> iv:totable()
+            ---
+            - adjust: last
+              sec: 0
+              nsec: 0
+              day: 0
+              week: 0
+              hour: 0
+              month: 1
+              year: 0
+              min: 0
+            ...

doc/reference/reference_lua/datetime/new.rst

@@ -63,7 +63,7 @@ datetime.new()
                 -   1
 
             *   -   year
-                -   Year
+                -   Year. ... [TBD year range and huge year number support]
                 -   number
                 -   1970