PHP date()Función

PHP Date/TimeManual de referencia PHP Date/Time

Ejemplos

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

<?php //Establecer zona horaria date_default_timezone_set("PRC"); //Imprimir la hora actual. PHP_EOL es un salto de línea, compatible con diferentes sistemas echo date("Y-m-d H:i:s") . PHP_EOL; echo date("Y (año) m (mes) d (día) H (hora) i (minuto) s (segundo)") . PHP_EOL; //Tiempo especificado $time = strtotime("2018-01-18 08:08:08"); //Convertir la fecha especificada en una marca de tiempo (timestamp) echo date("Y-m-d H:i:s", $time) . PHP_EOL; ?>

La salida es la siguiente:

2018-01-31 22:09:35
2018 年 01 月 31 日 22 点 09 分 35 秒
2018-01-18 08:08:08

Definición y uso

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

Sintaxis

date(format,timestamp);

Devuelve una cadena generada a partir del timestamp entero según la cadena de formato dada. Si no se proporciona un timestamp, se usa la hora local actual. En otras palabras, timestamp es opcional y su valor predeterminado es time().


Parámetros Descripción
format Obligatorio. Especifica el formato de la cadena de fecha de salida. Se pueden usar los siguientes caracteres:
  • d - Día del mes (de 01 a 31)
  • D - Representación textual del día de la semana (tres letras)
  • j - Día del mes sin ceros iniciales (1 a 31)
  • l (minúscula de 'L') - Representación textual completa del día de la semana
  • N - Representación numérica ISO-8601 del día de la semana (1 para Monday [lunes], 7 para Sunday [domingo])
  • S - Sufijo ordinal en inglés del día del mes (2 caracteres: st, nd, rd o th. Se usa con j)
  • w - Representación numérica 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 semana del año en formato numérico ISO-8601 (la semana comienza el Monday [lunes])
  • F - Representación textual completa del mes (January [enero] a December [diciembre])
  • m - Representación numérica del mes (de 01 a 12)
  • M - Representación textual corta del mes (tres letras)
  • n - Representación numérica del mes sin ceros iniciales (1 a 12)
  • t - Número de días del mes dado
  • L - Si es año bisiesto (1 si es bisiesto, 0 en caso contrario)
  • o - Número de año según el estándar ISO-8601
  • Y - Representación del año con cuatro dígitos
  • y - Representación del año con dos dígitos
  • a - En minúsculas: am o pm
  • A - En mayúsculas: AM o PM
  • B - Swatch Internet Time (000 a 999)
  • g - Formato de 12 horas sin ceros iniciales (1 a 12)
  • G - Formato de 24 horas sin ceros iniciales (0 a 23)
  • h - Formato de 12 horas con ceros iniciales (01 a 12)
  • H - Formato de 24 horas con ceros iniciales (00 a 23)
  • i - Minutos con ceros iniciales (00 a 59)
  • s - Segundos con ceros iniciales (00 a 59)
  • u - Microsegundos (añadido en PHP 5.2.2)
  • e - Identificador de zona horaria (por ejemplo: UTC, GMT, Atlantic/Azores)
  • I (mayúscula de i) - Si la fecha está en horario de verano (1 si es horario de verano, 0 en caso contrario)
  • O - Diferencia con respecto a la hora media de Greenwich (GMT) en horas (ejemplo: +0100)
  • P - Diferencia con respecto a la hora media de Greenwich (GMT) en hours:minutes (añadido en PHP 5.1.3)
  • T - Abreviatura de la zona horaria (ejemplos: EST, MDT)
  • Z - Desplazamiento de zona horaria en segundos. El desplazamiento de las zonas al oeste de UTC es negativo (-43200 a 50400)
  • c - Fecha según el estándar ISO-8601 (por ejemplo 2013-05-05T16:34:42+00:00)
  • r - Fecha en formato RFC 2822 (por ejemplo Fri, 12 Apr 2013 12:01:05 +0200)
  • U - Segundos transcurridos desde la época Unix (January 1 1970 00:00:00 GMT)

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: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (por ejemplo: 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (por ejemplo: Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (por ejemplo: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (por ejemplo: Fri, 12 Apr 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 una marca de tiempo Unix como entero. El valor predeterminado es la hora local actual (time()).

Detalles técnicos

Valor de retorno: Si tiene éxito, devuelve la cadena de fecha formateada; si falla, produce un error E_WARNING y devuelve FALSE.
Versión de PHP: 4+
Registro de cambios: PHP 5.1.0: Se agregaron errores de zona horaria E_STRICT y E_NOTICE. El rango válido de marcas de tiempo 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 algunos sistemas (por ejemplo Windows), las marcas de tiempo se limitaban desde 01-01-1970 hasta 19-01-2038.
PHP 5.1.1: Se agregaron constantes estándar de formato de fecha/hora para especificar el parámetro format.


PHP Date/TimeManual de referencia PHP Date/Time Otras extensiones