[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-general-es
Subject:    dates.php funciones para fechas
From:       Tomas Von Veschler <cox () idecnet ! com>
Date:       2000-08-31 15:07:34
Message-ID: 39AE74B6.A5E4428C () idecnet ! com
[Download RAW message or body]

Hola lista,

Debido a que estos últimos dias no he podido conciliar bien el sueño, he
aprovechado para crear una abundante colección de funciones para
trabajar con fechas. Espero que os gusten y si os decidis a probarlas
que me mandais comentarios con vuestras opiniones. La licencia de uso es
GPL con todo lo que ella conlleva.
Todos los detalles en:

http://vulcanonet.com/~linux/dates

Saludos,

Tomas V.V.Cox

Pd.- Adjunto el tosco fichero de documentación que he creado (espero que
nadie se moleste).
["dates.txt" (text/plain)]

dates.php <http://vulcanonet.com/linux/dates>
Provisional: vulcanonet.com/~linux/dates !
Coleccion de funciones para trabajar con fechas
v.0.4  31-08-2000 (euro ;) 

Copyright (c) 2000 Tomas V.V.Cox <cox@vulcanonet.com>
This software is released under the GNU Public License
Please see http://www.gnu.org/copyleft/gpl.txt for licensing details!

I. Introduccion

dates.php, es una coleccion de funciones hechas en PHP que proporciona
al programador las funciones más necesarias para el trabajo con fechas.

II. Instalación, Uso y Funciones disponibles

La instalación es tan sencilla como copiar este fichero a algún directorio
dentro del include_path de su instalación de PHP.

Debido a que dates.php, está ideada para uso con cualquier formato de
fecha, es de vital importancia especificar cual es el formato de las
fechas que se usan con las funciones. Esto se hace especificando la
variable:

$DATEFORMAT

antes de usar cualquier funcion de dates.php. Si no se especifica esta
variable *NO FUNCIONARA* ninguna de ellas. Los formatos soportados son:

iso (YYYY/MM/DD)
euro (DD/MM/YYYY)
eng (MM/DD/YYYY)

Actualmente las funciones implementadas son:

- check_date: Valida una fecha usando la funcion checkdate de php
- convertdate: Convierte fechas entre los formatos iso, euro y eng
- today: retorna fecha de hoy en formato $DATEFORMAT
- monthplus: Retorna la fecha introducida + $num meses
- dayplus: Retorna la fecha introducida + $num dias
- monthlastday: Retorna la fecha del ultimo dia del mes de una fecha dada
- monthfirstday: Retorna la fecha del primer dia del mes de una fecha dada
- getdaynameof: Retorna el nombre completo del dia de una fecha en un idioma dado
- getmonthnameof: Retorna el nombre completo del mes de una fecha en un	idioma dado
- getdayof: Retorna el dia de una fecha
- getmonthof: Retorna el mes de una fecha
- getyearof: Retorna el año de una fecha
- comparedate: Compara dos fechas
- count_days: Cuenta los dias que hay entre $a_date y $b_date

Ejemplo básico:
<?php
$DATEFORMAT = "euro";
include "dates.php";
echo today(); // muestra el dia hoy
$a = "12/10/2000"; //el separador puede ser '/' o '-'
echo dayplus ($a, -1); // muestra el dia 11/10/2000
?>

Imprimiría la fecha actual en formato europeo (dia/mes/año)

III. Descripción técnica

Para que el sistema sea funcional para cualquier formato de fechas,
cada fecha introducida es convertida a formato "iso" (el que se usa
internamente) y una vez procesada la información se vuelve a reconvertir
al formato original (donde proceda).
Esto conlleva el inconveniente de caer en la redundancia de convertir
varias veces una fecha cuando dentro de una funcion se llama a otras
funciones de fechas.

IV. Bugs

No conocidos. Por favor reportelos a <cox@vulcanonet.com>

V. Como colaborar

- Buscando fallos
- Traduciendo esta documentacion a otro idiomas
- Añadiendo los nombres de dias y meses en otros idiomas
- Creando otras funciones que crea pueden servir a otros programadores

VI. Disclaimer

dates.php, no viene con niguna garantía y sus creadores no se responsabilizan
en ningún caso del daño perjudicado por el uso de este software.

VII. Acerca del autor y otros

El autor es Tomás V.V.Cox <cox@vulcanonet.com>



[prev in list] [next in list] [prev in thread] [next in thread]