El método getDate() analiza cadenas que contienen fechas en formatos localizados. Los resultados se devuelven en un array estructurado, con claves bien definidas para cada parte de la fecha. Además, el array contendrá una clave 'date_format' que muestra la cadena de formato usada para analizar la cadena de fecha de entrada. Dado que una cadena de fecha localizada puede no contener todas las partes de una fecha/hora, los pares clave-valor son opcionales. Por ejemplo, si solo se proporcionan el año, el mes y el día, entonces todos los valores de hora se suprimen del array devuelto, y viceversa si solo se proporcionaron la hora, el minuto y el segundo como entrada. Si no se puede encontrar ninguna fecha u hora dentro de la entrada dada, se lanzará una excepción.

Si se establece setOption(array('fix_date' => true)), el método getDate() añade una clave 'fixed' con un valor numérico entero que indica si la cadena de fecha de entrada requirió "arreglos" reorganizando el día, el mes o el año en la entrada para ajustarse al formato utilizado.

Para quienes necesiten especificar explícitamente el formato de la cadena de fecha, se admiten los siguientes especificadores de token de formato. Si se usa un especificador de formato no válido, como el especificador 'i' de PHP en el modo de formato ISO, entonces se lanzará un error por los métodos de Zend_Locale_Format que admiten formatos definidos por el usuario.

Estos especificadores (a continuación) son un pequeño subconjunto del conjunto "ISO" completo admitido por toString() de Zend_Date. Si necesita usar especificadores de formato compatibles con date() de PHP, primero llame a setOptions(array('format_type' => 'php')). Y si desea convertir solo una cadena de formato especial del formato compatible con date() de PHP al formato "ISO", use convertPhpToIsoFormat(). Actualmente, la única diferencia práctica se refiere al especificador de minutos ('m' usando el valor predeterminado ISO, y 'i' usando el formato de fecha de PHP).

$dateString = Zend_Locale_Format::getDate(
    '13.04.2006',
    array(
        'date_format' => 'dd.MM.yyyy',
    )
);

print_r($dateString); // outputs:

Array
(
    [date_format] => dd.MM.yyyy
    [locale] => de_DE
    [day] => 13
    [month] => 04
    [year] => 2006
)

// creates a Zend_Date object for this date
$dateObject = new Zend_Date('13.04.2006', 'dd.MM.yyyy');

print_r($dateObject); // outputs:

Zend_Date Object
(
    [_locale:Zend_Date:private] => de_DE
    [_fractional:Zend_Date:private] => 0
    [_precision:Zend_Date:private] => 3
    [_unixTimestamp:Zend_Date_DateObject:private] => 1144879200
    [_timezone:Zend_Date_DateObject:private] => Europe/Berlin
    [_offset:Zend_Date_DateObject:private] => -3600
    [_syncronised:Zend_Date_DateObject:private] => 0
    [_dst:protected] => 1
)

// alternatively, some types of problems with input data can be
// automatically corrected
$date = Zend_Locale_Format::getDate(
    '04.13.2006',
    array(
        'date_format' => 'dd.MM.yyyy',
        'fix_date'    => true,
    )
);

print_r($date); // outputs:

Array
(
    [date_format] => dd.MM.yyyy
    [locale] => de_DE
    [day] => 13
    [month] => 04
    [year] => 2006
    [fixed] => 4
)

Dado que getDate() "tiene en cuenta la configuración regional", especificar $locale es suficiente para cadenas de fecha que se ajusten al formato de esa configuración regional. La opción 'fix_date' usa pruebas simples para determinar si el día o el mes no son válidos, y luego aplica heurísticas para intentar corregir cualquier problema detectado. Observe el uso de 'Zend_Locale_Format::STANDARD' como el valor de 'date_format' para evitar el uso de un formato de fecha predeterminado a nivel de clase establecido mediante setOptions(). Esto obliga a getDate a usar el formato de fecha predeterminado para $locale.

$locale = new Zend_Locale('de_AT');
$date = Zend_Locale_Format::getDate('13.04.2006',
                                    array('date_format' =>
                                              Zend_Locale_Format::STANDARD,
                                          'locale' => $locale)
                                   );

print_r ($date);

Se devuelve una fecha y hora completa cuando la entrada contiene tanto una fecha como una hora en el formato esperado.

$locale = new Zend_Locale('de_AT');
$date = Zend_Locale_Format::getDate('13.04.2005 22:14:55',
                                    array('date_format' =>
                                                Zend_Locale_Format::STANDARD,
                                          'locale' => $locale)
                                    );

print_r ($date);

Si se desea un formato específico, especifique el argumento $format, sin proporcionar un $locale. Solo se admiten los códigos de una sola letra (H, m, s, y, M, d), así como MMMM y EEEE, en $format.

$date = Zend_Locale_Format::getDate('13200504T551422',
                                    array('date_format' =>
                                              'ddyyyyMM ssmmHH')
                                   );

print_r ($date);

El formato puede incluir los siguientes signos:

Ejemplos de formatos correctos son

	Formato de fecha de base de datos
	Para analizar un valor de fecha de base de datos (por ejemplo, MySql o MsSql), use el formato ISO_8601 de Zend_Date en lugar de getDate().

La opción 'fix_date' usa pruebas simples para determinar si el día o el mes no son válidos, y luego aplica heurísticas para intentar corregir cualquier problema detectado. getDate() detecta y corrige automáticamente algunos tipos de problemas con la entrada, como colocar el año en la posición incorrecta:

$date = Zend_Locale_Format::getDate('41.10.20',
                                    array('date_format' => 'ddMMyy',
                                          'fix_date' => true)
                                   );

// instead of 41 for the day, the 41 will be returned as year value
print_r ($date);

Use checkDateFormat($inputString, array('date_format' => $format, $locale)) para comprobar si una cadena dada contiene todas las partes de fecha esperadas. El método checkDateFormat() usa getDate(), pero sin la opción 'fixdate' para evitar devolver TRUE cuando la entrada no se ajusta al formato de fecha. Si se detectan errores en la entrada, como valores intercambiados de meses y días, el método con la opción 'fixdate' aplicará heurísticas para "corregir" las fechas antes de determinar su validez.

$locale = new Zend_Locale('de_AT');
// using the default date format for 'de_AT', is this a valid date?
if (Zend_Locale_Format::checkDateFormat('13.Apr.2006',
                                        array('date_format' =>
                                                  Zend_Locale_Format::STANDARD,
                                              $locale)
                                       ) {
    print "date";
} else {
    print "not a date";
}

Normalmente, se devolverá una hora junto con una fecha, si la entrada contiene ambas. Si no se conoce el formato adecuado, pero sí la configuración regional relevante para la entrada del usuario, entonces debe usarse getTime(), porque utiliza el formato de hora predeterminado para la configuración regional seleccionada.

$locale = new Zend_Locale('de_AT');
if (Zend_Locale_Format::getTime('13:44:42',
                                array('date_format' =>
                                          Zend_Locale_Format::STANDARD,
                                      'locale' => $locale)) {
    print "time";
} else {
    print "not a time";
}

Use checkDateFormat() para comprobar si una cadena dada contiene una hora correcta. El uso es exactamente el mismo que al comprobar fechas, solo que date_format debe contener las partes que se espera tener.

$locale = new Zend_Locale('de_AT');
if (Zend_Locale_Format::checkDateFormat('13:44:42',
                                        array('date_format' => 'HH:mm:ss',
                                              'locale' => $locale)) {
    print "time";
} else {
    print "not a time";
}