.. include:: ../global.rst

Timing
^^^^^^

:ref:`time-function <time-function>` is the standalone version of the
Job Control :ref:`meta-command <job-control/job meta-commands>`
`time`.

.. _`time-function`:

.. idio:function:: time-function proc [args]


   
   Report the Real, User and System time for the invocation of
   
   proc [args]
   
   The report format is defined in :ref:`TIMEFORMAT <TIMEFORMAT>`.
   
   The result of calling `proc` is returned.
   
   This takes after Bash's time_command
   
   .. seealso:: :ref:`time-function-rus <time-function-rus>`
   


.. _`time-function-rus`:

.. idio:function:: time-function-rus proc [args]


   
   Return a list of the result and Real, User and System time for the
   invocation of
   
   proc [args]
   
   The Real, User and System times are C struct timevals.
   
   This takes after Bash's time_command
   
   .. seealso:: :ref:`time-function <time-function>`
   


.. _`times`:

.. idio:function:: times 


   
   Report the User and System time for the shell and its children


.. _`hms`:

.. idio:function:: hms t


   
   return a normalized `H:MM:SS[.mmm]` for `t`
   
   :param t: time
   :type t: number
   :return: normalised form
   :rtype: string
   
   `H:` and `MM:` are only added if the less significant component
   overruns (ie. is greater than 60).




.. include:: ../commit.rst