numberOfAlcoholicBeverages: HealthKit quantity type
HKQuantityTypeIdentifierNumberOfAlcoholicBeverages · read from Apple’s documentation on 2026-10-02
HKQuantityTypeIdentifier.numberOfAlcoholicBeverages (Objective-C HKQuantityTypeIdentifierNumberOfAlcoholicBeverages) is a HealthKit quantity type in Apple's "Alcohol consumption" group. Apple's abstract: “A quantity sample type that measures the number of standard alcoholic drinks that the user has consumed.” Apple's discussion says its samples use count units and measure cumulative values, so in HKStatisticsQuery it takes .cumulativeSum. It is available from iOS 15.0 and watchOS 8.0.
What Apple says numberOfAlcoholicBeverages is
A quantity sample type that measures the number of standard alcoholic drinks that the user has consumed.
Apple’s abstract, quoted from its numberOfAlcoholicBeverages reference page, read 2026-10-02. Apple’s discussion of the type runs 58 words.
- Swift
HKQuantityTypeIdentifier.numberOfAlcoholicBeverages- Objective-C
HKQuantityTypeIdentifierNumberOfAlcoholicBeverages- Family
HKQuantityTypeIdentifier- Apple's topic group
- Alcohol consumption
- Group page
- Sleep, mindfulness and self-care
- Apple's reference
- numberOfAlcoholicBeverages on developer.apple.com
Availability
The versions Apple’s documentation data gives for numberOfAlcoholicBeverages, platform by platform, as read on 2026-10-02.
| Platform | Introduced | Deprecated |
|---|---|---|
| iOS | 15.0 | — |
| iPadOS | 15.0 | — |
| Mac Catalyst | 15.0 | — |
| macOS | 13.0 | — |
| visionOS | 1.0 | — |
| watchOS | 8.0 | — |
The rest of that release: HealthKit Types Introduced in iOS 15.
Sum or average, and in which units
Apple states both of these in the prose of the type’s discussion, not as properties, so they are derived from Apple’s sentence and the sentence is shown with each.
Aggregation style
cumulative — in an HKStatisticsQuery, use .cumulativeSum. Apple’s sentence:
The samples use count units (described in ) to measure cumulative values (described in ).
Unit family
count — every type in this family is on the HKUnit reference.
Apple states it in the same sentence as the aggregation style, quoted above.
Empty parentheses and a dangling “described in” mark links in Apple’s sentence to other documentation pages: the generator keeps the sentence’s text, not its links, and the quote is left as stored rather than repaired.
Can apps write numberOfAlcoholicBeverages?
Apple’s documentation for numberOfAlcoholicBeverages does not state that its samples are read-only. Apple states read-only status only in prose, and its silence is not a statement either way, so this page makes no claim that apps can save it.
On Android Health Connect
No verified Health Connect counterpart. The cross-platform matrix pairs only metrics checked against both Apple’s and Google’s documentation, and numberOfAlcoholicBeverages is not among them. A similarly named Health Connect record may exist, but a name match is not a verified mapping.
Questions
- Should I sum or average numberOfAlcoholicBeverages in HealthKit?
- Sum it. Apple's documentation for numberOfAlcoholicBeverages describes it as measuring cumulative values, so an HKStatisticsQuery over it takes .cumulativeSum. Apple's sentence, as read on 2026-10-02: "The samples use count units (described in ) to measure cumulative values (described in )."
- Which unit family does Apple give numberOfAlcoholicBeverages?
- Count. Apple's discussion of numberOfAlcoholicBeverages says its samples use count units: "The samples use count units (described in ) to measure cumulative values (described in )."
- Which iOS version added numberOfAlcoholicBeverages?
- iOS 15.0. Apple's availability data for numberOfAlcoholicBeverages lists iOS 15.0, iPadOS 15.0, Mac Catalyst 15.0, macOS 13.0, visionOS 1.0 and watchOS 8.0.
Sources checked
- Apple — HKQuantityTypeIdentifier.numberOfAlcoholicBeverages · read 2026-10-02
- Apple — HKQuantityTypeIdentifier · read 2026-10-02
Apple’s abstract and sentences are quoted for identification; the page layout, the capsule and the cross-platform pairing are AIFitnessAPI’s. Generated from Apple’s documentation by scripts/fetch-healthkit-identifiers.mjs, not typed by hand — the same data as the full identifier table.
← All HealthKit type identifiers · Sleep, mindfulness and self-care