129 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			129 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
<?php
 | 
						|
/*********************************************************************************
 | 
						|
 *
 | 
						|
 * TimeTrex is a Workforce Management program developed by
 | 
						|
 * TimeTrex Software Inc. Copyright (C) 2003 - 2021 TimeTrex Software Inc.
 | 
						|
 *
 | 
						|
 * This program is free software; you can redistribute it and/or modify it under
 | 
						|
 * the terms of the GNU Affero General Public License version 3 as published by
 | 
						|
 * the Free Software Foundation with the addition of the following permission
 | 
						|
 * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
 | 
						|
 * WORK IN WHICH THE COPYRIGHT IS OWNED BY TIMETREX, TIMETREX DISCLAIMS THE
 | 
						|
 * WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
 | 
						|
 *
 | 
						|
 * This program is distributed in the hope that it will be useful, but WITHOUT
 | 
						|
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 | 
						|
 * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
 | 
						|
 * details.
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * You should have received a copy of the GNU Affero General Public License along
 | 
						|
 * with this program; if not, see http://www.gnu.org/licenses or write to the Free
 | 
						|
 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 | 
						|
 * 02110-1301 USA.
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * You can contact TimeTrex headquarters at Unit 22 - 2475 Dobbin Rd. Suite
 | 
						|
 * #292 West Kelowna, BC V4T 2E9, Canada or at email address info@timetrex.com.
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * The interactive user interfaces in modified source and object code versions
 | 
						|
 * of this program must display Appropriate Legal Notices, as required under
 | 
						|
 * Section 5 of the GNU Affero General Public License version 3.
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * In accordance with Section 7(b) of the GNU Affero General Public License
 | 
						|
 * version 3, these Appropriate Legal Notices must retain the display of the
 | 
						|
 * "Powered by TimeTrex" logo. If the display of the logo is not reasonably
 | 
						|
 * feasible for technical reasons, the Appropriate Legal Notices must display
 | 
						|
 * the words "Powered by TimeTrex".
 | 
						|
 *
 | 
						|
 ********************************************************************************/
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
 * @package Core
 | 
						|
 */
 | 
						|
class UnitConvert {
 | 
						|
	/*
 | 
						|
		This class is used to convert units, ie:
 | 
						|
		pounds (lbs) to grams (g)
 | 
						|
		inches (in) to meters (m)
 | 
						|
		miles (mi) to kiliometers (km)
 | 
						|
	*/
 | 
						|
 | 
						|
	//Convert weight units to grams, first.
 | 
						|
	//Convert dimension units to mm, first.
 | 
						|
	//Handle square and cubic (exponent) calculations as well.
 | 
						|
	static $units = [
 | 
						|
		// 1 Unit = X G
 | 
						|
		'oz'  => 28.349523125,
 | 
						|
		'lb'  => 453.59237,
 | 
						|
		'lbs' => 453.59237,
 | 
						|
		'g'   => 1,
 | 
						|
		'kg'  => 1000,
 | 
						|
 | 
						|
		//1 Unit = X MM
 | 
						|
		'mm'  => 1,
 | 
						|
		'in'  => 25.4,
 | 
						|
		'cm'  => 10,
 | 
						|
		'ft'  => 304.8,
 | 
						|
		'm'   => 1000,
 | 
						|
		'km'  => 1000000,
 | 
						|
		'mi'  => 1609344,
 | 
						|
	];
 | 
						|
 | 
						|
	//Only units in the same array can be converted to one another.
 | 
						|
	static $valid_unit_groups = [
 | 
						|
			'g'  => [ 'g', 'oz', 'lb', 'lbs', 'kg' ],
 | 
						|
			'mm' => [ 'mm', 'in', 'cm', 'ft', 'm', 'km', 'mi' ],
 | 
						|
	];
 | 
						|
 | 
						|
	/**
 | 
						|
	 * @param $src_unit
 | 
						|
	 * @param $dst_unit
 | 
						|
	 * @param $measurement
 | 
						|
	 * @param int $exponent
 | 
						|
	 * @return bool|float|int
 | 
						|
	 */
 | 
						|
	static function convert( $src_unit, $dst_unit, $measurement, $exponent = 1 ) {
 | 
						|
		$src_unit = strtolower( $src_unit );
 | 
						|
		$dst_unit = strtolower( $dst_unit );
 | 
						|
 | 
						|
		if ( !isset( self::$units[$src_unit] ) ) {
 | 
						|
			return false;
 | 
						|
		}
 | 
						|
		if ( !isset( self::$units[$dst_unit] ) ) {
 | 
						|
			return false;
 | 
						|
		}
 | 
						|
 | 
						|
		if ( $src_unit == $dst_unit ) {
 | 
						|
			return $measurement;
 | 
						|
		}
 | 
						|
 | 
						|
		//Make sure we can convert from one unit to another.
 | 
						|
		$valid_conversion = false;
 | 
						|
		foreach ( self::$valid_unit_groups as $valid_units ) {
 | 
						|
			if ( in_array( $src_unit, $valid_units ) && in_array( $dst_unit, $valid_units ) ) {
 | 
						|
				//Valid conversion
 | 
						|
				$valid_conversion = true;
 | 
						|
			}
 | 
						|
		}
 | 
						|
 | 
						|
		if ( $valid_conversion == false ) {
 | 
						|
			return false;
 | 
						|
		}
 | 
						|
 | 
						|
		$base_measurement = ( pow( self::$units[$src_unit], $exponent ) * $measurement );
 | 
						|
		//Debug::Text(' Base Measurement: '. $base_measurement, __FILE__, __LINE__, __METHOD__, 10);
 | 
						|
		if ( $base_measurement != 0 ) {
 | 
						|
			$retval = ( ( 1 / pow( self::$units[$dst_unit], $exponent ) ) * $base_measurement );
 | 
						|
 | 
						|
			return $retval;
 | 
						|
		}
 | 
						|
 | 
						|
		return false;
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
?>
 |