docs: readme

Author: vonovak

README.md

@@ -66,24 +66,25 @@ React Native date & time picker component for iOS, Android and Windows.
     - [`value` (`required`)](#value-required)
     - [`maximumDate` (`optional`)](#maximumdate-optional)
     - [`minimumDate` (`optional`)](#minimumdate-optional)
+    - [`timeZoneName` (`optional`, `iOS or Android only`)](#timezonename-optional-ios-and-android-only)
     - [`timeZoneOffsetInMinutes` (`optional`, `iOS or Android only`)](#timezoneoffsetinminutes-optional-ios-and-android-only)
     - [`timeZoneOffsetInSeconds` (`optional`, `Windows only`)](#timezoneoffsetinsecond-optional-windows-only)
-    - [`dayOfWeekFormat` (`optional`, `Windows only`)](#dayOfWeekFormat-optional-windows-only)
-    - [`dateFormat` (`optional`, `Windows only`)](#dateFormat-optional-windows-only)
-    - [`firstDayOfWeek` (`optional`, `Windows only`)](#firstDayOfWeek-optional-windows-only)
-    - [`textColor` (`optional`, `iOS only`)](#textColor-optional-ios-only)
-    - [`accentColor` (`optional`, `iOS only`)](#accentColor-optional-ios-only)
+    - [`dayOfWeekFormat` (`optional`, `Windows only`)](#dayofweekformat-optional-windows-only)
+    - [`dateFormat` (`optional`, `Windows only`)](#dateformat-optional-windows-only)
+    - [`firstDayOfWeek` (`optional`, `Windows only`)](#firstdayofweek-optional-windows-only)
+    - [`textColor` (`optional`, `iOS only`)](#textcolor-optional-ios-only)
+    - [`accentColor` (`optional`, `iOS only`)](#accentcolor-optional-ios-only)
     - [`themeVariant` (`optional`, `iOS only`)](#themevariant-optional-ios-only)
     - [`locale` (`optional`, `iOS only`)](#locale-optional-ios-only)
     - [`is24Hour` (`optional`, `Windows and Android only`)](#is24hour-optional-windows-and-android-only)
-    - [`positiveButton` (`optional`, `Android only`)](#positiveButton-optional-android-only)
-    - [`negativeButton` (`optional`, `Android only`)](#negativeButton-optional-android-only)
-    - [`neutralButton` (`optional`, `Android only`)](#neutralButton-optional-android-only)
+    - [`positiveButton` (`optional`, `Android only`)](#positivebutton-optional-android-only)
+    - [`negativeButton` (`optional`, `Android only`)](#negativebutton-optional-android-only)
+    - [`neutralButton` (`optional`, `Android only`)](#neutralbutton-optional-android-only)
     - [`minuteInterval` (`optional`)](#minuteinterval-optional)
     - [`style` (`optional`, `iOS only`)](#style-optional-ios-only)
     - [`disabled` (`optional`, `iOS only`)](#disabled-optional-ios-only)
     - [`view props` (`optional`, `iOS only`)](#view-props-optional-ios-only)
-    - [`onError` (`optional`, `Android only`)](#onError-optional-android-only)
+    - [`onError` (`optional`, `Android only`)](#onerror-optional-android-only)
   - [Testing with Jest](#testing-with-jest)
   - [Migration from the older components](#migration-from-the-older-components)
   - [Contributing to the component](#contributing-to-the-component)
@@ -309,11 +310,13 @@ This is called when the user changes the date or time in the UI. It receives the
 It is also called when user dismisses the picker, which you can detect by checking the `event.type` property.
 The values can be: `'set' | 'dismissed' | 'neutralButtonPressed'`. (`neutralButtonPressed` is only available on Android).
 
+The `utcOffset` field is only available on Android and iOS. It is the offset in minutes between the selected date and UTC time.
+
 ```js
 const setDate = (event: DateTimePickerEvent, date: Date) => {
   const {
     type,
-    nativeEvent: {timestamp},
+    nativeEvent: {timestamp, utcOffset},
   } = event;
 };
 
@@ -344,10 +347,20 @@ Defines the minimum date that can be selected. Note that on Android, this only w
 <RNDateTimePicker minimumDate={new Date(1950, 0, 1)} />
 ```
 
+#### `timeZoneName` (`optional`, `iOS and Android only`)
+
+Allows changing of the time zone of the date picker. By default, it uses the device's time zone.
+Use the time zone name from the IANA (TZDB) database name in https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
+
+```js
+// GMT+1
+<RNDateTimePicker timeZoneOffsetInMinutes={60} />
+```
+
 #### `timeZoneOffsetInMinutes` (`optional`, `iOS and Android only`)
 
-Allows changing of the timeZone of the date picker. By default, it uses the device's time zone.
-We strongly recommend avoiding this prop on android because of known issues in the implementation (eg. [#528](https://github.com/react-native-datetimepicker/datetimepicker/issues/528)).
+Allows changing of the time zone of the date picker. By default, it uses the device's time zone.
+We strongly recommend using `timeZoneName` instead; this prop has known issues in the android implementation (eg. [#528](https://github.com/react-native-datetimepicker/datetimepicker/issues/528)).
 
 ```js
 // GMT+1

src/index.d.ts

@@ -19,7 +19,8 @@ export type EvtTypes = 'set' | 'neutralButtonPressed' | 'dismissed';
 export type DateTimePickerEvent = {
   type: EvtTypes;
   nativeEvent: {
-    timestamp?: number;
+    timestamp: number;
+    utcOffset: number;
   };
 };