public function Time::getCurrentMicroTime in Drupal 8

Same name and namespace in other branches

1. 9 core/lib/Drupal/Component/Datetime/Time.php \Drupal\Component\Datetime\Time::getCurrentMicroTime()

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()

1 call to Time::getCurrentMicroTime()

Time::getRequestMicroTime in core/lib/Drupal/Component/Datetime/Time.php

Returns the timestamp for the current request with microsecond precision.

File

core/lib/Drupal/Component/Datetime/Time.php, line 65

Class

Time

Provides a class for obtaining system time.

Namespace

Drupal\Component\Datetime

Code

public function getCurrentMicroTime() {
  return microtime(TRUE);
}