date

(PHP 3, PHP 4, PHP 5)

date -- Dar formato a una hora/fecha local

Descripción

string date ( string formato [, int marca_de_tiempo] )

Devuelve una cadena con formato de acuerdo a la cadena de formato dada usando el entero marca_de_tiempo entregado o la hora local si no se da una marca de tiempo. En otras palabras, marca_de_tiempo es opcional y su valor predeterminado es el valor de time().

Nota: El rango válido de una marca de tiempo es típicamente de Fri, 13 Dec 1901 20:45:54 GMT a Tue, 19 Jan 2038 03:14:07 GMT. (Estas son las fechas que corresponden a los valores mínimo y máximo para un entero de 32-bits con signo). En Windows este rango está limitado de 01-01-1970 a 19-01-2038.

Nota: Para generar una marca de tiempo desde una representación tipo cadena de la fecha, es posible usar strtotime(). Adicionalmente, algunas bases de datos tienen funciones para convertir sus formatos de fecha a marcas de tiempo (como la función UNIX_TIMESTAMP de MySQL).

Tabla 1. Los siguientes caracteres son reconocidos en la cadena del parámetro formato

Caracter de formatoDescripciónValores de ejemplo devueltos
Día------
dDía del mes, 2 dígitos con ceros iniciales01 a 31
DUna representación textual de un día, tres letrasMon a Sun
jDía del mes sin ceros iniciales1 a 31
l ('L' minúscula)Una representación textual completa del día de la semanaSunday a Saturday
SSufijo ordinal en inglés del dia del mes, 2 caracteres st, nd, rd o th. Funciona bien con j
wRepresentación numérica del día de la semana0 (para el Domingo) a 6 (para el Sábado)
zEl día del año (comenzando en 0)0 a 365
Semana------
WNúmero de la semana del año ISO-8601, las semanas comienzan en Lunes (agregado en PHP 4.1.0)Ejemplo: 42 (la 42va semana del año)
Mes------
FUna representación textual completa de un mes, como January o MarchJanuary a December
mRepresentación numérica de un mes, con ceros iniciales01 a 12
MUna representación textual corta de un mes, tres letrasJan a Dec
nRepresentación numérica de un mes, sin ceros iniciales1 a 12
tNúmero de días en el mes dado28 a 31
Año------
LIndica si es un año bisiesto1 si es un año bisiesto, 0 de lo contrario.
oNúmero de año ISO-8601. Este es el mismo valor que Y, excepto que si el número de semana ISO (W) pertenece al año previo o siguiente, ese año será usado en su lugar. (agregado en PHP 5.1.0)Ejemplos: 1999 o 2003
YUna representación numérica completa de un año, 4 dígitosEjemplos: 1999 o 2003
yUna representación de dos dígitos de un añoEjemplos: 99 o 03
Hora------
aAnte meridiano y Post meridiano en minúsculasam o pm
AAnte meridiano y Post meridiano en mayúsculasAM o PM
BHora Swatch Internet000 a 999
gformato de 12-horas de una hora sin ceros iniciales1 a 12
Gformato de 24-horas de una hora sin ceros iniciales0 a 23
hformato de 12-horas de una hora con ceros iniciales01 a 12
Hformato de 24-horas de una hora con ceros iniciales00 a 23
iMinutos con ceros iniciales00 a 59
sSegundos, con ceros iniciales00 a 59
Zona horaria------
eIdentificador de zona horaria (agregado en PHP 5.1.0)Ejemplos: UTC, GMT, Atlantic/Azores
I (i mayúscula)Indica si la fecha están en hora de ahorro de luz diurna1 si es Hora de Ahorro de Luz Diurna, 0 de lo contrario.
ODiferencia con la hora Greenwich (GMT) en horasEjemplo: +0200
TConfiguración de zona horaria de esta máquinaEjemplos: EST, MDT ...
ZDesplazamiento de la zona horaria en segundos. El desplazamiento para zonas horarias al oeste de UTC es siempre negativo, y el de aquellas al este de UTC es siempre positivo.-43200 a 43200
Fecha/Hora Completa------
cFecha ISO 8601 (agregada en PHP 5)2004-02-12T15:19:21+00:00
rFecha en formato RFC 2822Ejemplo: Thu, 21 Dec 2000 16:01:07 +0200
USegundos desde el Epoch Unix (January 1 1970 00:00:00 GMT)Vea también time()

Los caracteres no reconocidos en la cadena de formato serán impresos como son. El formato Z siempre devuelve 0 cuando se usa gmdate().

Ejemplo 1. Ejemplos de date()

<?php
// Imprime algo como: Wednesday
echo date("l");

// Imprime algo como: Wednesday 15th of January 2003 05:51:38 AM
echo date("l dS of F Y h:i:s A");

// Imprime: July 1, 2000 is on a Saturday
echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000));
?>

Puede prevenir que un caracter reconocido en la cadena de formato sea expandido escapándolo con una barra invertida. Si el caracter con una barra invertida es una secuencia especial, puede que necesite escapar también la barra invertida.

Ejemplo 2. Escapar caracteres en date()

<?php
// imprime algo como: Wednesday the 15th
echo date("l \\t\h\e jS");
?>

Es posible usar date() y mktime() juntos para encontrar fechas en el futuro o el pasado.

Ejemplo 3. Ejemplo de date() y mktime()

<?php
$manyana        
= mktime(0, 0, 0, date("m")  , date("d")+1, date("Y"));
$ultimo_mes     = mktime(0, 0, 0, date("m")-1, date("d"),   date("Y"));
$siguiente_anyo = mktime(0, 0, 0, date("m"),   date("d"),   date("Y")+1);
?>

Nota: Esto puede ser más confiable que simplemente sumar o restar el número de segundos en un día o mes de una marca de tiempo debido a las horas de ahorro de luz diurna.

Algunos ejemplos de formato de date(). Note que debe escapar cualquier otro caracter, ya que cualquiera que tenga un significado especial producirá resultados indeseados, y otros caracteres pueden recibir un significado en versiones futuras de PHP. Cuando escape caracteres, asegúrese de usar comillas sencillas para evitar que caracteres como \n se conviertan en saltos de línea.

Ejemplo 4. Formato de date()

<?php
// Asumiendo que hoy es: March 10th, 2001, 5:16:18 pm

$hoy = date("F j, Y, g:i a");                 // March 10, 2001, 5:16 pm
$hoy = date("m.d.y");                         // 03.10.01
$hoy = date("j, n, Y");                       // 10, 3, 2001
$hoy = date("Ymd");                           // 20010310
$hoy = date('h-i-s, j-m-y, it is w Day z ');  // 05-16-17, 10-03-01, 1631 1618 6 Fripm01
$hoy = date('\i\t \i\s \t\h\e jS \d\a\y.');   // It is the 10th day.
$hoy = date("D M j G:i:s T Y");               // Sat Mar 10 15:16:08 MST 2001
$hoy = date('H:m:s \m \i\s\ \m\o\n\t\h');     // 17:03:17 m is month
$hoy = date("H:i:s");                         // 17:16:17
?>

Para dar formato a fechas en otros idiomas, debe usar las funciones setlocale() y strftime().

Vea también getlastmod(), gmdate(), mktime(), strftime() y time().

Hosting by: hurra.com
Generated: 2007-01-26 18:00:56