react-native-datepicker

React Native simple date & time picker component for iOS and Android, using @react-native-community/datetimepicker

iOS
Android

install

IMPORTANT - At first, you have to install @react-native-community/datetimepicker as a peer dependecy, and link it

1npm install --save simple-react-native-datepicker

General Usage

1import React, { Component } from 'react';
2import { View, SafeAreaView, Text, Button } from 'react-native';
3import DateTimePicker from 'simple-react-native-datepicker'
4
5interface IState {
6  visible: boolean;
7  dateStr?: string;
8  date?: Date;
9}
10
11class App extends Component<{}, IState> {
12  constructor(props: {}) {
13    super(props);
14    this.state = { dateStr: '', date: new Date(), visible: false };
15  }
16  public render() {
17    return (
18      <SafeAreaView style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
19        <View>
20          <Text style={{ marginBottom: 20 }}>Hello! simple date picker!</Text>
21          <Text style={{ marginBottom: 20 }}>time is {String(this.state.dateStr)}</Text>
22          <Button onPress={() => this.showDatePicker()} title="show" />
23          <DatePciker
24            visible={this.state.visible}
25            onDateChange={(dateStr, date) => this.onDateChange(dateStr, date)}
26            date={this.state.date}
27          />
28        </View>
29      </SafeAreaView>
30    );
31  }
32
33  public showDatePicker() {
34    this.setState({ visible: true });
35  }
36
37  public onDateChange(dateStr?: string, date?: Date) {
38    if (dateStr === undefined) {
39      dateStr = 'canceled';
40    }
41    this.setState({ dateStr, date, visible: false });
42  }
43}
44
45export default App;
46

Props

visible (required)

Defines show or hide the picker.

1<RNDateTimePicker visible={true} />
2
3<RNDateTimePicker visible={this.state.isShowDatePicker} />

format(optional)

Defines date string format. Please refer to moment format

1<RNDateTimePicker mode="date" format="YYYY-MM-DD" />

mode (optional)

Defines the type of the picker.

List of possible values:

• "date" (default for iOS and Android)
• "time"
• "datetime" (iOS only)
• "countdown" (iOS only)

1<RNDateTimePicker mode="time" />

display (optional, Android only)

Defines the visual display of the picker for Android and will be ignored for iOS.

List of possible values:

• "default"
• "spinner"
• "calendar" (only for date mode)
• "clock" (only for time mode)

1<RNDateTimePicker display="spinner" />

onDateChange (required)

Date change handler.

This is called when the user changes the date or time in the UI. It receives the formatted dateStr and the date as parameters.

If dateStr and date receives undefined, it mean's datepicker canceled like press cacel button.

1setDate = (dateStr, date) => {
2	if (dateStr === undefined && date === undefined) {
3		// cancel handler execute
4	}
5};
6
7<RNDateTimePicker onChange={this.setDate} />;

date (optional)

Defines the date or time value used in the component.

1<RNDateTimePicker date={new Date()} />

maximumDate (optional)

Defines the maximum date that can be selected.

1<RNDateTimePicker maximumDate={new Date(2300, 10, 20)} />

minimumDate (optional)

Defines the minimum date that can be selected.

1<RNDateTimePicker minimumDate={new Date(1950, 0, 1)} />

timeZoneOffsetInMinutes (optional, iOS only)

Allows changing of the timeZone of the date picker. By default it uses the device's time zone.

1// GMT+1
2<RNDateTimePicker timeZoneOffsetInMinutes={60} />

textColor (optional, iOS only)

Allows changing of the textColor of the date picker.

1<RNDateTimePicker textColor="red" />

locale (optional, iOS only)

Allows changing of the locale of the component. By default it uses the device's locale. Please refer to here

1<RNDateTimePicker locale="es-ES" />

is24Hour (optional, Android only)

Allows changing of the time picker to a 24 hour format.

1<RNDateTimePicker is24Hour={true} />

minuteInterval (optional, iOS only)

The interval at which minutes can be selected. Possible values are: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30

1<RNDateTimePicker minuteInterval={10} />

confirmText(optional, iOS only) default = "Confirm"

Defines iOS datepicker confirm button title

1<RNDateTimePicker confirmText="확인" />

cancelText(optional, iOS only) default = "Cancel"

Defines iOS datepicker cancel button title

1<RNDateTimePicker confirmText="취소" />

confirmTextStyle(optional, iOS only)

Defines iOS datepicker confirm button title style

1<RNDateTimePicker confirmTextStyle={{ color: 'red' }} />

cancelTextStyle(optional, iOS only)

Defines iOS datepicker cancel button title style

1<RNDateTimePicker cancelTextStyle={{ color: 'black' }} />

Running the example app

1. Install required pods in demo/ios by running pods install
2. Run npm start to start Metro Bundler
3. Run npm run start ios or npm run start android