/** * Format a date * * Accept either a time stamp, or a formatted string as input parameter: * - YYYY-MM-DD HH:MM:SS * - YYMMDD HH:MM:SS GMT * * The variant is processed as follows: * - 'day' - only day, month and year --no time information * - 'with_hour' - adapts to time scale, and mention hours for today and yesterday * - 'no_hour' - adapts to time scale, but don't mention hours * - 'full' - display the full date * - 'month' - only month and year * - 'publishing' - allows for smart skinning * - 'standalone' - like full, but without the 'on ' prefix * - 'iso8601' - special format * - 'plain' - example 'Feb 26 2010 22:30:31 GMT' * - 'yyyy-mm-dd' - only day, month and year --no time information * * The date provided is considered to be GMT-based. * It is adjusted to the time zone of the surfer, if applicable. * This adjustment does not apply to following variants: * - 'day' * - 'iso8601' * - 'standalone' * * * @link http://www.w3.org/TR/NOTE-datetime the w3c profile of ISO 8601 * @link http://www.cs.tut.fi/~jkorpela/iso8601.html short description of ISO 8601 * @link http://fr2.php.net/date Code for ISO 8601 formatting * * @param int or string the date to be displayed * @param string the variant * @param string the language to express this stamp * @param int offset to GMT of the provided date, if any * @return the HTML to be used */ public static function &build_date($stamp, $variant = 'with_hour', $language = NULL, $gmt_offset = 0) { global $context, $local; // return by reference $output = ''; // sanity check if (!isset($stamp) || !$stamp) { return $output; } // surfer offset, except on 'day' and 'iso8601' if ($variant == 'day' || $variant == 'iso8601' || $variant == 'standalone' || $variant == 'local') { $surfer_offset = 0; } else { $surfer_offset = Surfer::get_gmt_offset(); } // YYMMDD-HH:MM:SS GMT -- this one is natively GMT if (preg_match('/GMT$/', $stamp) && strlen($stamp) == 19) { // YYMMDD-HH:MM:SS GMT -> HH, MM, SS, MM, DD, YY $actual_stamp = mktime(substr($stamp, 7, 2), substr($stamp, 10, 2), substr($stamp, 13, 2), substr($stamp, 2, 2), substr($stamp, 4, 2), substr($stamp, 0, 2)); // adjust to surfer time zone $actual_stamp += $surfer_offset * 3600; // time()-like stamp } elseif (intval($stamp) > 10000000) { // adjust to surfer time zone $actual_stamp = intval($stamp) + ($surfer_offset - $gmt_offset) * 3600; // YYYY-MM-DD HH:MM:SS, or a string that can be readed } elseif (($actual_stamp = strtotime($stamp)) != -1) { // adjust to surfer time zone $actual_stamp += ($surfer_offset - $gmt_offset) * 3600; } else { $output = '*' . $stamp . '*'; return $output; } if (!($items = @getdate($actual_stamp))) { $output = '*' . $stamp . '*'; return $output; } // if undefined language, use preferred language for absolute formats if ($language) { } elseif ($variant == 'full' || $variant == 'iso8601' || $variant == 'local') { $language = $context['preferred_language']; } else { $language = $context['language']; } // in French '1' -> '1er' if ($language == 'fr' && $items['mday'] == 1) { $items['mday'] = '1er'; } // allow for months localization through i18n $months = array('*', i18n::s('Jan.'), i18n::s('Feb.'), i18n::s('Mar.'), i18n::s('Apr.'), i18n::s('May'), i18n::s('June'), i18n::s('Jul.'), i18n::s('Aug.'), i18n::s('Sep.'), i18n::s('Oct.'), i18n::s('Nov.'), i18n::s('Dec.')); // load month labels adapted to required language $months = array('*', i18n::lookup($context['l10n'][$language], 'Jan.'), i18n::lookup($context['l10n'][$language], 'Feb.'), i18n::lookup($context['l10n'][$language], 'Mar.'), i18n::lookup($context['l10n'][$language], 'Apr.'), i18n::lookup($context['l10n'][$language], 'May'), i18n::lookup($context['l10n'][$language], 'June'), i18n::lookup($context['l10n'][$language], 'Jul.'), i18n::lookup($context['l10n'][$language], 'Aug.'), i18n::lookup($context['l10n'][$language], 'Sep.'), i18n::lookup($context['l10n'][$language], 'Oct.'), i18n::lookup($context['l10n'][$language], 'Nov.'), i18n::lookup($context['l10n'][$language], 'Dec.')); // now $now = time(); // server actual offset -- provided as a parameter // $gmt_offset = intval((strtotime(date('M d Y H:i:s')) - strtotime(gmdate('M d Y H:i:s'))) / 3600); // server stamp, as seen by surfer $today = getdate($now + ($surfer_offset - $gmt_offset) * 3600); // time stamp only if (preg_match('/00:00/', date('H:i', $actual_stamp))) { $time = ''; } else { $trailer = ''; if (!$surfer_offset && $variant !== 'local') { $trailer = ' GMT'; } $time = sprintf(i18n::s(' at %s%s'), date(i18n::s('h:i a'), $actual_stamp), $trailer); } // format a date as an absolute string if ($variant == 'full' || $variant == 'local') { if ($language == 'fr') { $output .= $items['mday'] . ' ' . $months[$items['mon']] . ' ' . $items['year'] . $time; } else { $output .= $months[$items['mon']] . ' ' . $items['mday'] . ' ' . $items['year'] . $time; } return $output; } // publishing date is in the future if ($variant == 'publishing' && strcmp($stamp, $context['now']) > 0) { $output .= DRAFT_FLAG; } // allow for smart skinning -- http://www.wplover.com/1449/easier-date-display-technique-with-css-3/ if ($variant == 'publishing') { $output .= '<span class="day">' . $items['mday'] . '</span>' . '<span class="month">' . $months[$items['mon']] . '</span>' . '<span class="year">' . $items['year'] . '</span>'; return $output; } // the same, but without prefix if ($variant == 'standalone') { if ($language == 'fr') { $output .= $items['mday'] . ' ' . $months[$items['mon']] . ' ' . $items['year'] . $time; } else { $output .= $months[$items['mon']] . ' ' . $items['mday'] . ' ' . $items['year'] . $time; } return $output; } // month only if ($variant == 'month') { if ($language == 'fr') { $output .= $months[$items['mon']] . ' ' . $items['year']; } else { $output .= $months[$items['mon']] . ' ' . $items['year']; } return $output; } // day only if ($variant == 'day') { // same year, don't mention it if ($items['year'] == $today['year']) { if ($language == 'fr') { $output .= $items['mday'] . ' ' . $months[$items['mon']]; } else { $output .= $months[$items['mon']] . ' ' . $items['mday']; } // different year } else { if ($language == 'fr') { $output .= $items['mday'] . ' ' . $months[$items['mon']] . ' ' . $items['year']; } else { $output .= $months[$items['mon']] . ' ' . $items['mday'] . ' ' . $items['year']; } } return $output; } // in a calendar if ($variant == 'calendar') { include_once $context['path_to_root'] . 'dates/dates.php'; $month_link =& Skin::build_link(Dates::get_url($items['year'] . '/' . $items['mon'], 'month'), $months[$items['mon']], 'basic', i18n::s('Calendar of this month')); $year_link =& Skin::build_link(Dates::get_url($items['year'], 'year'), $items['year'], 'basic', i18n::s('Calendar of this year')); if ($language == 'fr') { $output .= $items['mday'] . ' ' . $month_link . ' ' . $year_link; } else { $output .= $month_link . ' ' . $items['mday'] . ' ' . $year_link; } return $output; } // format a date according to ISO 8601 format if ($variant == 'iso8601') { $tzd = date('O', $actual_stamp); $tzd = $tzd[0] . str_pad((int) ($tzd / 100), 2, "0", STR_PAD_LEFT) . ':' . str_pad((int) ($tzd % 100), 2, "0", STR_PAD_LEFT); $output = date('Y-m-d\\TH:i:s', $actual_stamp) . $tzd; return $output; } // format a raw date if ($variant == 'yyyy-mm-dd') { $output = date('Y-m-d', $actual_stamp); return $output; } // plain date if ($variant == 'plain') { $output = date('M d Y H:i:s', $actual_stamp) . ' GMT'; return $output; } // less than 24 hours if ($items['yday'] == $today['yday'] && $items['year'] == $today['year']) { $time = date('H:i', $actual_stamp); if ($variant == 'no_hour' || preg_match('/00:00/', $time)) { $local['today_en'] = 'today'; $local['today_fr'] = 'aujourd\'hui'; } else { $trailer = ''; if (!$surfer_offset) { $trailer = ' GMT'; } $local['today_en'] = 'today at ' . date('h:i a', $actual_stamp) . $trailer; $local['today_fr'] = 'aujourd\'hui à ' . date('H:i', $actual_stamp) . $trailer; } $output = i18n::user('today'); return $output; // less than 48 hours } elseif ($items['yday'] + 1 == $today['yday'] && $items['year'] == $today['year']) { $time = date('H:i', $actual_stamp); if ($variant == 'no_hour' || preg_match('/00:00/', $time)) { $local['yesterday_en'] = 'yesterday'; $local['yesterday_fr'] = 'hier'; } else { $trailer = ''; if (!$surfer_offset) { $trailer = ' GMT'; } $local['yesterday_en'] = 'yesterday at ' . date('h:i a', $actual_stamp) . $trailer; $local['yesterday_fr'] = 'hier à ' . date('H:i', $actual_stamp) . $trailer; } $output = i18n::user('yesterday'); return $output; // this year } elseif ($stamp <= $now && $items['year'] == $today['year']) { if ($language == 'fr') { $output .= 'le ' . $items['mday'] . ' ' . $months[$items['mon']]; } else { $output .= 'on ' . $months[$items['mon']] . ' ' . $items['mday']; } return $output; // date in fr: le dd mmm yy } elseif ($language == 'fr') { $output .= 'le ' . $items['mday'] . ' ' . $months[$items['mon']] . ' ' . $items['year']; // date in en: on mmm dd yy } else { $output .= 'on ' . $months[$items['mon']] . ' ' . $items['mday'] . ' ' . $items['year']; } $output .= $time ? ' ' . $time : ''; return $output; }
/** * get a localized string for a surfer * * This function is an equivalent to gettext(), except it deals with surfer localization. * * @param string the template string to be translated * @return string the localized string, if any */ public static function &s($text) { global $context; // sanity check if (!$text) { return $text; } // select language used by surfer if (isset($context['language'])) { $locale = $context['language']; } else { $locale = 'en'; } // cache is empty if (!isset($context['l10n']) || !isset($context['l10n'][$locale]) || !is_array($context['l10n'][$locale])) { return $text; } // provide the localized string $text =& i18n::lookup($context['l10n'][$locale], $text); return $text; }