Skip to content

Main content

Electricity Cost Calculator Source Code

Browse the implementation files for Electricity Cost Calculator.
@tool.io/tools/cost/electricity source ↗
tool.ts typescript
import {
	CURRENCY_OPTIONS,
	formatCostSummary,
	formatMoney,
	parseCurrency,
	parseNonnegative,
	parsePositive
} from '../calculation';
import { calculateElectricityCost as calculatePortableElectricityCost } from '@tool.io/tools/cost/electricity';

export interface ElectricityCostResult {
	dailyCost: number;
	dailyEnergyKwh: number;
	monthlyCost: number;
	yearlyCost: number;
}

export const calculateElectricityCosts = (
	powerUnitInput: unknown,
	powerInput: unknown,
	hoursPerDayInput: unknown,
	rateInput: unknown,
	quantityInput: unknown
): ElectricityCostResult | null => {
	if (powerUnitInput !== 'w' && powerUnitInput !== 'kw')
		return null;
	const power = parseNonnegative(powerInput);
	const hoursPerDay = parseNonnegative(hoursPerDayInput);
	const rate = parseNonnegative(rateInput);
	const quantity = parsePositive(quantityInput);
	if (
		power === null ||
		hoursPerDay === null ||
		rate === null ||
		quantity === null ||
		hoursPerDay > 24
	) {
		return null;
	}

	const result = calculatePortableElectricityCost(
		power,
		powerUnitInput,
		hoursPerDay,
		rate,
		quantity,
		'USD'
	);
	return result
		? {
				dailyCost: result.dailyCost,
				dailyEnergyKwh: result.dailyEnergyKwh,
				monthlyCost: result.monthlyCost,
				yearlyCost: result.yearlyCost
			}
		: null;
};

export const electricityCost = (
	currencyInput: unknown,
	powerUnitInput: unknown,
	powerInput: unknown,
	hoursPerDayInput: unknown,
	rateInput: unknown,
	quantityInput: unknown
): string => {
	const currency = parseCurrency(currencyInput);
	const result = calculateElectricityCosts(
		powerUnitInput,
		powerInput,
		hoursPerDayInput,
		rateInput,
		quantityInput
	);
	if (!currency || !result) return '';

	return formatCostSummary([
		['Daily energy', `${result.dailyEnergyKwh.toFixed(3)} kWh`],
		['Daily cost', formatMoney(result.dailyCost, currency)],
		['Monthly cost', formatMoney(result.monthlyCost, currency)],
		['Yearly cost', formatMoney(result.yearlyCost, currency)]
	]);
};

export const Tool: TypeTool = {
	name: 'Electricity Cost Calculator',
	slug: 'cost/electricity',
	intro:
		'Estimate the daily, monthly, and yearly electricity cost of running one or more devices.',
	tool: electricityCost,
	i: [
		{
			example: 'USD',
			label: 'Currency',
			options: CURRENCY_OPTIONS,
			placeholder: 'Select currency',
			type: 'select'
		},
		{
			example: 'w',
			label: 'Power Unit',
			options: [
				{ selected: true, text: 'Watts (W)', value: 'w' },
				{ text: 'Kilowatts (kW)', value: 'kw' }
			],
			placeholder: 'Select power unit',
			type: 'select'
		},
		{
			example: '100',
			label: 'Power',
			placeholder: 'Device power',
			type: 'number'
		},
		{
			example: '8',
			label: 'Hours per Day',
			placeholder: 'Daily usage hours',
			type: 'number'
		},
		{
			example: '0.16',
			label: 'Price per kWh',
			placeholder: 'Electricity rate',
			type: 'number'
		},
		{
			example: '1',
			label: 'Quantity',
			placeholder: 'Number of devices',
			type: 'number'
		}
	],
	o: [
		{
			example:
				'Daily energy: 0.800 kWh\nDaily cost: $0.13\nMonthly cost: $3.89\nYearly cost: $46.72',
			label: 'Electricity Cost',
			placeholder: 'Estimated costs will appear here...',
			render: 'textarea',
			type: 'text'
		}
	],
	alternative: [
		{
			title: 'Appliance Cost Calculator',
			url: '/cost/appliance'
		},
		{ title: 'Heating Cost Calculator', url: '/cost/heating' }
	],
	cite: [
		{
			title: 'Electricity pricing - Wikipedia',
			url: 'https://en.wikipedia.org/wiki/Electricity_pricing'
		}
	]
};

export default Tool;

Description

Browse the implementation files for Electricity Cost Calculator.

References

  1. Tool.io on GitHub
  2. Tool.io TypeScript tools library

Similar or alternative tools