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

# idate

(PHP 5, PHP 7, PHP 8)

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

### Descripción

function 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

- DateTimeInterface::format() - Retorna una fecha formateada según el formato proporcionado
- date() - Da formato a una marca de tiempo de Unix (Unix timestamp)
- getdate() - Devuelve la fecha/hora
- time() - Devuelve el timestamp UNIX actual

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open