<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: -"
  ],
  "documentType" : "symbol",
  "framework" : "EnergyKit",
  "identifier" : "/documentation/EnergyKit/ElectricVehicleStatusEvent/init(timestamp:device:venueID:status:stateOfCharge:energy:estimatedRange:chargingTarget:sessionIdentifier:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "EnergyKit"
    ],
    "preciseIdentifier" : "s:9EnergyKit26ElectricVehicleStatusEventV9timestamp6device7venueID6status13stateOfCharge6energy14estimatedRange14chargingTarget17sessionIdentifierAC10Foundation4DateV_AA20ElectricalLoadDeviceVAM4UUIDVAC0E0OSiAM11MeasurementVySo06NSUnitA0CGAWySo12NSUnitLengthCGSgAC08ChargingS0VSgASSgtcfc"
  },
  "title" : "init(timestamp:device:venueID:status:stateOfCharge:energy:estimatedRange:chargingTarget:sessionIdentifier:)"
}
-->

# init(timestamp:device:venueID:status:stateOfCharge:energy:estimatedRange:chargingTarget:sessionIdentifier:)

Creates an electric vehicle status event.

```
init(timestamp: Date, device: ElectricalLoadDevice, venueID: UUID, status: ElectricVehicleStatusEvent.Status, stateOfCharge: Int, energy: Measurement<UnitEnergy>, estimatedRange: Measurement<UnitLength>? = nil, chargingTarget: ElectricVehicleStatusEvent.ChargingTarget? = nil, sessionIdentifier: UUID? = nil)
```

## Parameters

`timestamp`

The time when the status event occurs.

`device`

The device identifier that [`ElectricalLoadDevice`](/documentation/EnergyKit/ElectricalLoadDevice) creates.

`venueID`

An identifier for the venue in which the event occurs.

`status`

The current status of the vehicle relative to charger connection.

`stateOfCharge`

The state of charge percentage (0-100) at the time of the event.

`energy`

The state of charge in milliwatt-hours at the time of the event.

`estimatedRange`

The estimated range based on current state, or `nil` if the range is unavailable.

`chargingTarget`

The target information for the charging session, or `nil` if the information is unavailable.

`sessionIdentifier`

An identifier for the [`ElectricVehicleLoadEvent`](/documentation/EnergyKit/ElectricVehicleLoadEvent) session, or `nil` if not applicable.

---

Copyright &copy; 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)