minor symfony#10432 [Bridge/PhpUnit] Add documentation about mocking date() in ClockMock (Dominic Tubach)

This PR was submitted for the master branch but it was merged into the 4.2 branch instead (closes symfony#10432).

Discussion
----------

[Bridge/PhpUnit] Add documentation about mocking date() in ClockMock

Fixes symfony#10287.

Commits
-------

51a3924 [Bridge/PhpUnit] Add documentation about mocking date() in ClockMock

Author: xabbuh

components/phpunit_bridge.rst

@@ -330,7 +330,10 @@ Clock Mocking
 
 The :class:`Symfony\\Bridge\\PhpUnit\\ClockMock` class provided by this bridge
 allows you to mock the PHP's built-in time functions ``time()``,
-``microtime()``, ``sleep()`` and ``usleep()``.
+``microtime()``, ``sleep()`` and ``usleep()``. Additionally the function
+``date()`` is mocked so it uses the mocked time if no timestamp is specified.
+Other functions with an optional timestamp parameter that defaults to ``time()``
+will still use the system time instead of the mocked time.
 
 To use the ``ClockMock`` class in your test, add the ``@group time-sensitive``
 annotation to its class or methods. This annotation only works when executing