(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 un timestamp
Unix de tipo entero 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().
Devuelve un int en caso de éxito, o false si ocurre un error.
Dado que idate() siempre devuelve un entero
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 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()
| 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);
?>