/**
* date.php
*
- * Copyright (c) 1999-2003 The SquirrelMail Project Team
+ * Copyright (c) 1999-2004 The SquirrelMail Project Team
* Licensed under the GNU GPL. For full terms see the file COPYING.
*
* Takes a date and parses it into a usable format. The form that a
* <Tue,> 29 Jun 1999 09:52:11 -0500 (EDT)
* (as specified in RFC 822) -- 'Tue' is optional
*
- * $Id$
+ * @version $Id$
+ * @package squirrelmail
+ * @subpackage date
*/
+/** Load up some useful constants */
require_once(SM_PATH . 'functions/constants.php');
-/* corrects a time stamp to be the local time */
+/**
+ * Corrects a time stamp to be the local time.
+ *
+ * @param int stamp the timestamp to adjust
+ * @param string tzc the timezone correction
+ * @return int the corrected timestamp
+ */
function getGMTSeconds($stamp, $tzc) {
/* date couldn't be parsed */
if ($stamp == -1) {
case 'PST':
$tzc = '-0800';
break;
- case 'Mountain':
- case 'MST':
- case 'PDT':
- $tzc = '-0700';
+ case 'Mountain':
+ case 'MST':
+ case 'PDT':
+ $tzc = '-0700';
break;
case 'Central':
case 'CST':
- case 'MDT':
- $tzc = '-0600';
+ case 'MDT':
+ $tzc = '-0600';
break;
case 'Eastern':
case 'EST':
- case 'CDT':
- $tzc = '-0500';
+ case 'CDT':
+ $tzc = '-0500';
break;
case 'EDT':
$tzc = '-0400';
break;
- case 'GMT':
- $tzc = '+0000';
+ case 'GMT':
+ $tzc = '+0000';
break;
case 'BST':
case 'MET':
$tzc = '+0100';
break;
case 'EET':
- case 'IST':
- case 'MET DST':
- case 'METDST':
- $tzc = '+0200';
+ case 'IST':
+ case 'MET DST':
+ case 'METDST':
+ $tzc = '+0200';
break;
- case 'HKT':
- $tzc = '+0800';
+ case 'HKT':
+ $tzc = '+0800';
break;
- case 'JST':
+ case 'JST':
case 'KST':
- $tzc = '+0900';
+ $tzc = '+0900';
break;
}
$neg = false;
$hh = substr($tzc,1,2);
$mm = substr($tzc,3,2);
$iTzc = ($hh * 60 + $mm) * 60;
- if ($neg) $iTzc = -1 * (int) $iTzc;
+ if ($neg) $iTzc = -1 * (int) $iTzc;
/* stamp in gmt */
$stamp -= $iTzc;
/** now find what the server is at **/
$current = date('Z', time());
/* stamp in local timezone */
$stamp += $current;
-
+
return $stamp;
}
/**
- Switch system has been intentionaly chosen for the
- internationalization of month and day names. The reason
- is to make sure that _("") strings will go into the
- main po.
-**/
-
+ * Returns the (localized) string for a given day number.
+ * Switch system has been intentionaly chosen for the
+ * internationalization of month and day names. The reason
+ * is to make sure that _("") strings will go into the
+ * main po.
+ *
+ * @param int day_number the day number
+ * @return string the day in human readable form
+ */
function getDayName( $day_number ) {
switch( $day_number ) {
return( $ret );
}
+/**
+ * Like getDayName, but returns the short form
+ * @param int day_number the day number
+ * @return string the day in short human readable form
+ */
function getDayAbrv( $day_number ) {
switch( $day_number ) {
return( $ret );
}
+
+/**
+ * Returns the (localized) string for a given month number.
+ *
+ * @param string month_number the month number (01..12)
+ * @return string the month name in human readable form
+ */
function getMonthName( $month_number ) {
switch( $month_number ) {
case '01':
return( $ret );
}
+/**
+ * Returns the (localized) string for a given month number,
+ * short representation.
+ *
+ * @param string month_number the month number (01..12)
+ * @return string the shortened month in human readable form
+ */
function getMonthAbrv( $month_number ) {
switch( $month_number ) {
case '01':
return( $ret );
}
-
+/**
+ * Returns the localized representation of the date/time.
+ *
+ * @param string date_format The format for the date, like the input for the PHP date() function.
+ * @param int stamp the timestamp to convert
+ * @return string a full date representation
+ */
function date_intl( $date_format, $stamp ) {
-
- $ret = str_replace( 'D', '$1', $date_format );
- $ret = str_replace( 'F', '$2', $ret );
- $ret = str_replace( 'l', '$4', $ret );
- $ret = str_replace( 'M', '$5', $ret );
- $ret = date( '$3'. $ret . '$3', $stamp ); // Workaround for a PHP 4.0.4 problem
- $ret = str_replace( '$1', getDayAbrv( date( 'w', $stamp ) ), $ret );
- $ret = str_replace( '$5', getMonthAbrv( date( 'm', $stamp ) ), $ret );
- $ret = str_replace( '$2', getMonthName( date( 'm', $stamp ) ), $ret );
- $ret = str_replace( '$4', getDayName( date( 'w', $stamp ) ), $ret );
- $ret = str_replace( '$3', '', $ret );
-
+ $ret = str_replace( array('D','F','l','M'), array('$1','$2','$3','$4'), $date_format );
+ // to reduce the date calls we retrieve m and w in the same call
+ $ret = date('w#m#'. $ret, $stamp );
+ // extract day and month in order to replace later by intl day and month
+ $aParts = explode('#',$ret);
+ $ret = str_replace(array('$1','$4','$2','$3',), array(getDayAbrv($aParts[0]),
+ getMonthAbrv($aParts[1]),
+ getMonthName($aParts[1]),
+ getDayName($aParts[0])),
+ $aParts[2]);
return( $ret );
}
+/**
+ * This returns a date of the format "Wed, Oct 29, 2003 9:52 am",
+ * or the same in 24H format (depending on the user's settings),
+ * and taking localization into accout.
+ *
+ * @param int stamp the timestamp
+ * @return string the long date string
+ */
function getLongDateString( $stamp ) {
global $hour_format;
-
+
if ($stamp == -1) {
return '';
}
} else {
$date_format = _("D, F j, Y G:i");
}
-
+
return( date_intl( $date_format, $stamp ) );
}
+/**
+ * Returns a short representation of the date,
+ * taking timezones and localization into account.
+ * Depending on user's settings, this string can be
+ * of the form: "14:23" or "Jun 14, 2003" depending
+ * on whether the stamp is "today" or not.
+ *
+ * @param int stamp the timestamp
+ * @return string the date string
+ */
function getDateString( $stamp ) {
- global $invert_time, $hour_format;
+ global $invert_time, $hour_format, $show_full_date;
if ( $stamp == -1 ) {
return '';
}
-
+
$now = time();
-
+
$dateZ = date('Z', $now );
+
+ // FIXME: isn't this obsolete and introduced as a terrible workaround
+ // for bugs at other places which are fixed a long time ago?
if ($invert_time) {
$dateZ = - $dateZ;
}
$midnight = $now - ($now % 86400) - $dateZ;
-
- if ($midnight < $stamp) {
+ $nextmid = $midnight + 86400 - $dateZ;
+
+ if (($show_full_date == 1) || ($nextmid < $stamp)) {
+ $date_format = _("M j, Y");
+ } else if ($midnight < $stamp) {
/* Today */
if ( $hour_format == SMPREF_TIME_12HR ) {
$date_format = _("g:i a");
/* before this week */
$date_format = _("M j, Y");
}
-
+
return( date_intl( $date_format, $stamp ) );
}
+/**
+ * Decodes a RFC 822 Date-header into a timestamp
+ *
+ * @param array dateParts the Date-header split by whitespace
+ * @return int the timestamp calculated from the header
+ */
function getTimeStamp($dateParts) {
/** $dateParts[0] == <day of week> Mon, Tue, Wed
** $dateParts[1] == <day of month> 23
** and everything would be bumped up one.
**/
- /*
+ /*
* Simply check to see if the first element in the dateParts
* array is an integer or not.
* Since the day of week is optional, this check is needed.
*/
if (count($dateParts) <2) {
- return 0;
+ return -1;
+ } else if (count($dateParts) ==3) {
+ if (substr_count($dateParts[0],'-') == 2 &&
+ substr_count($dateParts[1],':') == 2) {
+ // dd-Month-yyyy 23:19:05 +0200
+ // redefine the date
+ $aDate = explode('-',$dateParts[0]);
+ $newDate = array($aDate[0],$aDate[1],$aDate[2],$dateParts[1],$dateParts[2]);
+ $dateParts = $newDate;
+ }
}
/* remove day of week */
return ($mtime);
}
*/
-?>
+?>
\ No newline at end of file
projects / squirrelmail.git / blobdiff