From 82a63a972d09bc6fe2211e33cebf058f005f1161 Mon Sep 17 00:00:00 2001 From: Liam DeBeasi Date: Tue, 21 May 2019 15:08:27 -0400 Subject: [PATCH] docs(datetime): add note about timezones, fix typo (#18289) --- core/src/components/datetime/readme.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/core/src/components/datetime/readme.md b/core/src/components/datetime/readme.md index 5debb76669..69b627e2ae 100644 --- a/core/src/components/datetime/readme.md +++ b/core/src/components/datetime/readme.md @@ -59,6 +59,10 @@ separator. An example display using this format is: `Jun 17, 2005 11:06`. ``` +**Important**: `ion-datetime` will always display values relative to the user's timezone. +Given a value of `09:00:00+01:00`, the datetime component will +display it as `04:00:00-04:00` for users in a `-04:00` timezone offset. + ### Picker Format The `pickerFormat` input property determines which columns should be shown in @@ -186,7 +190,7 @@ either configured at the app level, or individual `ion-datetime` level. The datetime picker provides the simplicity of selecting an exact format, and persists the datetime values as a string using the standardized [ISO 8601 datetime format](https://www.w3.org/TR/NOTE-datetime). However, it's important -to note that `ion-datetime` does not attempt to solve all situtations when +to note that `ion-datetime` does not attempt to solve all situations when validating and manipulating datetime values. If datetime values need to be parsed from a certain format, or manipulated (such as adding 5 days to a date, subtracting 30 minutes, etc.), or even formatting data to a specific locale,