[Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[Richard Jones]

[-- Attachment #1: Type: text/plain, Size: 1169 bytes --]

I'm pleased to announce GregorianDate, which is a pure Objective CAML
library for handling calculations on the Gregorian calendar.

http://www.merjis.com/developers/gregorian_date

This is version 1.0.0, which is mature, stable and widely used (by
me).  The library is released under the GNU LGPL with OCaml linking
exception.

Example:

$ ocaml -I +gregoriandate
        Objective Caml version 3.08.1

# #load "gregorianDate.cma";;
# open GregorianDate;;
# days_in_year 2004;;
- : int = 366
# business_of_standard (2004, 10, 24);;
- : (int * int) * int = ((2004, 43), 7)
# easter_sunday 2005;;
- : int * int * int = (2005, 3, 27)
# day_of_week (2004, 10, 24);;
- : int = 7
# nth_weekday_of_month (2004, 10) 7 4;;
- : int * int * int = (2004, 10, 24)
# add_delta_days (2004, 10, 24) 100;;
- : int * int * int = (2005, 2, 1)

etc.

Rich.

-- 
Richard Jones.  http://www.annexia.org/  http://www.j-london.com/
>>>   http://www.team-notepad.com/ - collaboration tools for teams   <<<
Merjis Ltd. http://www.merjis.com/ - improving website return on investment
Write Apache modules in OCaml - http://www.merjis.com/developers/mod_caml

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[Richard Jones]

[-- Attachment #1: Type: text/plain, Size: 2134 bytes --]

On Sun, Oct 24, 2004 at 04:31:59PM -0400, William Lovas wrote:
> On Sun, Oct 24, 2004 at 08:07:32PM +0100, Richard Jones wrote:
> > I'm pleased to announce GregorianDate, which is a pure Objective CAML
> > library for handling calculations on the Gregorian calendar.
> 
> This looks cool, but i have a few suggestions.  First, it needs some online
> documentation (beyond the examples), preferrably in ocamldoc format.

Yes, you're right, but I'm quite busy at the moment.  There is
ocamldoc documentation in the tarball itself, and for an online
reference you should look at:

http://search.cpan.org/dist/Date-Calc/Calc.pod#DESCRIPTION

The API is pretty much identical, except that I have omitted Steffen's
time functions which really don't belong in this library.

> In
> particular, the following examples weren't transparent to me (a date
> non-specialist):
> 
> > # business_of_standard (2004, 10, 24);;
> > - : (int * int) * int = ((2004, 43), 7)
[Sunday (7) in week 43 of year 2004.]
> > # nth_weekday_of_month (2004, 10) 7 4;;
> > - : int * int * int = (2004, 10, 24)
[Calculate the 4th Sunday (7) in October 2004.]
>
> I don't know what a "business" date is, and 10-24-2004 isn't a weekday.
> Actually, i think i just understood "nth_weekday_of_month", but
> documentation would certainly have been helpful.

For reference, business weeks are defined in ISO 8601, and you can
find a synopsis here:

http://www.cl.cam.ac.uk/~mgk25/iso-time.html

> > # day_of_week (2004, 10, 24);;
> > - : int = 7
> > etc.
> 
> Also, you might consider enriching the interface with some types: i'd say
> at least that day of the week ought to be a variant.  This not only makes
> thing safer, but also makes the intended behavior of functions like
> "nth_weekday_of_month" more apparent.

Rich.

-- 
Richard Jones.  http://www.annexia.org/  http://www.j-london.com/
>>>   http://www.team-notepad.com/ - collaboration tools for teams   <<<
Merjis Ltd. http://www.merjis.com/ - improving website return on investment
Write Apache modules in OCaml - http://www.merjis.com/developers/mod_caml

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[james woodyatt]

On 24 Oct 2004, at 12:07, Richard Jones wrote:
>
> I'm pleased to announce GregorianDate, which is a pure Objective CAML
> library for handling calculations on the Gregorian calendar.
>
> http://www.merjis.com/developers/gregorian_date
>
> This is version 1.0.0, which is mature, stable and widely used (by
> me).  The library is released under the GNU LGPL with OCaml linking
> exception.

Similar functions [with different signatures] are also available in the 
Cf_date module, along with lots of other goodies, distributed in the 
"cf" package of the OCaml Network Application Environment 
(http://sf.net/projects/ocnae/).

The Cf package is distributed under a 2-clause BSD license, and it 
comes with Ocamldoc generated HTML pages.  Download from the 
SourceForge site.


-- 
j h woodyatt <jhw@wetware.com>
markets are only free to the people who own them.

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners

Re: [Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[Julien Signoles]

On Sun, 24 Oct 2004, Richard Jones wrote:

> I'm pleased to announce GregorianDate, which is a pure Objective CAML
> library for handling calculations on the Gregorian calendar.
>
> http://www.merjis.com/developers/gregorian_date
>
> This is version 1.0.0, which is mature, stable and widely used (by
> me).  The library is released under the GNU LGPL with OCaml linking
> exception.

What are the differences with the module Date of the "calendar" library ?

        http://www.lri.fr/~signoles/prog.en.html

This library is also a pure OCaml library and released under the GNU
LGLP.
The aims of both libraries seem to be identical. An ocamldoc documentation
of calendar is available at:

        http://www.lri.fr/~signoles/calendar/doc

Julien
-- 
mailto:Julien.Signoles@lri.fr ; http://www.lri.fr/~signoles
"In theory, practice and theory are the same,
but in practice they are different" (Larry McVoy)

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners

Re: [Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[N. Owen Gunden]

On Mon, Oct 25, 2004 at 02:06:52PM +0200, Julien Signoles wrote:
> On Sun, 24 Oct 2004, Richard Jones wrote:
> > I'm pleased to announce GregorianDate [...]
> 
> What are the differences with the module Date of the "calendar" library ?
> 
>         http://www.lri.fr/~signoles/prog.en.html

I've a stake in this question too, as the maintainer for the calendar
godi package.  It sure would be nice if the effort was merged into one
UberCalendar so there would be no question which package to use.

 - O

Re: [Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[N. Owen Gunden]

Bump.  Rich?

On Mon, Oct 25, 2004 at 10:11:43PM -0400, N. Owen Gunden wrote:
> On Mon, Oct 25, 2004 at 02:06:52PM +0200, Julien Signoles wrote:
> > On Sun, 24 Oct 2004, Richard Jones wrote:
> > > I'm pleased to announce GregorianDate [...]
> > 
> > What are the differences with the module Date of the "calendar" library ?
> > 
> >         http://www.lri.fr/~signoles/prog.en.html
> 
> I've a stake in this question too, as the maintainer for the calendar
> godi package.  It sure would be nice if the effort was merged into one
> UberCalendar so there would be no question which package to use.
> 
>  - O
> _______________________________________________
> Caml-list mailing list. Subscription management:
> http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
> Archives: http://caml.inria.fr
> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
> Bug reports: http://caml.inria.fr/bin/caml-bugs
> 

-- 
The USA needs election reform!
http://www.approvalvoting.com/

Re: [Caml-list] ANNOUNCE: Library for handling Gregorian date calculations

[Richard Jones]

[-- Attachment #1: Type: text/plain, Size: 585 bytes --]

On Thu, Oct 28, 2004 at 11:33:30PM -0400, N. Owen Gunden wrote:
> Bump.  Rich?

Ah, sorry - this discussion moved to ocaml-lib-devel.  I cc'd
caml-list, but it seems to have been spam filterered.

http://sourceforge.net/mailarchive/forum.php?thread_id=5833296&forum_id=29880

Rich.

-- 
Richard Jones.  http://www.annexia.org/  http://www.j-london.com/
>>>   http://www.team-notepad.com/ - collaboration tools for teams   <<<
Merjis Ltd. http://www.merjis.com/ - improving website return on investment
Use Perl libs in OCaml - http://www.merjis.com/developers/perl4caml

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]