Skip to content

Commit f7d8e31

Browse files
committed
add physicalType example and description information
Signed-off-by: Diego Carvallo <dccakes@gmail.com>
1 parent cd2e413 commit f7d8e31

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

docs/README.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -291,7 +291,7 @@ Additional metadata options to more accurately define the data type.
291291

292292
#### Expressing Date / Datetime / Timezone information
293293

294-
Given the complexity of handling various date and time formats (e.g., date, datetime, time, timestamp, timestamp with and without timezone), the existing `logicalType` options currently support only `date`. To specify additional temporal details, `logicalType` should be used in conjunction with `logicalTypeOptions.format` to define the desired format.
294+
Given the complexity of handling various date and time formats (e.g., date, datetime, time, timestamp, timestamp with and without timezone), the existing `logicalType` options currently support only `date`. To specify additional temporal details, `logicalType` should be used in conjunction with `logicalTypeOptions.format` or `physicalType` to define the desired format. Using `physicalType` allows for definition of your data-source specific data type.
295295

296296
``` yaml
297297
version: 1.0.0
@@ -325,6 +325,15 @@ schema:
325325
examples:
326326
- "08:30:00"
327327
328+
# Physical Type with Date & Time (UTC)
329+
- name: event_date
330+
logicalType: date
331+
physicalType: DATETIME
332+
logicalTypeOptions:
333+
- format: yyyy-MM-ddTHH:mm:ssZ"
334+
examples:
335+
- "2024-03-10T14:22:35Z"
336+
328337
```
329338

330339
### Authoritative definitions

0 commit comments

Comments
 (0)