2.0.1 • Published 3 years ago

@mohalla-tech/react-native-date-time-picker v2.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

React Native DateTimePicker

React Native date & time picker component for iOS, Android written without using any Native modules. It's highly customizable and can be easily modified.

:camera: Screenshots

📲 Getting started

npm install @mohalla-tech/react-native-date-time-picker --save

or

yarn add @mohalla-tech/react-native-date-time-picker

No linking or pod install are required.

📝 General Usage

import React, { useState } from 'react';
import { View, Text } from 'react-native';
import DateTimePicker from 'react-native-date-time-picker';

const App = () => {
    const initialDate = new Date(1950, 6, 15, 7, 30);
    const [date, setDate] = useState(initialDate);
    const [time, setTime] = useState(initialDate);
    const [datetime, setDatetime] = useState();

    const onDateChange = (selectedDate: Date) => setDate(selectedDate);

    const onTimeChange = (selectedTime: Date) => setTime(selectedTime);

    const onDatetimeChange = (selectedDatetime: Date) => setDatetime(selectedDatetime);

    return (
        <View>
            <Text style={styles.text}>mode="date"</Text>
            <DateTimePicker mode="date" initialValue={initialDate} onChange={onDateChange} />

            <Text style={styles.text}>mode="time"</Text>
            <DateTimePicker
                mode="time"
                is24Hour={false}
                initialValue={initialDate}
                onChange={onTimeChange}
            />

            <Text style={styles.text}>mode="datetime"</Text>
            <View style={styles.card}>
                <DateTimePicker mode="datetime" onChange={onDatetimeChange} />
            </View>
        </View>
    );
};

export default App;

Note: mode change on the fly is not supported

⚙️ Props

ListItemStyleType = { color?: string; backgroundColor?: string } Mode = 'date' | 'time' | 'datetime'

PropTypeRequiredDefaultDescription
modeMode-'date'Defines the type of the picker.
initialValueDate-new Date()Initial Date to scroll to
minimumDateDate-undefinedMinimum Date available to select(only for "datetime" mode)
maximumDateDate-undefinedMaximum Date available to select(only for "datetime" mode)
is24Hourboolean-falseDisplay TimePicker in 24 hour.
minuteIntervalnumber-1Interval gap in minute list
onChangefunction-Callback to be called every time user change date.
itemHeightnumber-40Height of single item in list
containerStyleViewStyle-undefinedOutermost View style
listItemStyleListItemStyleType-undefinedStyle for individual list item text
separatorColorstring-undefinedColor for the separator between 2 item
flatListPropsFlatListProps-undefinedTo optimise FlatList add optimizations to this prop

📣 Acknowledgements

🛡 License

This project is licensed under the MIT License - see the LICENSE.md file for details.