Función gmdate() de PHP
Ejemplo
Formatear la fecha y la hora GMT/UTC y devolver la cadena de fecha formateada:
<?php
// Salida: día de la semana
echo gmdate("l") . "<br>";
// Salida: día de la semana, día, mes, año, hora, mañana o tarde
echo gmdate("l jS \of F Y h:i:s A");
?>
Ejemplo de ejecución
Definición y uso
La función gmdate() formatea la fecha y la hora GMT/UTC y devuelve la cadena de fecha formateada.
Sintaxis
gmdate(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 (desde 01 hasta 31)
- D - Representación textual del día de la semana (usando tres letras)
- j - Día del mes, sin ceros iniciales (1 a 31)
- l (forma 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 lunes, 7 para domingo)
- S - Sufijo ordinal en inglés del día del mes (2 caracteres: st, nd, rd o th. Se usa con j)
- w - Número numérico del día de la semana (0 para domingo, 6 para sábado)
- z - Día del año (desde 0 hasta 365)
- W - Número de la semana del año en formato ISO-8601 (la semana comienza el lunes)
- F - Representación textual completa del mes (January [enero] hasta December [diciembre])
- m - Número numérico del mes (desde 01 hasta 12)
- M - Representación abreviada del mes (usando tres letras)
- n - Número numérico del mes, sin ceros iniciales (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 - Año numérico según el estándar ISO-8601
- Y - Año representado por cuatro dígitos
- y - Año representado por dos dígitos
- a - Formato en minúsculas: am o pm
- A - Formato 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 está 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 formato 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 - 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: 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 - Alianza de la Web (por ejemplo: 2013-04-12T15:52:01+00:00)
|
timestamp |
Opcional. Define el timestamp de Unix entero. Por defecto es la hora local actual (time()). |
Detalles técnicos
Valor devuelto: |
Si tiene éxito, devuelve la cadena de fecha formateada; si falla, devuelve E_WARNING y FALSE. |
Versión de PHP: |
4+ |
Registro de actualizaciones: |
PHP 5.1.0: El rango válido de 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: Constantes de formato de fecha/hora estándar nuevas, utilizadas para especificar format Parámetros.
|