Clase PHP para manipular fechas y horas.

Si necesitas trabajar con fechas y horas en tu página o aplicación en PHP, esta clase te permite utilizar y acceder a funciones que te facilitarán el trabajo de programación.

Se trata de una simple clase que encapsula métodos y funciones varias, por ejemplo para recuperar valores de fecha y hora, formatear, manipular, comparar y realizar cálculos.

Acerca de la licencia, podemos decir que es completamente gratuita y de libre uso, distribuida bajo licencia GPL (contiene documentación.)

En el sitio web del autor, además de la clase php, se lista una breve documentación que detalla los métodos, funciones, constantes y ejemplos de como utilizarla.

A continuación puedes ver un resumen del contenido.

1. Funciones para recuperar fechas y horas.
2. Funciones para agregar y quitar fechas / horas.
3. Funciones para comparar.
4. Funciones de formato.
5. Tabla de constantes.
6. Documentación completa.

1 - Funciones para recuperar fechas y horas.

• getYear: Función que retorna el año de una fecha.
• getMonth: Retorna el mes.
• getDay: Retorna el día.
• getWeekDay: Devuelve el día de la semana.
• getHours, getMinutes, getSEconds: Funciones que devuelven la hora, minutos y segundos respectivamente.
• DaysInMonth: Devuelve el número de días que contiene un mes determinado.

2 - Funciones para agregar y quitar fechas y horas

Los métodos AddYears, AddMonth, AddDays, AddHours y AddMinutes, se pueden utilizar para añadir años, meses, días, horas, minutos y segundos respectivamente a la fecha que se pase como parámetro a la función.

3 - Funciones para comparar.

La función compareTo permite comparar dos fechas, por ejemplo.

if( $date1->compareTo( $date2 ) == 0 ) echo "date1 y date2 son iguales";

La función daysTo permite recupera el número de días entre un intervalo de fechas.

4 - Funciones de formato.

La función de formato Format y toString, devuelven una fecha con el formato indicado.

toString retorna la fecha de acuerdo al formato dado, por ejemplo:

$time = $date->toString( "%H hours %M minutes %S seconds" );

Ejempo de la función Format.

$today = Date::Format( "%a %d %m %Y", time() );
$yesterday = Date::Format( "%a %d %m %Y", time() - 86400 );

5 - Tabla de constantes.

A continuación se enumran las constantes, junto a su descripción y valor.

6 -Documentación completa.

La documentación de la clase PHP la puedes encontrar en este enlace o en el archivo de descarga.

Plataforma PHP