Use when planning home EV charging — computes charge time and cost for a session (with wall-to-battery losses and breaker load checks), plans overnight charging inside time-of-use off-peak windows (latest safe start, doesn't-fit options), and compares monthly fuel cost EV vs gas car including public-charging mix; handles kW/amps, departure deadlines, and cold-day buffer advice.
Tens of millions of drivers now charge an EV at home, and nearly all of them
get the math wrong in the same ways: they forget ~10% wall-to-battery losses
(a "60 kWh" fill draws ~67 kWh from the meter), they charge at 7¢-per-kWh
worse rates than they could because they never learned their utility's
time-of-use windows, they size charger amperage against panel capacity by
vibe, and they compare EV vs gas costs using the EPA sticker efficiency
instead of their own.
This skill is three calculators:
session — kWh needed + charger kW + rate → hours:minutes to target,
wall energy, cost, battery %, miles added, panel/breaker load check
(80% continuous guidance), and latest start time for a departure deadline.
tou — off-peak window planning: does the charge fit before your
departure (with buffer)? Latest safe start? If not: raise amperage /
accept partial / price the regular-rate tail.
compare — monthly EV vs gas cost at YOUR prices and mileage, with the
public-charging mix that quietly destroys the economics.
Pure stdlib, offline.
When to Use
"How long to add 40 kWh on my 7.4 kW wallbox?" / "What will it cost?"
"Off-peak is 23:00-07:00 and I leave at 6:30 — can I fit 44 kWh?"
"Is the EV actually cheaper than my 30-mpg car at $4.10 gas?"
"Can my 100A panel handle a 48A charger plus the house?"
"My charger asks for amps — what do 16/32/40/48A mean in kW?"
Sizing a wallbox purchase vs charging needs (power math side)
Don't use for: DC fast-charging road-trip planning (different curve —
charge rates fall steeply above 80%), off-grid/solar sizing (needs panel
production data), or utility-bill auditing (only the EV slice is modeled).
How It Works — Numbered Steps
Know your inputs: battery usable kWh, charger kW (amps × 0.24 at 240V —
32A ≈ 7.7 kW, 48A ≈ 11.5 kW), your rate schedule (flat vs TOU windows),
and your car's real mi/kWh (dashboard average, not the sticker).
Panel guidance: continuous loads (EVSE) should stay under 80% of
breaker/panel rating. 48A charging + evening house load can breach this
on a 100A panel — the tool flags it and computes the safe kW.
TOU arbitrage: typical US spreads run 2-3× between off-peak and peak
($0.11 vs $0.34 here). Overnight-only charging is the single highest-ROI
habit in EV ownership — worth $300-600/yr for an average driver.
Cold days: batteries condition/warm post-charge; finishing 30 min
before departure preserves range. Hence the buffer default.
Common Pitfalls
Charging "to full" every night. Most batteries are happiest in the
20-80% band; nightly 80% + 100% before trips is the standard protocol.
Ignoring TOU enrollment. Many utilities default you to flat rate;
enrolling in EV/TOU plans is a 15-minute phone call that halves charging
cost. The compare tool shows the spread.
Counting public DC charging as 'basically home charging.' At
$0.40-0.60/kWh, DC fast charging costs MORE per mile than a 30-mpg car
at $4 gas. The public-mix percentage exists to keep this honest.
Sizing the charger by 'more is better.' A 48A EVSE on a 100A panel
with a heat pump and an electric dryer is a load-management problem;
32A covers 40+ miles/hour of charging anyway — most overnight needs fit.
Assuming the sticker efficiency. Cold weather, high speed, and
hills move real consumption 10-30%. Use the dashboard's lifetime mi/kWh.
Departing mid-charge in winter. The battery is warm while charging;
a 30-minute post-charge buffer lets preconditioning work from grid power
instead of battery.
Forgetting vampire loads in compare. If the EV lets you enter
mileage only, add 5-10% for climate/sentinel drain on the kWh side.
Example
text
Owner: 62-kWh EV, new 7.4 kW wallbox, off-peak 23:00-07:00 @ $0.11,
departs 06:30. Drives 900 mi/mo, gas alternative is 30 mpg @ $4.10.
$ session --kwh-needed 32 --kw 7.4 --rate 0.11 --departure "07:00"
→ 4h48m, $4.36 at off-peak (vs $8.18 flat-rate) — start at 02:11.
$ tou --kwh-needed 44 --kw 11 --offpeak "23:00-07:00" --rate 0.11 \
--regular-rate 0.34 --departure "06:30"
→ FITS, slack 2h33m, latest start 01:33, saves $11.24/session.
$ compare --miles-month 900 --ev-mi-per-kwh 3.4 --home-rate 0.11 \
--public-pct 10 --public-rate 0.48 --gas-price 4.10 --gas-mpg 30
→ EV ~$40/mo vs gas $123/mo → saves ~$1000/yr charging at home,
but only $260/yr if 50% of charging is public DC.
