time_nanosleep(3) [php man page]

TIME_NANOSLEEP(3)							 1							 TIME_NANOSLEEP(3)

time_nanosleep - Delay for a number of seconds and nanoseconds

SYNOPSIS

       mixed time_nanosleep (int  $seconds, int  $nanoseconds)

DESCRIPTION

	Delays program execution for the given number of $seconds and $nanoseconds.

PARAMETERS

	      o $seconds
		- Must be a non-negative integer.

	      o $nanoseconds
		- Must be a non-negative integer less than 1 billion.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

	If the delay was interrupted by a signal, an associative array will be returned with the components:

	      o seconds - number of seconds remaining in the delay

	      o nanoseconds - number of nanoseconds remaining in the delay

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  This  function is now available on Windows plat- |
       |	| forms.					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      time_nanosleep(3) example

	      <?php
	      // Careful! This won't work as expected if an array is returned
	      if (time_nanosleep(0, 500000000)) {
		  echo "Slept for half a second.
";
	      }

	      // This is better:
	      if (time_nanosleep(0, 500000000) === true) {
		  echo "Slept for half a second.
";
	      }

	      // And this is the best:
	      $nano = time_nanosleep(2, 100000);

	      if ($nano === true) {
		  echo "Slept for 2 seconds, 100 microseconds.
";
	      } elseif ($nano === false) {
		  echo "Sleeping failed.
";
	      } elseif (is_array($nano)) {
		  $seconds = $nano['seconds'];
		  $nanoseconds = $nano['nanoseconds'];
		  echo "Interrupted by a signal.
";
		  echo "Time remaining: $seconds seconds, $nanoseconds nanoseconds.";
	      }
	      ?>

SEE ALSO

       sleep(3), usleep(3), time_sleep_until(3), set_time_limit(3).

PHP Documentation Group 													 TIME_NANOSLEEP(3)

MICROTIME(3)								 1							      MICROTIME(3)

microtime - Return current Unix timestamp with microseconds

SYNOPSIS

       mixed microtime ([bool  $get_as_float = false])

DESCRIPTION

       microtime(3)  returns  the  current Unix timestamp with microseconds. This function is only available on operating systems that support the
       gettimeofday() system call.

PARAMETERS

	      o $get_as_float
		- If used and set to TRUE, microtime(3) will return a float instead of a string, as described in the return values section below.

RETURN VALUES

	By default, microtime(3) returns a string in the form "msec sec", where sec is the number of seconds since the Unix epoch (0:00:00 January
       1,1970 GMT), and msec measures microseconds that have elapsed since sec and is also expressed in seconds.

	If  $get_as_float  is  set  to	TRUE, then microtime(3) returns a float, which represents the current time in seconds since the Unix epoch
       accurate to the nearest microsecond.

EXAMPLES

       Example #1

	      Timing script execution with microtime(3)

	      <?php
	      /**
	       * Simple function to replicate PHP 5 behaviour
	       */
	      function microtime_float()
	      {
		  list($usec, $sec) = explode(" ", microtime());
		  return ((float)$usec + (float)$sec);
	      }

	      $time_start = microtime_float();

	      // Sleep for a while
	      usleep(100);

	      $time_end = microtime_float();
	      $time = $time_end - $time_start;

	      echo "Did nothing in $time seconds
";
	      ?>

       Example #2

	      Timing script execution in PHP 5

	      <?php
	      $time_start = microtime(true);

	      // Sleep for a while
	      usleep(100);

	      $time_end = microtime(true);
	      $time = $time_end - $time_start;

	      echo "Did nothing in $time seconds
";
	      ?>

       Example #3

	      microtime(3) and REQUEST_TIME_FLOAT (as of PHP 5.4.0)

	      <?php
	      // Randomize sleeping time
	      usleep(mt_rand(100, 10000));

	      // As of PHP 5.4.0, REQUEST_TIME_FLOAT is available in the $_SERVER superglobal array.
	      // It contains the timestamp of the start of the request with microsecond precision.
	      $time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];

	      echo "Did nothing in $time seconds
";
	      ?>

SEE ALSO

       time(3).

PHP Documentation Group 													      MICROTIME(3)