# ElectricityInsightRecord A structure that provides environmental impact and cost insights for electricity usage over a specific time period. ``` struct ElectricityInsightRecord where Measure : ElectricityInsightMeasure ``` ## Overview This structure provides electricity usage data categorized by environmental impact ([`ElectricityInsightRecord.GridCleanliness`](/documentation/EnergyKit/ElectricityInsightRecord/GridCleanliness)) and cost factors ([`ElectricityInsightRecord.TariffPeak`](/documentation/EnergyKit/ElectricityInsightRecord/TariffPeak)) for analysis and optimization. The electricity usage data ([`dataByGridCleanliness`](/documentation/EnergyKit/ElectricityInsightRecord/dataByGridCleanliness)) refers to either energy consumption or generation measurements, or amounts of time that an electrical device is operational and consuming energy. The type of electricity usage data depends on the generic type parameter ([`ElectricityInsightMeasure`](/documentation/EnergyKit/ElectricityInsightMeasure)) for a given instance, which can be either: - [`ElectricityInsightRecord`](/documentation/EnergyKit/ElectricityInsightRecord)<<>> - [`ElectricityInsightRecord`](/documentation/EnergyKit/ElectricityInsightRecord)<> ## Topics ### Getting the grid data [`struct GridCleanliness`](/documentation/EnergyKit/ElectricityInsightRecord/GridCleanliness) A structure that describes the environmental impact of grid electricity during specific time periods. [`var dataByGridCleanliness: ElectricityInsightRecord.GridCleanliness?`](/documentation/EnergyKit/ElectricityInsightRecord/dataByGridCleanliness) Energy consumption or production, or device operational runtime categorized by the cleanliness of the grid electricity. ### Getting the tariff peak data [`struct TariffPeak`](/documentation/EnergyKit/ElectricityInsightRecord/TariffPeak) A struct describing energy tariff peaks or duration data, if available. [`var dataByTariffPeak: ElectricityInsightRecord.TariffPeak?`](/documentation/EnergyKit/ElectricityInsightRecord/dataByTariffPeak) The electrical energy consumed or generated, or the runtime duration split out by tariff peaks, if available. ### Getting the insight record data [`var totalRuntime: Duration?`](/documentation/EnergyKit/ElectricityInsightRecord/totalRuntime) The total time that electricity-consuming devices actively ran. [`let range: DateInterval`](/documentation/EnergyKit/ElectricityInsightRecord/range) The time period that the insight record spans. [`var totalEnergy: Measurement?`](/documentation/EnergyKit/ElectricityInsightRecord/totalEnergy) The total electrical energy consumed or generated. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)