Front page | perl.datetime |
Postings from January 2003
Some brief API requests
Thread Next
From:
John Siracusa
Date:
January 18, 2003 07:46
Subject:
Some brief API requests
Message ID:
BA4EE0D7.58819%siracusa@mindspring.com
(...while I'm catching up on the archives; forgive me if this has been
covered already)
Please, for the love of all that is good and holy, just say NO to method or
function names that begins with: "strf", "strp", or any variation thereof.
Also, please name the functions and methods in all lowercase, with words
separated by underscores--and name them after what they actually do! Yes,
years of writing UnixDate() to format dates and str2time() to parse dates
has made me quite bitter... ;)
From my reading so far, things seem to be on the right track, more or less.
But as someone else has already pointed out, try to keep the "date/time guru
vocabulary" out of the APIs to the extent that it is possible. If I don't
know what the "Gregorian" calendar is, I should never see that word in my
code. Ditto for (and this may be more controversial) the word "epoch."
(now back to my archive reading... :)
-John
Thread Next
-
Some brief API requests
by John Siracusa