Función date() de PHP

Funciones de fecha y hora en PHP

Ejemplo

Formatea la fecha y la hora local y devuelve la cadena de fecha formateada:

<?php
// Salida de día
echo date("l") . "<br>";
// Salida de día, fecha, mes, año, hora AM o PM
echo date("l jS \of F Y h:i:s A");
?>

Ejemplo de ejecución

Definición y uso

La función date() formatea la fecha y la hora local y devuelve la cadena de fecha formateada.

Sintaxis

date(format,timestamp);
Parámetros Descripción
format

Requerido. Define el formato de la cadena de salida de la fecha. Se pueden usar los siguientes caracteres:

  • d - Día del mes (de 01 a 31)
  • D - Representación del día de la semana (usando tres letras)
  • j - Día del mes sin cero a la izquierda (de 1 a 31)
  • l (forma minúscula de 'L') - Representación completa del día de la semana
  • N - Número del día de la semana según el formato ISO-8601 (1 para Monday [lunes], 7 para Sunday [domingo])
  • S - Sufijo ordinal del día del mes en inglés (2 caracteres: st, nd, rd o th. Se usa con j)
  • w - Número del día de la semana (0 para Sunday [domingo], 6 para Saturday [sábado])
  • z - Día del año (de 0 a 365)
  • W - Número de la semana del año según el formato ISO-8601 (la semana comienza el lunes)
  • F - Representación completa del mes (de January [enero] a December [diciembre])
  • m - Número del mes (de 01 a 12)
  • M - Representación abreviada del mes (usando tres letras)
  • n - Número del mes sin cero a la izquierda (de 1 a 12)
  • t - Número de días en el mes dado
  • L - ¿Es un año bisiesto? (1 si es bisiesto, 0 en caso contrario)
  • o - Número del año según el estándar ISO-8601
  • Y - Representación de cuatro dígitos del año
  • y - Representación de dos dígitos del año
  • a - La forma minúscula representa: am o pm
  • A - Representación en mayúsculas: AM o PM
  • B - Swatch Internet Time (000 a 999)
  • g - Hora en formato de 12 horas, sin cero a la izquierda (1 a 12)
  • G - Hora en formato de 24 horas, sin cero a la izquierda (0 a 23)
  • h - Hora en formato de 12 horas, con cero a la izquierda (01 a 12)
  • H - Hora en formato de 24 horas, con cero a la izquierda (00 a 23)
  • i - Minutos, con cero a la izquierda (00 a 59)
  • s - Segundos, con cero a la izquierda (00 a 59)
  • u - Microsegundos (nuevo en PHP 5.2.2)
  • e - Identificador de la zona horaria (por ejemplo: UTC, GMT, Atlantic/Azores)
  • I (la forma mayúscula de i) - Si la fecha es en horario de verano (1 si es horario de verano, 0 en caso contrario)
  • O - Diferencia con el tiempo UTC en horas (por ejemplo: +0100)
  • P - Diferencia con el tiempo UTC en horas:minutos (nuevo en PHP 5.1.3)
  • T - Abreviatura de la zona horaria (por ejemplo: EST, MDT)
  • Z - Desplazamiento horario en segundos. El desplazamiento para las zonas oeste de UTC es negativo (-43200 a 50400)
  • c - Fecha en estándar ISO-8601 (por ejemplo: 2013-05-05T16:34:42+00:00)
  • r - Fecha en formato RFC 2822 (por ejemplo: Vie, 12 Abr 2013 12:01:05 +0200)
  • U - Número de segundos transcurridos desde el epoch Unix (1 de enero de 1970 00:00:00 GMT)

Además, también se pueden usar las siguientes constantes predefinidas (disponibles desde PHP 5.1.0):

  • DATE_ATOM - Atom (por ejemplo: 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - HTTP Cookies (por ejemplo: Viernes, 12-Abr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (por ejemplo: 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (por ejemplo: Vie, 12 Abr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (por ejemplo: Viernes, 12-Abr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (por ejemplo: Vie, 12 Abr 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (por ejemplo: Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Igual que DATE_ATOM (desde PHP 5.1.3)
  • DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C - World Wide Web Consortium (por ejemplo: 2013-04-12T15:52:01+00:00)
timestamp Opcional. Especifica un timestamp Unix entero. Por defecto es la hora local actual (time()).

Detalles técnicos

Valor devuelto: Si tiene éxito, devuelve una cadena de fecha formateada; si falla, devuelve E_WARNING y FALSE.
Versión de PHP: 4+
Registro de actualizaciones:

PHP 5.1.0: Se han añadido E_STRICT y E_NOTICE para errores de zona horaria. El rango válido de los timestamps es desde el viernes 13 de diciembre de 1901 a las 20:45:54 GMT hasta el martes 19 de enero de 2038 a las 03:14:07 GMT. En versiones anteriores a 5.1.0, en ciertos sistemas (por ejemplo, Windows) los timestamps están limitados desde el 01-01-1970 hasta el 19-01-2038.

PHP 5.1.1: Se han añadido constantes de formato de fecha/hora estándar, utilizadas para especificar format Parámetros.

Funciones de fecha y hora en PHP