PHP date()Función
Manual de referencia PHP Date/Time
Ejemplos
Formatea la fecha y hora local, y devuelve la cadena de fecha formateada:
<?php
date_default_timezone_set("PRC");
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;
$time = strtotime("2018-01-18 08:08:08");
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
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. |
Manual de referencia PHP Date/Time Otras extensiones