Documentación offline PHP master

DateTimeInterface::getTimestamp

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

DateTimeInterface::getTimestamp

DateTimeImmutable::getTimestamp

DateTime::getTimestamp

date_timestamp_get

Obtiene el timestamp Unix

Descripción#

Estilo orientado a objetos

public DateTimeInterface::getTimestamp(): int
```php

```php
public DateTimeImmutable::getTimestamp(): int
public DateTime::getTimestamp(): int
```php

Estilo procedimental

```php
date_timestamp_get(DateTimeInterface $object): int

Obtiene el timestamp Unix.

Parámetros#

Esta función no contiene ningún parámetro.

Valores devueltos#

Devuelve el timestamp Unix que representa la fecha.

Errores/Excepciones#

Si el sello de tiempo no puede ser representado como un int, se lanza una DateRangeError. Anterior a PHP 8.3.0, se lanzaba una ValueError. Y anterior a PHP 8.0.0, se devolvía false en este caso. Sin embargo, el sello de tiempo puede ser obtenido como un string utilizando DateTimeInterface::format con el formato U.

Historial de cambios#

Versión Descripción
8.3.0 La excepción de fuera de rango ahora es una DateRangeError.
8.0.0 Estas funciones ya no devuelven false en caso de fallo.

Ejemplos#

Ejemplo con DateTime::getTimestamp

Estilo orientado a objetos

<?php
$date = new DateTimeImmutable();
echo $date->getTimestamp();

Resultado del ejemplo anterior es similar a:

1272509157

Estilo procedimental

<?php
$date = date_create();
echo date_timestamp_get($date);

Resultado del ejemplo anterior es similar a:

1272509157

Para obtener el sello de tiempo con precisión en milisegundos o microsegundos, es posible utilizar la función DateTimeInterface::format.

Obtención del sello de tiempo con precisión en milisegundos y microsegundos

Estilo orientado a objetos

<?php
$date = new DateTimeImmutable();
$milli = (int) $date->format('Uv'); // Timestamp en milisegundos
$micro = (int) $date->format('Uu'); // Timestamp en microsegundos

echo $milli, "\n", $micro, "\n";

Resultado del ejemplo anterior es similar a:

1674057635586
1674057635586918

Véase también#

DateTime::setTimestamp

DateTimeImmutable::setTimestamp

DateTimeInterface::format

DateTimeInterface::getMicrosecond