# TotalForegroundTimeMetric A metric that measures the total time the app spent in the foreground. ``` struct TotalForegroundTimeMetric ``` ## Discussion This metric corresponds to the [`MetricResult.totalForegroundTime(_:)`](/documentation/MetricKit/MetricResult/totalForegroundTime(_:)) case. It appears in both [`intervalEntries`](/documentation/MetricKit/MetricReport/intervalEntries) and [`stateEntries`](/documentation/MetricKit/MetricReport/stateEntries) when state reporting is enabled. ## Topics ### Measurements [`let value: Measurement`](/documentation/MetricKit/TotalForegroundTimeMetric/value) The total time the app is in the foreground. ## Relationships ### Conforms To [`Equatable`](/documentation/Swift/Equatable) [`Hashable`](/documentation/Swift/Hashable) [`Encodable`](/documentation/Swift/Encodable) [`Sendable`](/documentation/Swift/Sendable) [`Decodable`](/documentation/Swift/Decodable) [`SendableMetatype`](/documentation/Swift/SendableMetatype) --- 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)