public function TimeMachine::getCurrentMicroTime in Preview Link 8

Returns the current system time with microsecond precision.

This method should be used to obtain the current system time, with microsecond precision, at the time the method was called.

This method can replace many instances of

$microtime = microtime();
$microtime = microtime(TRUE);

with

$request_time = \Drupal::time()
  ->getCurrentMicroTime();

or the equivalent using the injected service.

This method should only be used when the current system time is actually needed, such as with timers or time interval calculations. If only the time at the start of the request and microsecond precision is needed, use TimeInterface::getRequestMicroTime().

Using the time service, rather than other methods, is especially important when creating tests, which require predictable timestamps.

Return value

float A Unix timestamp with a fractional portion.

Overrides TimeInterface::getCurrentMicroTime

See also

\Drupal\Component\Datetime\TimeInterface::getRequestTime()

\Drupal\Component\Datetime\TimeInterface::getRequestMicroTime()

\Drupal\Component\Datetime\TimeInterface::getCurrentTime()

File

tests/modules/preview_link_test/src/TimeMachine.php, line 54

Class

TimeMachine

Service used to simulate time.

Namespace

Drupal\preview_link_test

Code

public function getCurrentMicroTime() {
  return (double) $this
    ->getTime()
    ->getTimestamp();
}