javascript/ionic-framework
1
0
Fork 0
mirror of https://github.com/ionic-team/ionic-framework.git synced 2025-08-21 21:15:24 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(datetime): add note about timezones, fix typo (#18289)

Browse Source
This commit is contained in:
Liam DeBeasi
2019-05-21 15:08:27 -04:00
committed by GitHub
parent adaaf89737
commit 82a63a972d
1 changed files with 5 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
core/src/components/datetime/readme.md
View File

@ -59,6 +59,10 @@ separator. An example display using this format is: `Jun 17, 2005 11:06`.
</ion-item> </ion-item>
``` ```
**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 ### Picker Format
The `pickerFormat` input property determines which columns should be shown in 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 The datetime picker provides the simplicity of selecting an exact format, and
persists the datetime values as a string using the standardized [ISO 8601 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 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 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, 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, subtracting 30 minutes, etc.), or even formatting data to a specific locale,