PHP | Función idate()

La función idate() es una función incorporada en PHP que se usa para formatear una hora/fecha local como un número entero. El formato de $y la marca de tiempo de $se envían como parámetros a la función idate() y devuelve un número entero formateado de acuerdo con el formato especificado utilizando la marca de tiempo dada. A diferencia de la función date(), idate() acepta solo un carácter en el parámetro de formato.

Sintaxis:

int idate( $format, $timestamp )

Parámetros: esta función acepta dos parámetros, como se mencionó anteriormente y se describe a continuación:

• $formato: Es un parámetro obligatorio que especifica el formato del resultado. El parámetro de formato puede tener los siguientes valores:
  • B – Ritmo de muestra/Hora de Internet
  • d – Día del mes
  • h – Hora (formato de 12 horas)
  • H – Hora (formato de 24 horas)
  • yo – Minutos
  • I: devuelve 1 si DST (horario de verano) está activado, 0 en caso contrario
  • L – devuelve 1 para año bisiesto, 0 en caso contrario
  • m – Número de mes
  • s – Segundos
  • t – Días en el mes actual
  • U: segundos desde la época de Unix (1 de enero de 1970 00:00:00 GMT)
  • w – Día de la semana (Domingo=0)
  • W: número de semana ISO-8601 del año (la semana comienza el lunes)
  • y – Año (1 o 2 dígitos)
  • Y – Año (4 dígitos)
  • z – Día del año
  • Z – Compensación de zona horaria en segundos
• $timestamp: es un parámetro opcional que especifica una marca de tiempo de Unix que representa la fecha/hora a formatear.

Valor devuelto: Devuelve un valor entero de acuerdo con el formato especificado usando la marca de tiempo dada.

Excepciones:

• La función idate() arroja un E_NOTICE en cada llamada a una fecha/hora si la zona horaria no es válida.
• La función idate() arroja un mensaje E_STRICT o E_WARNING si usa la configuración del sistema o la variable de entorno TZ.

Los siguientes programas ilustran la función idate() en PHP:

Programa 1:

<?php
  
// Formatting local date/time as Year
echo idate("Y") . "<br>";
  
// Formatting local date/time as Hour(24 hr format)
echo idate("H") . "<br>";
  
// Formatting local date/time as Minutes
echo idate("i") . "<br>";
  
// Formatting local date/time as day of the year 
echo idate("z") . "<br>";
?>

2018
11
22
238

Programa 2:

<?php
  
// Parsing English textual datetime description into a Unix timestamp
$timestamp = strtotime('24th August 2018'); 
  
// Formatting local date/time as Year
echo idate('Y', $timestamp);
?>

2018

Artículos relacionados:

• PHP | función de tiempo()
• PHP | Función strptime()

Referencia: http://php.net/manual/en/function.idate.php