Gazelle/classes/time.class.php

<?
if (!extension_loaded('date')) {
  error('Date extension not loaded.');
}

function time_ago($TimeStamp) {
  if (!is_number($TimeStamp)) { // Assume that $TimeStamp is SQL timestamp
    if ($TimeStamp == '0000-00-00 00:00:00') {
      return false;
    }
    $TimeStamp = strtotime($TimeStamp);
  }
  if ($TimeStamp == 0) {
    return false;
  }
  return time() - $TimeStamp;
}

/*
 * Returns a <span> by default but can optionally return the raw time
 * difference in text (e.g. "16 hours and 28 minutes", "1 day, 18 hours").
 */
function time_diff($TimeStamp, $Levels = 2, $Span = true, $Lowercase = false) {
  if (!is_number($TimeStamp)) { // Assume that $TimeStamp is SQL timestamp
    if ($TimeStamp == '0000-00-00 00:00:00') {
      return 'Never';
    }
    $TimeStamp = strtotime($TimeStamp);
  }
  if ($TimeStamp == 0) {
    return 'Never';
  }
  $Time = time() - $TimeStamp;

  // If the time is negative, then it expires in the future.
  if ($Time < 0) {
    $Time = -$Time;
    $HideAgo = true;
  }

  $Years = floor($Time / 31556926); // seconds in one year
  $Remain = $Time - $Years * 31556926;

  $Months = floor($Remain / 2629744); // seconds in one month
  $Remain = $Remain - $Months * 2629744;

  $Weeks = floor($Remain / 604800); // seconds in one week
  $Remain = $Remain - $Weeks * 604800;

  $Days = floor($Remain / 86400); // seconds in one day
  $Remain = $Remain - $Days * 86400;

  $Hours=floor($Remain / 3600); // seconds in one hour
  $Remain = $Remain - $Hours * 3600;

  $Minutes = floor($Remain / 60); // seconds in one minute
  $Remain = $Remain - $Minutes * 60;

  $Seconds = $Remain;

  $Return = '';

  if ($Years > 0 && $Levels > 0) {
    $Return .= "$Years year".(($Years > 1) ? 's' : '' );
    $Levels--;
  }

  if ($Months > 0 && $Levels > 0) {
    $Return .= ($Return != '') ? ', ' : '';
    $Return .= "$Months month".(($Months > 1) ? 's' : '');
    $Levels--;
  }

  if ($Weeks > 0 && $Levels > 0) {
    $Return .= ($Return != '') ? ', ' : '';
    $Return .= "$Weeks week".(($Weeks > 1) ? 's' : '');
    $Levels--;
  }

  if ($Days > 0 && $Levels > 0) {
    $Return .= ($Return != '') ? ', ' : '';
    $Return .= "$Days day".(($Days > 1) ? 's' : '');
    $Levels--;
  }

  if ($Hours > 0 && $Levels > 0) {
    $Return .= ($Return != '') ? ', ' : '';
    $Return .= "$Hours hour".(($Hours > 1) ? 's' : '');
    $Levels--;
  }

  if ($Minutes > 0 && $Levels > 0) {
    $Return .= ($Return != '') ? ' and ' : '';
    $Return .= "$Minutes min".(($Minutes > 1) ? 's' : '');
  }

  if ($Return == '') {
    $Return = 'Just now';
  } elseif (!isset($HideAgo)) {
    $Return .= ' ago';
  }

  if ($Lowercase) {
    $Return = strtolower($Return);
  }

  if ($Span) {
    return '<span class="time tooltip" title="'.date('M d Y, H:i', $TimeStamp).'">'.$Return.'</span>';
  } else {
    return $Return;
  }
}

/* SQL utility functions */

function time_plus($Offset) {
  return date('Y-m-d H:i:s', time() + $Offset);
}

function time_minus($Offset, $Fuzzy = false) {
  if ($Fuzzy) {
    return date('Y-m-d 00:00:00', time() - $Offset);
  } else {
    return date('Y-m-d H:i:s', time() - $Offset);
  }
}

// This is never used anywhere with $timestamp set
// TODO: Why don't we just use NOW() in the sql queries?
function sqltime($timestamp = NULL) {
  return date('Y-m-d H:i:s', ($timestamp ?? time()));
}

function validDate($DateString) {
  $DateTime = explode(' ', $DateString);
  if (count($DateTime) != 2) {
    return false;
  }
  list($Date, $Time) = $DateTime;
  $SplitTime = explode(':', $Time);
  if (count($SplitTime) != 3) {
    return false;
  }
  list($H, $M, $S) = $SplitTime;
  if ($H != 0 && !(is_number($H) && $H < 24 && $H >= 0)) { return false; }
  if ($M != 0 && !(is_number($M) && $M < 60 && $M >= 0)) { return false; }
  if ($S != 0 && !(is_number($S) && $S < 60 && $S >= 0)) { return false; }
  $SplitDate = explode('-', $Date);
  if (count($SplitDate) != 3) {
    return false;
  }
  list($Y, $M, $D) = $SplitDate;
  return checkDate($M, $D, $Y);
}

function is_valid_date($Date) {
  return is_valid_datetime($Date, 'Y-m-d');
}

function is_valid_time($Time) {
  return is_valid_datetime($Time, 'H:i');
}

function is_valid_datetime($DateTime, $Format = 'Y-m-d H:i') {
  $FormattedDateTime = DateTime::createFromFormat($Format, $DateTime);
  return $FormattedDateTime && $FormattedDateTime->format($Format) == $DateTime;
}

?>