# idate

(PHP 5, PHP 7, PHP 8)

idate — Formatea una fecha/hora local como un entero

### Descripción

idate(string `$format`, int `$timestamp` = time()): int

Devuelve un número formateado según la cadena de formato dada usando la marca de tiempo `timestamp` de tipo entero dado o el momento local actual si no se da la marca de tiempo. En otras palabras, `timestamp` es opcional y su valor por defecto es el de time().

A diferencia de date(), idate() acepta un sólo carácter en el parámetro `format`.

### Parámetros

`format`

  Los siguientes caracteres son reconocidos por el parámetro de cadena `format`
  Caracter `format` | Descripción
  --- | ---
  `B` | Swatch Beat/Hora Internet
  `d` | Día del mes
  `h` | Hora (formato de 12 horas)
  `H` | Hora (formato de 24 horas)
  `i` | Minutos
  `I` (i mayúscula) | devuelve `1` si el horario de verano (DST) está activado, `0` si no
  `L` (l mayúscula) | devuelve `1` para años bisiestos, `0` si no
  `m` | Número de mes
  `s` | Segundos
  `t` | Días en el mes actual
  `U` | Segundos desde la Época Unix - 1 de enero de 1970 00:00:00 UTC - esto es lo mismo que en time()
  `w` | Día de la semana (`0` para Domingo)
  `W` | Número del mes del año ISO-8601, las semanas comienzan en Lunes
  `y` | Año (1 ó 2 dígitos - comprobar la anotación de abajo)
  `Y` | Año (4 dígitos)
  `z` | Día del año
  `Z` | Ínidce de la zona horaria 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().

### Valores devueltos

Devuelve un integer.

Ya que idate() devuelve siempre un integer y como éste nunca puede empezar por un "0", idate() puede devolver menos dígitos de los que se esperarían. Vea el ejemplo de abajo.

### Errores/Excepciones

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()

### Historial de cambios

Versión | Descripción
--- | ---
5.1.0 | Ahora muestra un error `E_STRICT` y `E_NOTICE` cuando ocurren errores con zonas horarias.

### Ejemplos

Ejemplo #1 Ejemplo de idate()

`<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// esto imprime el año en un formato de dos dígitos
// sin embargo, ya que éste podría empezar con un "0",
// sólo se imprime "4"
echo idate('y', $timestamp);
?>`

### Ver también

- date() - Dar formato a la fecha/hora local
- getdate() - Obtener información de la fecha/hora
- time() - Devuelve la fecha Unix actual