Skip to content
AF

Date Time (0x2A08): byte layout

GATT characteristic · org.bluetooth.characteristic.date_time · read from the Bluetooth SIG’s repository on 2026-10-17 · commit 408f4a0 (2026-10-14)

Date Time is Bluetooth GATT characteristic 0x2A08, org.bluetooth.characteristic.date_time in the Bluetooth SIG's assigned numbers. The SIG's GATT Specification Supplement file lays its value out as 6 fields: Year, Month, Day, Hours, Minutes and Seconds. Every field has a fixed size, 7 octets in all.

UUID
0x2A08
Identifier
org.bluetooth.characteristic.date_time
The SIG’s description
The Date Time characteristic is used to represent date and time.The structure of this characteristic is defined below.
Service the SIG’s files tie it to
None: no file in the repository lists this characteristic under a service.
Referenced by
Weight Measurement, Body Composition Measurement, Glucose Measurement, CGM Session Start Time, Blood Pressure Measurement, Intermediate Cuff Pressure, Temperature Measurement, Intermediate Temperature
Source file
gss/org.bluetooth.characteristic.date_time.yaml

Byte layout: 6 fields

In the order the SIG’s structure lists them. Type and size are as published; sizes count octets except where a struct is marked as sized in bits. The offset is printed only where every earlier field has a fixed size; where an earlier field can be absent or vary, the cell names what it depends on. “Present when” is read from the field’s own “Present if” line, shown in full in the field notes below.

OffsetFieldTypeSizePresent whenUnit
0Yearuint162Always (fixed size)—
2Monthuint81Always (fixed size)—
3Dayuint81Always (fixed size)—
4Hoursuint81Always (fixed size)—
5Minutesuint81Always (fixed size)—
6Secondsuint81Always (fixed size)—

Field notes

Each field’s text in the SIG’s file, line by line.

Year uint16 · 2
Year as defined by the Gregorian calendar. Valid range 1582 to 9999. A value of 0 means that the year is not known. All other values are Reserved for Future Use.
Month uint8 · 1
Month of the year as defined by the Gregorian calendar. Valid range 1 (January) to 12 (December). A value of 0 means that the month is not known. All other values are Reserved for Future Use.
Day uint8 · 1
Day of the month as defined by the Gregorian calendar. Valid range 1 to 31. A value of 0 means that the day of month is not known. All other values are Reserved for Future Use.
Hours uint8 · 1
Number of hours past midnight. Valid range 0 to 23. All other values are Reserved for Future Use.
Minutes uint8 · 1
Number of minutes since the start of the hour. Valid range 0 to 59. All other values are Reserved for Future Use.
Seconds uint8 · 1
Number of seconds since the start of the minute. Valid range 0 to 59. All other values are Reserved for Future Use.

Guides on this site

No guide on this site names 0x2A08 yet. The connected-devices guides cover pairing, subscribing and testing for the device types they do name.

Questions

What is the UUID of the Date Time characteristic?
0x2A08. The Bluetooth SIG's characteristic_uuids.yaml lists Date Time as 0x2A08 with the identifier org.bluetooth.characteristic.date_time. No file in the SIG's repository ties it to a service: the repository lists service and characteristic UUIDs separately. Weight Measurement, Body Composition Measurement, Glucose Measurement, CGM Session Start Time, Blood Pressure Measurement, Intermediate Cuff Pressure, Temperature Measurement and Intermediate Temperature refer to it in their own structure.
Are any Date Time fields optional?
No. Every field in the SIG's structure has a size that cannot be zero: Year (uint16, 2), Month (uint8, 1), Day (uint8, 1), Hours (uint8, 1), Minutes (uint8, 1) and Seconds (uint8, 1).
How many bytes is a Date Time value?
7 octets. Every field has a fixed size in the SIG's structure: Year at offset 0 (uint16, 2), Month at offset 2 (uint8, 1), Day at offset 3 (uint8, 1), Hours at offset 4 (uint8, 1), Minutes at offset 5 (uint8, 1) and Seconds at offset 6 (uint8, 1).

Source

Read on 2026-10-17 from gss/org.bluetooth.characteristic.date_time.yaml and assigned_numbers/uuids/characteristic_uuids.yaml in the Bluetooth SIG’s public repository (branch main, commit 408f4a0, committed 2026-10-14), by scripts/fetch-bluetooth-gatt.mjs. The file’s notice says it is proprietary to Bluetooth SIG, that furnishing it grants no licence, and that it is subject to change without notice; it is © Bluetooth SIG, Inc., and its text is quoted here for identification. Generated by AIFitnessAPI, which is not affiliated with Bluetooth SIG; the SIG’s file remains the authority. The full notice and the conventions used on these pages are on the reference hub.

← All Bluetooth GATT characteristics