C:/usr/local/lib/php/blueshoes-4.2/core/date/Bs_Date.class.phpandrej arnThis static class provides many useful date and time methods.This is new, untested code! please test the return values of the methods you're goingto use... and make some comments in the methods you've used successfully. otherwise tell the author.there are the following ways to write dates and times:1) the unix timestampeg 982591823 for 2001-02-19 15:10:23some notes about the unix timestamp:This timestamp is a long integer containing the number of seconds between the Unix Epoch (January 1 1970)and the time specified.On systems where time_t is a 32bit signed integer, as most common today, the valid range for year is somewherebetween 1902 and 2037.Year may be a two or four digit value, with values between 0-69 mapping to 2000-2069 and 70-99 to 1970-1999.2) us datetimeeg 2001/02/19 15:10:23 (there is also mm.dd.yyyy and mm.dd.yy which makes it terrible.)3) eu datetimeeg 19.02.2001 15:10:234) sql datetimeeg 2001-02-19 15:10:235) sql timestampeg 200102191510236) mysql datetimeeg 2001-02-19 15:10:23 (actually mysql takes any special character instead of the '-'.)7) 'array'array('year'=>'2002', 'month'=>'12', 'day'=>'31', 'hour'=>'24', 'min'=>'59', 'sec'=>'59');the values are stored as strings, not numbers. this way we can have '03' instead of '3' fora month for example.the problem starts when ppl type in 19.2.01 and things like that, or don't use the expectedpunctuation like "." for eu dates and "/" for us dates.while unix treats 0-69 as year 2000 and 70-99 as year 1900, we do it different here!0-29 is considered 2000 and 30-99 is considered 1999. (because of the birthdays).i think it happens way more often that someone has to type in a birthday and just types 10.3.45instead someone typing in 10.3.45 when he means an event on 10.3.2045. anyway... please be strictand don't accept 2-digit year values from user input. reject it! this is only the fallback...todo: add functionality to let the user define the year-range himself (what is 1900 and what is2000).to make things easier, when converting from one date type to another, like from us to eu, weconvert it to a unix timestamp internally. this might be a problem for dates outside thetimestamp range (January 1 1970 - 2037) ... phew ... should we change this behavior? i think yes.dependencies: Bs_String**********************************************************************4.0.$id$blueshoes.orgconstructor.current datetime in us style.this function is an alias for this->formatUnixTimestamp('us-1')returns the current datetime in us style.how the datetime should be returned. getFormatForStyle(). default is 'eu-2'.(a unix timestamp or none. none means 'use the current date/time'.)this method uses getFormatForStyle().returns a unix timestamp formatted as a datetime, eg 982591823 -> 19.02.2001 15:10:23.how the datetime should be returned. getFormatForStyle(). default is 'eu-2'.(none means 'use the current date/time'.)this method uses getFormatForStyle().returns a date-array formatted as a date, time or datetime.(see above)possible values for the $style param:'eu-1' -> dd.mm.yyyy hh:mm:ss'eu-2' -> dd.mm.yyyy hh:mm'eu-3' -> dd.mm.yyyy'eu-4' -> hh:mm:ss'eu-5' -> hh:mm'us-1' -> yyyy/mm/dd hh:mm:ss'us-2' -> yyyy/mm/dd hh:mm'us-3' -> yyyy/mm/dd'us-4' -> hh:mm:ss'us-5' -> hh:mm'sql-1' -> yyyy-mm-dd hh:mm:ss'sql-2' -> yyyy-mm-dd hh:mm'sql-3' -> yyyy-mm-dd'sql-4' -> hh:mm:ss'sql-5' -> hh:mm'ts-1' -> yyyymmddhhmmsstakes a style definition and returns the format for it. see below.formatUnixTimestamp()how the datetime should be returned. see below. default is 'eu-2'.a us datetime or none. none means 'use the current date/time'.this method makes use of formatUnixTimestamp(), so watch out for the $style options.returns a us datetime formatted as any datetime, eg 1999/08/27 13:39:36 -> 27.08.1999 13:39:36formatUnixTimestamp()how the datetime should be returned. see below. default is 'eu-2'.a eu datetime or none. none means 'use the current date/time'.this method makes use of formatUnixTimestamp(), so watch out for the $style options.returns a eu datetime formatted as any datetime, eg 27.8.1999 13:39:36 -> 1999/08/27 13:39:36formatUnixTimestamp()how the datetime should be returned. see below. default is 'eu-2'.a sql datetime or none. none means 'use the current date/time'.this method makes use of formatUnixTimestamp(), so watch out for the $style options.returns a sql datetime formatted as any datetime, eg 1999-08-27 13:39:36 -> 27.8.1999 13:39:36formatUnixTimestamp()how the datetime should be returned. see below. default is 'eu-2'.a sql timestamp or none. none means 'use the current date/time'.this method makes use of formatUnixTimestamp(), so watch out for the $style options.returns a mysql timestamp formatted as a datetime, eg 19990827133936 -> 27.08.1999 13:39:36unix timestamp this method required Bs_String.converts an sql timestamp into a unix timestamp. eg 20010219151023 -> 982591823unix timestampthis function gets used by usDateToUnixTimestamp(), euDateToUnixTimestamp(), sqlDateToUnixTimestamp()because the time looks the same in all of these versions (us, eu, sql).the day, month and year of the returned timestamp will be from the current date.we are using php's built in strToTime(). hope it will get better... but should be ok for the time stuff.converts a time into a unix timestamp. 15:10:23 -> 984665423unix timestampwe are using php's built in strToTime(). hope it will get better...converts a us datetime into a unix timestamp. eg 2001/02/19 15:10:23 -> 982591823unix timestampwe are using php's built in strToTime(). hope it will get better...converts a us date into a unix timestamp. eg 2001/02/19 ->timeToUnixTimestamp()unix timestampbecause the time looks the same in all versions (us, eu, sql) all these methods are using timeToUnixTimestamp().converts a us time into a unix timestamp. 15:10:23 ->unix timestamp-1we are using php's built in strToTime(). hope it will get better...converts a sql datetime into a unix timestamp. eg 2001-02-19 15:10:23 -> 982591823unix timestampbool falsewe are using php's built in strToTime(). hope it will get better...converts a sql date into a unix timestamp. eg 2001-02-19 ->timeToUnixTimestamp()unix timestampbecause the time looks the same in all versions (us, eu, sql) all these methods are using timeToUnixTimestamp().converts a sql time into a unix timestamp. 15:10:23 ->unix timestampwe are NOT using php's built in strToTime() because it returns wrong dates for eu dates :(at least until now, 2001/02/20. hope it will improve. so we use some own php code.for the date part, we use our own euDateToUnixTimestamp() method. then we create a us date withformatUnixTimestamp(). finally we convert the us date together with the time part to a timestampusing usDatetimeToUnixTimestamp().i have tested it and a) performance is definitely NOT an issue, and b) it works quite well, evenwith a date like "15.3.1999 10:26:10" (note the extra spaces in the middle).converts a eu datetime into a unix timestamp. eg 19.2.2001 15:10:23 -> 982591823sqlDateToArray()(31.12.2002)bool FALSE (not a valid date. eg wrong syntaxor 31.03.2002)this method does not use the unix-timestamp, so there is no limitation in the time range.converts a eu date into an array.euDateToArray()(2002-12-31)bool FALSE (not a valid date. eg wrong syntaxor 2002-03-31)this method does not use the unix-timestamp, so there is no limitation in the time range.converts a sql date into an array. (char)bool FALSE (nothing found)example: 2002/12/31 => /31.12.2002 => .tries to find the separator used in a date.(hash) (hash)if these keys don't exist, they'll be added:'year', 'month', 'day', 'hour', 'min', 'sec'takes a date array and cleans its elements.unix timestampwe are NOT using php's built in strToTime() because it returns wrong dates for eu dates :(at least until now, 2001/02/20. hope it will improve. so we use some own php code.converts a eu date into a unix timestamp. eg 19.2.2001 -> 982591823timeToUnixTimestamp()unix timestampbecause the time looks the same in all versions (us, eu, sql) all these methods are using timeToUnixTimestamp().converts a eu time into a unix timestamp. 15:10:23 ->eu datetimeconverts a us datetime into a european datetimeeu datebs_exception or -1both is possible.converts a us date into a european datesql datetimeconverts a us datetime into a sql datetimesql dateconverts a us date into a sql dateus datetimeconverts a eu datetime into a us datetimeus dateconverts a eu date into a us datesql datetimeconverts a eu datetime into a sql datetimesql dateconverts a eu date into a sql dateus datetimeconverts a sql datetime into a us datetime eg '2001-02-28 20:54:23' -> '2001/02/28 20:54:23'us dateconverts a sql date into a us dateeu datetimeconverts a sql datetime into a european datetimeeu dateconverts a sql date into a eu dateif set to TRUE, the return value is a 2 char string. default is FALSE. (int 1 to 12 or string '01' to '12' depending on $zeroFill)int 0 (if not knownno match. does *not* return '00' if $zeroFill is TRUE.)takes the param $month in the languages:- english en - danish da- french fr - italian it- german de - spanish es- dutch nl - portuguese ptyou don't need to "normalize" strings, eg 'février' to 'fevrier'.for details see db-table bs_kb.LangMonth.converts a month like 'Feb' or 'February' into a numerical month value (2).use monthStringToNumber instead.the iso-code, default is 'en'. see above.one of 'long' (default) or 'short'.bool FALSEthe following languages are supported: enexample:$month = monthNumberToString(12); //returns 'December'$month = monthNumberToString(12, 'en', $type='short'); //returns 'Dec'converts a numerical month value to a string.reference to the global pseudostatic Bs_String object.4.0.$x$isexisexceptiontostringtohtmlpersistunpersistbs_objectbbsetoutputbbawakebbisawakebbxmsgbbxfunctionstartbbxfunctionendbbxechobbxvarbbxvardumpbbforcetracebbbufferstartbbbuffergetbbbufferendflushbbbufferendcleanbs_object_versionBs_ObjectBs_Object