DateTime::createFromFormat

date_create_from_format

(PHP 5 >= 5.3.0)

DateTime::createFromFormat -- date_create_from_format — Devuelve un nuevo objeto DateTime formateado según el formato especificado

Descripción

Estilo orientado a objetos

public static DateTime DateTime::createFromFormat ( string $format , string $time [, DateTimeZone $timezone ] )

Estilo por procedimientos

DateTime date_create_from_format ( string $format , string $time [, DateTimeZone $timezone ] )

Devuelve un nuevo objeto DateTime formateado según el formato especificado.

Parámetros

format

El formato en el que debería estar el string proporcionado. Véanse las opciones de formateo más abajo. En la mayoría de los casos se pueden usar las mismas letras que para date().

Los siguientes caracteres son reconocidos en el string del parámetro format

Carácter de format Descripción Ejemplo de valores analizables

Día --- ---

d y j Día del mes, 2 dígitos con o sin ceros iniciales 01 a 31 o 1 a 31

D y l Una representación textual de un día Mon hasta Sun o Sunday hasta Saturday

S Sufijo ordinal inglés para el día del mes; 2 caracteres. Se ignora mientras se procesa. st, nd, rd o th.

z El día del año (comenzando por 0) 0 hasta 365

Mes --- ---

F y M Una representación textual de un mes, como January o Sept January hasta December o Jan hasta Dec

m y n Representación numérica de un mes, con o sin ceros iniciales 01 hasta 12 o 1 hasta 12

Año --- ---

Y Una representación numérica completa de un año, 4 dígitos Ejemplos: 1999 o 2003

y Una representación de dos dígitos de un año (el cual se asume que esté en el rango 1970-2069, inclusive) Ejemplos: 99 o 03 (que serán representados como 1999 y 2003, respectivamente)

Hora --- ---

a y A Ante meridiem y Post meridiem am o pm

g y h Formato de 12 horas de una hora con o sin ceros iniciales 1 hasta 12 o 01 hasta 12

G y H Formato de 24 horas de una hora con o sin ceros iniciales 0 hasta 23 o 00 hasta 23

i Minutos con ceros iniciales 00 hasta 59

s Segundos, con ceros iniciales 00 hasta 59

u Microsegundos (hasta seis dígitos) Ejemplo: 45, 654321

Zona horaria --- ---

e, O, P y T Identificador de zona horaria, o diferencia con UTC en horas, o diferencia con UTC con dos puntos entre horas y minutos, o abreviatura de la zona horaria Ejemplos: UTC, GMT, Atlantic/Azores o +0200 o +02:00 o EST, MDT

Fecha/Hora completas --- ---

U Segundos desde la Época Unix (January 1 1970 00:00:00 GMT) Ejemplo: 1292177455

Espacios en blanco y separadores --- ---

(espacio) Un espacio o una tabulación Ejemplo:

# Uno de los siguientes símbolos de separación: ;, :, /, ., ,, -, ( o ) Ejemplo: /

;, :, /, ., ,, -, ( o ) El carácter especificado. Ejemplo: -

? Un byte aleatorio Ejemplo: ^ (Observe que para los caracteres UTF-8 podría ser necesario más de un ?. En este caso es probable que quiera usar * en su lugar)

* Bytes aleatorios hasta el siguiente separador o dígito Ejemplo: * en Y-*-d con el string 2009-unaPalabra-08 coincidirá con unaPalabra

! Reinicia todos los campos (año, mes, día, hora, minuto, segundo, fracción e información de la zona horaria) a la Época Unix Sin !, todos los campos serán establecidos a la fecha y hora actuales.

| Reinicia todos los campos (año, mes, día, hora, minuto, segundo, fracción e información de la zona horaria) a la Época Unix si no han sido aún analizados Y-m-d| establecerá el año, mes y día a la información encontrada en el string a analizar, y establece la hora, minutos y segundos a 0.

+ Si este especificador de formato está presente, la información sobrante del string no causará un error, pero sí una advertencia. Use DateTime::getLastErrors() para averiguar si había presente información sobrante.

**Los siguientes caracteres son reconocidos en el string del parámetro `format`**
Carácter de `format`	Descripción	Ejemplo de valores analizables
Día	---	---
d y j	Día del mes, 2 dígitos con o sin ceros iniciales	01 a 31 o 1 a 31
D y l	Una representación textual de un día	Mon hasta Sun o Sunday hasta Saturday
S	Sufijo ordinal inglés para el día del mes; 2 caracteres. Se ignora mientras se procesa.	st, nd, rd o th.
z	El día del año (comenzando por 0)	0 hasta 365
Mes	---	---
F y M	Una representación textual de un mes, como January o Sept	January hasta December o Jan hasta Dec
m y n	Representación numérica de un mes, con o sin ceros iniciales	01 hasta 12 o 1 hasta 12
Año	---	---
Y	Una representación numérica completa de un año, 4 dígitos	Ejemplos: 1999 o 2003
y	Una representación de dos dígitos de un año (el cual se asume que esté en el rango 1970-2069, inclusive)	Ejemplos: 99 o 03 (que serán representados como 1999 y 2003, respectivamente)
Hora	---	---
a y A	Ante meridiem y Post meridiem	am o pm
g y h	Formato de 12 horas de una hora con o sin ceros iniciales	1 hasta 12 o 01 hasta 12
G y H	Formato de 24 horas de una hora con o sin ceros iniciales	0 hasta 23 o 00 hasta 23
i	Minutos con ceros iniciales	00 hasta 59
s	Segundos, con ceros iniciales	00 hasta 59
u	Microsegundos (hasta seis dígitos)	Ejemplo: 45, 654321
Zona horaria	---	---
e, O, P y T	Identificador de zona horaria, o diferencia con UTC en horas, o diferencia con UTC con dos puntos entre horas y minutos, o abreviatura de la zona horaria	Ejemplos: UTC, GMT, Atlantic/Azores o +0200 o +02:00 o EST, MDT
Fecha/Hora completas	---	---
U	Segundos desde la Época Unix (January 1 1970 00:00:00 GMT)	Ejemplo: 1292177455
Espacios en blanco y separadores	---	---
(espacio)	Un espacio o una tabulación	Ejemplo:
#	Uno de los siguientes símbolos de separación: ;, :, /, ., ,, -, ( o )	Ejemplo: /
;, :, /, ., ,, -, ( o )	El carácter especificado.	Ejemplo: -
?	Un byte aleatorio	Ejemplo: ^ (Observe que para los caracteres UTF-8 podría ser necesario más de un ?. En este caso es probable que quiera usar * en su lugar)
*	Bytes aleatorios hasta el siguiente separador o dígito	Ejemplo: * en Y--d* con el string 2009-unaPalabra-08 coincidirá con unaPalabra
!	Reinicia todos los campos (año, mes, día, hora, minuto, segundo, fracción e información de la zona horaria) a la Época Unix	Sin !, todos los campos serán establecidos a la fecha y hora actuales.
\|	Reinicia todos los campos (año, mes, día, hora, minuto, segundo, fracción e información de la zona horaria) a la Época Unix si no han sido aún analizados	Y-m-d\| establecerá el año, mes y día a la información encontrada en el string a analizar, y establece la hora, minutos y segundos a 0.
+	Si este especificador de formato está presente, la información sobrante del string no causará un error, pero sí una advertencia.	Use DateTime::getLastErrors() para averiguar si había presente información sobrante.

Los caracteres no reconocidos en el string de formato causarán que falle el análisis y se añadirá un mensaje de error a la esctructura devuelta. Puede consultar los mensajes de error con DateTime::getLastErrors().

Si format no contiene el carácter !, las partes del instante generado que no estén especificadas en format serán establecidas al instante actual del sistema.

Si format contiene el carácter !, las partes del instante generadas no proporcionadas en format, así como los valores más a la izquierda de !, serán establecidos a los valores correspondientes de la época Unix.

La época Unix es 1970-01-01 00:00:00 UTC.

time

Un string que representa la hora.

timezone

Un objeto DateTimeZone que representa la zona horaria deseada.

Si se omite timezone y time no contiene ninguna zona horaria, se usará la zona horaria en uso.

Nota:
El parámetro timezone y la zona horaria actual son ignoradas cuando el parámetro time contiene una marca temporal de UNIX (p.ej. 946684800) o especifica una zona horaria (p.ej. 2010-01-28T15:00:00+02:00).

Valores devueltos

Devuelve una nueva instancia de DateTime o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de DateTime::createFromFormat()

Estilo orientado a objetos


<?php
$fecha = DateTime::createFromFormat('j-M-Y', '15-Feb-2009');
echo $fecha->format('Y-m-d');
?>

Estilo por procedimientos


<?php
$fecha = date_create_from_format('j-M-Y', '15-Feb-2009');
echo date_format($fecha, 'Y-m-d');
?>

El resultado de los ejemplos serían:

2009-02-15

Ejemplo #2 Complejidades de DateTime::createFromFormat()


<?php
echo 'Instante actual: ' . date('Y-m-d H:i:s') . "\n";

$formato = 'Y-m-d';
$fecha = DateTime::createFromFormat($formato, '2009-02-15');
echo "Formato: $formato; " . $fecha->format('Y-m-d H:i:s') . "\n";

$formato = 'Y-m-d H:i:s';
$fecha = DateTime::createFromFormat($formato, '2009-02-15 15:16:17');
echo "Formato: $formato; " . $fecha->format('Y-m-d H:i:s') . "\n";

$formato = 'Y-m-!d H:i:s';
$fecha = DateTime::createFromFormat($formato, '2009-02-15 15:16:17');
echo "Formato: $formato; " . $fecha->format('Y-m-d H:i:s') . "\n";

$formato = '!d';
$fecha = DateTime::createFromFormat($formato, '15');
echo "Formato: $formato; " . $fecha->format('Y-m-d H:i:s') . "\n";
?>

El resultado del ejemplo sería algo similar a:

Instante actual: 2010-04-23 10:29:35
Formato: Y-m-d; 2009-02-15 10:29:35
Formato: Y-m-d H:i:s; 2009-02-15 15:16:17
Formato: Y-m-!d H:i:s; 1970-01-15 15:16:17
Formato: !d; 1970-01-15 00:00:00

Ver también

DateTime::__construct() - Devuelve un nuevo objeto DateTime
DateTime::getLastErrors() - Devuelve las advertencias y los errores
checkdate() - Validar una fecha gregoriana
strptime() - Analiza una fecha/hora generada con strftime