---
title: dataByGridCleanliness
framework: energykit
role: symbol
role_heading: Instance Property
path: energykit/electricityinsightrecord/databygridcleanliness
---

# dataByGridCleanliness

Energy consumption or production, or device operational runtime categorized by the cleanliness of the grid electricity.

## Declaration

```swift
var dataByGridCleanliness: ElectricityInsightRecord<Measure>.GridCleanliness?
```

## Mentioned in

Providing charging history for electric vehicles

## Discussion

Discussion This property returns electricity usage data organized by how environmentally friendly the production of the energy is. The electricity usage data refers to either energy consumption or generation measurements, or amounts of time that an electrical device is operational and consuming energy. The type of the returned value depends on the insight record’s generic type parameter: ElectricityInsightRecord<Measurement<UnitEnergy>> instances return Measurement<UnitEnergy> for this property. ElectricityInsightRecord<Duration> instances return Duration for this property.

## See Also

### Getting the grid data

- [ElectricityInsightRecord.GridCleanliness](energykit/electricityinsightrecord/gridcleanliness.md)