array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.idate.php', 1 => 'idate', 2 => 'Formatea una parte de la hora/fecha local como un entero', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Funciones de Fecha/Hora', ), 'prev' => array ( 0 => 'function.gmstrftime.php', 1 => 'gmstrftime', ), 'next' => array ( 0 => 'function.localtime.php', 1 => 'localtime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/datetime/functions/idate.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

idate

(PHP 5, PHP 7, PHP 8)

idate — Formatea una parte de la hora/fecha local como un entero

Descripción

idate(string $format, ?int $timestamp = null): int|false

Devuelve un número formateado según el formato format dado con el timestamp entero dado timestamp o la hora actual si no se da un timestamp. En otras palabras, timestamp es opcional y el valor por omisión es el valor devuelto por time().

A diferencia de la función date(), idate() acepta solo un carácter como parámetro format.

Parámetros

format

Los siguientes caracteres son reconocidos en el string del parámetro format
Caracteres de format Descripción
B Tiempo Internet Swatch Beat
d El día del mes
h Hora (formato 12 horas)
H Hora (formato 24 horas)
i Minutos
I(i, en mayúscula) Devuelve 1 si el horario de verano está activado, 0 en caso contrario
L(l, en mayúscula) Devuelve 1 para un año bisiesto, 0 en caso contrario
m Número del mes
N Día de la semana ISO-8601 (1 para el lunes a 7 para el domingo)
o Año ISO-8601 (4 dígitos)
s Segundos
t Día del mes actual
U Segundos desde la época Unix - 1 de Enero de 1970 00:00:00 UTC - esto es lo mismo que la función time()
w Día de la semana (0 para Domingo)
W El número de semana del año; según ISO-8601, las semanas comienzan el Lunes
y Año en 1 o 2 dígitos, ver la nota más abajo
Y Año en 4 dígitos
z Día del año
Z Desplazamiento horario, en segundos

timestamp

El parámetro opcional timestamp es un timestamp Unix de tipo int que por omisión es la hora actual local si timestamp es omitido o null. En otras palabras, es por omisión el valor de la función time().

Valores devueltos

Devuelve un int en caso de éxito, o false si ocurre un error.

Dado que idate() siempre devuelve un int y no puede comenzar con 0, idate() puede devolver menos dígitos de los que se podrían esperar. Ver el ejemplo a continuación.

Errores/Excepciones

Cada llamada a una función de fecha/hora generará un diagnóstico de tipo E_WARNING si la zona horaria no es válida. Ver también date_default_timezone_set()

Historial de cambios

Versión Descripción
8.2.0 Añade los caracteres de formato N (día de la semana ISO-8601) y o (año ISO-8601).
8.0.0 timestamp ahora es nullable.

Ejemplos

Ejemplo #1 Ejemplo con idate()

<?php
$timestamp = strtotime('1st January 2004'); // 1072915200

// esto muestra el año en dos dígitos
// sin embargo, dado que este dígito comenzará con "0",
// solo "4" será mostrado
echo idate('y', $timestamp) . "\n";

$timestamp = strtotime('1st January 2024'); // 1704067200
echo idate('y', $timestamp);

El ejemplo anterior mostrará:

4
24

Ver también