array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.date.php', 1 => 'date', 2 => 'Da formato a una marca de tiempo de Unix (Unix timestamp)', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Funciones de Fecha/Hora', ), 'prev' => array ( 0 => 'function.checkdate.php', 1 => 'checkdate', ), 'next' => array ( 0 => 'function.date-add.php', 1 => 'date_add', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/datetime/functions/date.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

date

(PHP 4, PHP 5, PHP 7, PHP 8)

date — Da formato a una marca de tiempo de Unix (Unix timestamp)

Descripción

date(string $format, ?int $timestamp = null): string

Devuelve una cadena formateada según el formato indicado usando el integer timestamp (Unix timestamp) dado, o el momento actual si no se da una marca de tiempo. En otras palabras, timestamp es opcional y por defecto es el valor de time().

Advertencia

Las marcas de tiempo de Unix no manejan zonas horarias. Usa la clase DateTimeImmutable, y su método DateTimeInterface::format() para formatear fecha/hora incluyendo la información de zona horaria.

Parámetros

format

Formato aceptado por DateTimeInterface::format().

Nota: date() generará siempre 000000 como microsegundos ya que toma un tipo int como parámetro, mientras que DateTimeInterface::format() soporta microsegundos, si el objeto del tipo DateTimeInterface es creado con microsegundos.

timestamp

El parámetro opcional timestamp es un timestamp Unix de tipo int que por omisión es la hora actual local si timestamp es omitido o null. En otras palabras, es por omisión el valor de la función time().

Valores devueltos

Devuelve una cadena de fecha formateada.

Errores/Excepciones

Cada llamada a una función de fecha/hora generará un diagnóstico de tipo E_WARNING si la zona horaria no es válida. Ver también date_default_timezone_set()

Historial de cambios

Versión Descripción
8.0.0 timestamp ahora es nullable.

Ejemplos

Ejemplo #1 date() examples

<?php
// Establecer la zona horaria por omisión
date_default_timezone_set('UTC');


// Imprime algo como: Monday
echo date("l") . "\n";

// Imprime algo como: Monday 8th of August 2005 03:12:46 PM
echo date('l jS \of F Y h:i:s A') . "\n";

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

/* Usar las constantes en el parámetro de formato */
// Imprime algo como: Wed, 25 Sep 2013 15:28:57 -0700
echo date(DATE_RFC2822) . "\n";

// Imprime algo como: 2000-07-01T00:00:00+00:00
echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000));

Puede prevenir que un carácter reconocido en la cadena de formato sea expandido escapándolo con una barra invertida precedente. Si el carácter con una barra invertida es ya una secuencia especial, necesitará escapar también la barra invertida.

Ejemplo #2 Escapando caracteres en date()

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

Algunos ejemplos de formatear date(). Observe que debería escapar cualesquiera otros caracteres, ya que cualquiera que tenga actualmente un significado especial producirá resultados no deseados, y a otros caracteres se les pueden asignar significado en futuras versiones de PHP. Cuando se escapa un carácter, asegúrese de usar comillas simples para prevenir que caracteres como \n se conviertan en nuevas líneas.

Ejemplo #3 Dando formato con date()

<?php
// Asumiendo que hoy es 10 de marzo de 2001, 5:16:18 pm, y que estamos en la
// zona horaria Mountain Standard Time (MST)
date_default_timezone_set("America/Phoenix");

echo date("F j, Y, g:i a") . "\n"; // March 10, 2001, 5:16 pm
echo date("m.d.y") . "\n"; // 03.10.01
echo date("j, n, Y") . "\n"; // 10, 3, 2001
echo date("Ymd") . "\n"; // 20010310
echo date('h-i-s, j-m-y, it is w Day') . "\n"; // 05-16-18, 10-03-01, 1631 1618 6 Satpm01
echo date('\i\t \i\s \t\h\e jS \d\a\y.') . "\n"; // it is the 10th day.
echo date("D M j G:i:s T Y") . "\n"; // Sat Mar 10 17:16:18 MST 2001
echo date('H:m:s \m \i\s\ \m\o\n\t\h') . "\n"; // 17:03:18 m is month
echo date("H:i:s") . "\n"; // 17:16:18
echo date("Y-m-d H:i:s") . "\n"; // 2001-03-10 17:16:18 (the MySQL DATETIME format)

Para formatear fechas en otros lenguajes, debería usar IntlDateFormatter::format() en vez de date().

Notas

Nota:

Para generar una marca de tiempo desde una cadena que representa la fecha, puede usar strtotime(). Además, algunas bases de datos tienen funciones para convertir formatos de fecha en marcas de tiempo (como la función » UNIX_TIMESTAMP de MySQL).

Sugerencia

La marca de tiempo del inicio de una petición está disponible en $_SERVER['REQUEST_TIME'].

Ver también