From 772ee0546b397f42378b1be0fecbc4104a84e715 Mon Sep 17 00:00:00 2001 From: Josh Date: Mon, 30 Mar 2026 11:00:37 -0400 Subject: [PATCH 1/2] docs(NcDateTimePickerNative): clarify local timezone conversion behavior Signed-off-by: Josh --- .../NcDateTimePickerNative/NcDateTimePickerNative.vue | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue b/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue index 8724795f98..5556d10e23 100644 --- a/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue +++ b/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue @@ -97,9 +97,12 @@ import { createElementId } from '../../utils/createElementId.ts' defineOptions({ inheritAttrs: false }) /** - * The date is – like the `Date` object in JavaScript – tied to UTC. - * The selected time zone does not have an influence of the selected time and date value. - * You have to translate the time yourself when you want to factor in time zones. + * The selected value is interpreted in the browser's local timezone. + * The component converts between the native input value and a JavaScript + * `Date` using that local timezone context. + * If your app needs to work in a specific timezone other than the + * browser's local one (for example UTC or an IANA timezone), you + * must convert the value yourself. * Pass null to clear the input field. */ const modelValue = defineModel({ default: null }) From 8275b9e54227035a77959c4a014b69964ef93769 Mon Sep 17 00:00:00 2001 From: Josh Date: Mon, 30 Mar 2026 11:14:54 -0400 Subject: [PATCH 2/2] docs(NcDateTimePickerNative): add UTC serialization example Signed-off-by: Josh --- .../NcDateTimePickerNative/NcDateTimePickerNative.vue | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue b/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue index 5556d10e23..7139a70b1e 100644 --- a/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue +++ b/src/components/NcDateTimePickerNative/NcDateTimePickerNative.vue @@ -103,6 +103,10 @@ defineOptions({ inheritAttrs: false }) * If your app needs to work in a specific timezone other than the * browser's local one (for example UTC or an IANA timezone), you * must convert the value yourself. + * + * For example, serializing the resulting `Date` with `toISOString()` + * will produce the corresponding UTC timestamp. + * * Pass null to clear the input field. */ const modelValue = defineModel({ default: null })