(PHP 5, PHP 7, PHP 8)
idate — Formatea una parte de la hora/fecha local como un entero
idate() devuelve un número formateado con el
formato format
y que representa el timestamp
timestamp
o la hora actual si
timestamp
es omitido.
En otras palabras, el parámetro timestamp
es opcional
y el valor por omisión es el valor devuelto por la función time().
A diferencia de la función date(), idate()
acepta solo un carácter como parámetro format
.
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 una marca temporal de Unix de tipo
integer que por defecto es la hora local si no se proporciona
ningún valor a timestamp
. En otras palabras,
es de forma predeterminada el valor de la función time().
Devuelve un int en caso de éxito, o false
en caso de 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.
Cada vez que se llame a una función de fecha/hora se generará un E_NOTICE
si la zona horaria no es válida, y/o un mensaje E_STRICT
o E_WARNING
si se emplea la configuración del sistema o la variable global
TZ. Véase también date_default_timezone_set()
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.
|
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);
?>