Sindbad~EG File Manager

<?php
/**
 * Format Utility
 *
 * @package   PopupMaker
 * @copyright Copyright (c) 2024, Code Atlantic LLC
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class PUM_Utils_Format
 */
class PUM_Utils_Format {

	/**
	 * Format timestamp based on specified format
	 *
	 * @param int|string $time Unix timestamp or date string
	 * @param string     $format Format type: 'U' for timestamp, 'human'/'human-readable' for readable format
	 * @return ($format is 'human'|'human-readable' ? string : int|false) Formatted time or false on failure
	 */
	public static function time( $time, $format = 'U' ) {
		if ( ! PUM_Utils_Time::is_timestamp( $time ) ) {
			$time = strtotime( (string) $time );
			if ( false === $time ) {
				return false;
			}
		}

		$time = (int) $time;

		switch ( $format ) {
			case 'human':
			case 'human-readable':
				return self::human_time( $time );

			default:
			case 'U':
				return $time;
		}
	}


	/**
	 * Format number based on specified format
	 *
	 * @param int|float|string $number Number to format
	 * @param string           $format Format type (currently only 'abbreviated' supported)
	 * @return int|string Formatted number as integer for small values or string for abbreviated
	 */
	public static function number( $number, $format = '' ) {
		switch ( $format ) {
			default:
			case 'abbreviated':
				return self::abbreviated_number( $number );
		}
	}


	/**
	 * Convert the timestamp to a nice time format
	 *
	 * @param int      $time Unix timestamp to format
	 * @param int|null $current Current timestamp for comparison (defaults to current time)
	 * @return string Human-readable time difference (filtered through WordPress)
	 */
	public static function human_time( $time, $current = null ) {
		if ( empty( $current ) ) {
			$current = time();
		}

		$diff = (int) abs( $current - $time );

		if ( $diff < 60 ) {
			$since = sprintf(
				/* translators: 1: Number of seconds. */
				__( '%ss', 'popup-maker' ),
				$diff
			);
		} elseif ( $diff < HOUR_IN_SECONDS ) {
			$mins = round( $diff / MINUTE_IN_SECONDS );
			if ( $mins <= 1 ) {
				$mins = 1;
			}
			$since = sprintf(
				/* translators: 1: Number of minutes. */
				__( '%smin', 'popup-maker' ),
				$mins
			);
		} elseif ( $diff < DAY_IN_SECONDS && $diff >= HOUR_IN_SECONDS ) {
			$hours = round( $diff / HOUR_IN_SECONDS );
			if ( $hours <= 1 ) {
				$hours = 1;
			}
			$since = sprintf(
				/* translators: 1: Number of hours. */
				__( '%shr', 'popup-maker' ),
				$hours
			);
		} elseif ( $diff < WEEK_IN_SECONDS && $diff >= DAY_IN_SECONDS ) {
			$days = round( $diff / DAY_IN_SECONDS );
			if ( $days <= 1 ) {
				$days = 1;
			}
			$since = sprintf(
				/* translators: 1: Number of days. */
				__( '%sd', 'popup-maker' ),
				$days
			);
		} elseif ( $diff < MONTH_IN_SECONDS && $diff >= WEEK_IN_SECONDS ) {
			$weeks = round( $diff / WEEK_IN_SECONDS );
			if ( $weeks <= 1 ) {
				$weeks = 1;
			}
			$since = sprintf(
				/* translators: 1: Number of weeks. */
				__( '%sw', 'popup-maker' ),
				$weeks
			);
		} else {
			$since = '';
		}

		return apply_filters( 'pum_human_time_diff', $since, $diff, $time, $current );
	}

	/**
	 * K, M number formatting for large numbers
	 *
	 * @param int|float|string $n Number to abbreviate
	 * @param non-empty-string $point Decimal point character
	 * @param non-empty-string $sep Thousands separator character
	 * @return int|string Returns 0 for negative or non-numeric values, formatted string for all positive values (e.g., "1.5K", "2.3M", "9,999")
	 */
	public static function abbreviated_number( $n, $point = '.', $sep = ',' ) {
		// Convert to float and validate
		$n = (float) $n;

		// Check if the conversion resulted in a valid number
		if ( ! is_numeric( $n ) || $n < 0 ) {
			return 0;
		}

		if ( $n < 10000 ) {
			return number_format( $n, 0, $point, $sep );
		}

		$d = $n < 1000000 ? 1000 : 1000000;
		$f = round( $n / $d, 1 );

		return number_format( $f, $f - intval( $f ) ? 1 : 0, $point, $sep ) . ( 1000 === $d ? 'K' : 'M' );
	}

	/**
	 * Strips line breaks, tabs & carriage returns from html.
	 *
	 * Used to prevent WP from adding <br> and <p> tags.
	 *
	 * @param string $str Input string to clean
	 * @return string Cleaned string with whitespace removed
	 */
	public static function strip_white_space( $str = '' ) {
		return str_replace( [ "\t", "\r", "\n" ], '', $str );
	}
}