Time\Duration::fromSeconds

(PHP 8 >= 8.6.0)

Time\Duration::fromSeconds — Crea una duración a partir de un número de segundos y nanosegundos

Descripción

public static function Time\Duration::fromSeconds(int $seconds, int $nanoseconds = 0): Time\Duration

Crea una duración no negativa de seconds segundos más nanoseconds nanosegundos.

Parámetros

seconds: El número de segundos enteros. Debe ser mayor o igual que 0.
nanoseconds: La fracción de segundo, en nanosegundos. Debe estar entre 0 y 999999999, ambos inclusive.

Valores devueltos

Devuelve un nuevo objeto Time\Duration.

Errores/Excepciones

Si seconds es negativo, se lanza una ValueError.
Si nanoseconds es negativo, se lanza una ValueError.
Si nanoseconds es mayor o igual que 1000000000, se lanza una ValueError.
Si la duración resultante excede la longitud máxima de una duración, se lanza una Time\TimeException.

Ejemplos

Ejemplo #1 Ejemplo de Time\Duration::fromSeconds()

<?php
var_dump(\Time\Duration::fromSeconds(90));
var_dump(\Time\Duration::fromSeconds(1, 500_000_000));

try {
    \Time\Duration::fromSeconds(0, 1_000_000_000);
} catch (ValueError $e) {
    echo $e->getMessage(), PHP_EOL;
}

El ejemplo anterior mostrará:

object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(90)
  ["nanoseconds"]=>
  int(0)
  ["negative"]=>
  bool(false)
}
object(Time\Duration)#2 (3) {
  ["seconds"]=>
  int(1)
  ["nanoseconds"]=>
  int(500000000)
  ["negative"]=>
  bool(false)
}
Time\Duration::fromSeconds(): Argument #2 ($nanoseconds) must be less than 1_000_000_000

Véase también

Time\Duration::fromNanoseconds() - Crea una duración a partir de un número de nanosegundos
Time\Duration::fromMicroseconds() - Crea una duración a partir de un número de microsegundos
Time\Duration::fromMilliseconds() - Crea una duración a partir de un número de milisegundos
Time\Duration::fromMinutes() - Crea una duración a partir de un número de minutos
Time\Duration::fromHours() - Crea una duración a partir de un número de horas
Time\Duration::fromIso8601DurationString() - Crea una duración a partir de una cadena de duración ISO 8601

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.