Happy New Year
[squirrelmail.git] / functions / date.php
index 8be003ac0deeea19628ecea8afe8075ac8b5a00b..dbd482ab48b6abd140139332a1e29ec82ff44f68 100644 (file)
@@ -8,7 +8,7 @@
  *       <Tue,> 29 Jun 1999 09:52:11 -0500 (EDT)
  * (as specified in RFC 822) -- 'Tue' is optional
  *
- * @copyright 1999-2012 The SquirrelMail Project Team
+ * @copyright 1999-2020 The SquirrelMail Project Team
  * @license http://opensource.org/licenses/gpl-license.php GNU Public License
  * @version $Id$
  * @package squirrelmail
@@ -334,10 +334,17 @@ function getLongDateString( $stamp, $fallback = '' ) {
  * of the form: "14:23" or "Jun 14, 2003" depending
  * on whether the stamp is "today" or not.
  *
- * @param int stamp the timestamp
+ * @param int $stamp The timestamp
+ * @param boolean $return_full_date_and_time When TRUE,
+ *                                           ignore all
+ *                                           user settings
+ *                                           and use full
+ *                                           date and time
+ *                                           (OPTIONAL;
+ *                                           default FALSE)
  * @return string the date string
  */
-function getDateString( $stamp ) {
+function getDateString( $stamp, $return_full_date_and_time=FALSE ) {
 
     global $invert_time, $hour_format, $show_full_date, $custom_date_format;
 
@@ -366,7 +373,14 @@ function getDateString( $stamp ) {
     $nextmid = $midnight + 86400;
 
     $custom_date_format = trim($custom_date_format);
-    if (!empty($custom_date_format)) {
+
+    if ($return_full_date_and_time) {
+        if ( $hour_format == SMPREF_TIME_12HR ) {
+            $date_format = _("D, F j, Y g:i a");
+        } else {
+            $date_format = _("D, F j, Y H:i");
+        }
+    } else if (!empty($custom_date_format)) {
         $date_format = $custom_date_format;
     } else if ($show_full_date == 1 || $nextmid < $stamp) {
         $date_format = _("M j, Y");