Una vez que la entrada se ha normalizado mediante la creación de un objeto Zend_Date, tendrá una zona horaria asociada, pero una representación interna que usa las marcas de tiempo UNIX estándar. Para que una fecha se muestre de forma localizada, primero se debe conocer una zona horaria. La zona horaria por defecto siempre es GMT o UTC. Para examinar la zona horaria de un objeto use getTimeZone(). Para cambiar la zona horaria de un objeto, use setTimeZone(). Se asume que todas las manipulaciones de estos objetos son relativas a esta zona horaria.

Tenga cuidado al mezclar operaciones con partes de fecha entre objetos de fecha para distintas zonas horarias, ya que generalmente producen resultados indeseables, a menos que las manipulaciones solo estén relacionadas con la marca de tiempo. Operar con objetos Zend_Date que tienen distintas zonas horarias generalmente funciona, salvo lo indicado anteriormente, ya que las fechas se normalizan a marcas de tiempo UNIX al instanciar Zend_Date.

La mayoría de los métodos esperan una constante que seleccione la $part deseada de una fecha, como Zend_Date::HOUR. Estas constantes son válidas para todas las funciones siguientes. Se proporciona una lista de todas las constantes disponibles en list of all constants. Si no se especifica ninguna $part, se asume Zend_Date::TIMESTAMP. Alternativamente, se puede usar un formato especificado por el usuario para $part, usando el mismo mecanismo subyacente y los mismos códigos de formato que Zend_Locale_Format::getDate(). Si un objeto de fecha se construye usando una fecha evidentemente inválida (por ejemplo, un número de mes mayor que 12), entonces Zend_Date lanzará una excepción, a menos que no se haya seleccionado un formato de fecha específico, es decir, $part es NULL o Zend_Date::DATES (un formato "laxo").

$date1 = new Zend_Date('Feb 31, 2007', null, 'en_US');
echo $date1, "\n"; // outputs "Mar 3, 2007 12:00:00 AM"

$date2 = new Zend_Date('Feb 31, 2007', Zend_Date::DATES, 'en_US');
echo $date2, "\n"; // outputs "Mar 3, 2007 12:00:00 AM"

// strictly restricts interpretation to specified format
$date3 = new Zend_Date('Feb 31, 2007', 'MM.dd.yyyy');
echo $date3, "\n"; // outputs "Mar 3, 2007 12:00:00 AM"

Si se proporciona el parámetro opcional $locale, entonces $locale desambigua el operando $date reemplazando los nombres de meses y días de la semana para operandos $date de tipo cadena, e incluso analiza cadenas de fecha expresadas según las convenciones de esa configuración regional (vea Zend_Locale_Format::getDate()). La normalización automática de operandos $date localizados de tipo cadena ocurre cuando $part es una de las constantes Zend_Date::DATE* o Zend_Date::TIME*. La configuración regional identifica qué idioma debe usarse para analizar nombres de meses y nombres de días de la semana, si $date es una cadena que contiene una fecha. Si no hay ningún parámetro de entrada $date, entonces el parámetro $locale especifica la configuración regional que se usará para localizar la salida (por ejemplo, el formato de fecha para una representación de cadena). Tenga en cuenta que el parámetro de entrada $date podría en realidad tener un nombre de tipo distinto (por ejemplo, $hour para addHour()), aunque eso no impide el uso de objetos Zend_Date como argumentos para ese parámetro. Si no se especificó ninguna $locale, entonces se usa la configuración regional del objeto actual para interpretar $date, o para seleccionar el formato localizado para la salida.

Desde Zend Framework 1.7.0, Zend_Date también admite el uso de una configuración regional a nivel de aplicación. Puede simplemente asignar una instancia de Zend_Locale al registro como se muestra a continuación. Con esta notación puede olvidarse de establecer la configuración regional manualmente en cada instancia cuando quiera usar la misma configuración regional varias veces.

// in your bootstrap file
$locale = new Zend_Locale('de_AT');
Zend_Registry::set('Zend_Locale', $locale);

// somewhere in your application
$date = new Zend_Date('31.Feb.2007');

Los métodos add(), sub(), compare(), get(), y set() operan de forma genérica sobre fechas. En cada caso, la operación se realiza sobre la fecha contenida en el objeto de la instancia. El operando $date es obligatorio para todos estos métodos, excepto get(), y puede ser una instancia de Zend_Date, una cadena numérica o un entero. Estos métodos asumen que $date es una marca de tiempo, si no es un objeto. Sin embargo, el operando $part controla sobre qué parte lógica de las dos fechas se opera, lo que permite operar sobre partes de la fecha del objeto, como el año o el minuto, incluso cuando $date contiene una cadena de fecha larga, como "December 31, 2007 23:59:59". El resultado de la operación cambia la fecha del objeto, excepto en el caso de compare() y get().

$date = new Zend_Date(); // $date's timestamp === time()

// changes $date by adding 12 hours
$date->add('12', Zend_Date::HOUR);
print $date;

Existen métodos de conveniencia para cada combinación de las operaciones básicas y varias partes de fecha comunes, como se muestra en las tablas siguientes. Estos métodos de conveniencia nos ayudan a los programadores perezosos a evitar tener que escribir las constantes de parte de fecha al usar los métodos generales anteriores. Convenientemente, se nombran combinando un prefijo (nombre de una operación básica) con un sufijo (tipo de parte de fecha), como addYear(). En la lista siguiente, existen todas las combinaciones de "Partes de fecha" y "Operaciones básicas". Por ejemplo, la operación "add" existe para cada una de estas partes de fecha, incluyendo addDay(), addYear(), etc.

Estos métodos de conveniencia tienen la misma funcionalidad equivalente que los métodos de operación básicos, pero esperan operandos $date de tipo cadena o entero que contengan solo los valores que representan el tipo indicado por el sufijo del método de conveniencia. Por tanto, los nombres de estos métodos (por ejemplo, "Year" o "Minute") identifican las unidades del operando $date, cuando $date es una cadena o un entero.

26.4.3.2. Lista de operaciones de fecha

Las operaciones básicas siguientes pueden usarse en lugar de las operaciones de conveniencia para partes de fecha específicas, si se usa la constante apropiada para el parámetro $part.

Tabla 26.2. Operaciones básicas

Operación básica	Explicación
get()	get($part = null, $locale = null) Use get($part) para obtener la $part de la fecha de este objeto, localizada según $locale, como cadena o entero con formato. Al usar la extensión BCMath, es posible que se devuelvan cadenas numéricas en lugar de enteros para valores grandes. Comportamiento de get() A diferencia de get(), los demás métodos de conveniencia get*() solo devuelven instancias de Zend_Date que contienen una fecha que representa la fecha u hora seleccionada o calculada.
set()	set($date, $part = null, $locale = null) Asigna a la $part del objeto actual el valor correspondiente a esa parte encontrado en la entrada $date, que tiene una configuración regional $locale.
add()	add($date, $part = null, $locale = null) Suma la $part de $date, con configuración regional $locale, a la fecha del objeto actual.
sub()	sub($date, $part = null, $locale = null) Resta la $part de $date, con configuración regional $locale, de la fecha del objeto actual.
copyPart()	copyPart($part, $locale = null) Devuelve un objeto clonado, con solo la $part de la fecha del objeto copiada al clon, y con la configuración regional del clon fijada arbitrariamente a $locale (si se especifica).
compare()	compare($date, $part = null, $locale = null) compara la $part de $date con la marca de tiempo de este objeto, devolviendo 0 si son iguales, 1 si la parte de este objeto es más reciente que la parte de $date, y -1 en caso contrario.

Las siguientes operaciones básicas no tienen métodos de conveniencia correspondientes para las partes de fecha indicadas en Zend_Date API Overview.

Varios métodos permiten recuperar valores relacionados con una instancia de Zend_Date.

Tabla 26.4. Métodos de salida de fecha

Método	Explicación
toString()	toString($format = null, $locale = null) Se invoca directamente o mediante el método mágico __toString(). El método toString() formatea automáticamente el valor del objeto de fecha según las convenciones de la configuración regional del objeto, o de una $locale especificada opcionalmente. Para ver una lista de los códigos de formato admitidos, consulte Self-Defined OUTPUT Formats with ISO.
toArray()	toArray() Devuelve una representación en array de la fecha seleccionada según las convenciones de la configuración regional del objeto. El array devuelto es equivalente a la función getdate() de PHP e incluye: Número de día como 'day' (Zend_Date::DAY_SHORT) Número de mes como 'month' (Zend_Date::MONTH_SHORT) Año como 'year' (Zend_Date::YEAR) Hora como 'hour' (Zend_Date::HOUR_SHORT) Minuto como 'minute' (Zend_Date::MINUTE_SHORT) Segundo como 'second' (Zend_Date::SECOND_SHORT) Zona horaria abreviada como 'timezone' (Zend_Date::TIMEZONE) Marca de tiempo Unix como 'timestamp' (Zend_Date::TIMESTAMP) Número del día de la semana como 'weekday' (Zend_Date::WEEKDAY_DIGIT) Día del año como 'dayofyear' (Zend_Date::DAY_OF_YEAR) Semana como 'week' (Zend_Date::WEEK) Desfase de la zona horaria respecto a GMT como 'gmtsecs' (Zend_Date::GMT_SECS)
toValue()	toValue($part = null) Devuelve una representación entera de la $part de fecha seleccionada, según las convenciones de la configuración regional del objeto. Devuelve FALSE cuando $part selecciona un valor no numérico, como Zend_Date::MONTH_NAME_SHORT. Limitación de toValue() Este método llama a get() y convierte el resultado a un entero de PHP, lo que dará resultados impredecibles si get() devuelve una cadena numérica que contiene un número demasiado grande para un entero de PHP en su sistema. Use get() en su lugar.
get()	get($part = null, $locale = null) Este método devuelve la $part de la fecha del objeto, localizada según $locale, como cadena o entero con formato. Vea get() para más información.
now()	now($locale = null) Esta función de conveniencia es equivalente a new Zend_Date(). Devuelve la fecha actual como un objeto Zend_Date, con la configuración regional $locale

Varios métodos permiten recuperar valores relacionados con una instancia de Zend_Date.

Tres métodos permiten acceder a información geográficamente localizada sobre el Sol, incluyendo la hora del amanecer y del anochecer.