react-native-modal-datetime-picker vs react-native-date-picker vs react-native-paper-dates vs react-native-datepicker
Choosing a React Native date/time picker that matches your platform, UX, and state model
react-native-modal-datetime-pickerreact-native-date-pickerreact-native-paper-datesreact-native-datepickerSimilar Packages:
Choosing a React Native date/time picker that matches your platform, UX, and state model

These packages all solve the same core problem: capturing dates and times in React Native apps, but they do so with materially different UX models, API shapes, and architectural trade-offs.

  • react-native-date-picker provides a direct, customizable bridge to native pickers with both inline and modal presentations. It returns JavaScript Date objects and exposes common constraints like minimumDate, maximumDate, and minuteInterval.
  • react-native-modal-datetime-picker wraps the community native picker in a highly ergonomic modal, standardizing the show/confirm/cancel flow while delegating the actual selection UI to the platform’s native control.
  • react-native-paper-dates implements Material-style date and time pickers in JavaScript, integrating deeply with react-native-paper theming. It adds higher-level features like range selection and input-field patterns while trading off the OS-native look and feel.
  • react-native-datepicker is a legacy component with a string-based API and an older design approach; it has been deprecated and should be treated as historical context rather than a contemporary option.
Npm Package Weekly Downloads Trend
3 Years
Github Stars Ranking
Stat Detail
Package
Downloads
Stars
Size
Issues
Publish
License
react-native-modal-datetime-picker400,0323,05343.9 kB55a year agoMIT
react-native-date-picker183,7792,4713.97 MB616 months agoMIT
react-native-paper-dates34,144747991 kB614 days agoMIT
react-native-datepicker7,9142,120-2878 years agoMIT

Four Ways to Pick Dates in React Native: react-native-date-picker, react-native-modal-datetime-picker, react-native-paper-dates, and react-native-datepicker

Modern React Native apps need predictable date/time inputs that honor platform conventions, enforce constraints, and fit into existing state and validation flows. These four libraries converge on that need but diverge on how much they rely on native controls, how they expose state, and what higher-level UX they bundle.

Native-first versus design-system-first changes everything

  • react-native-date-picker renders the platform-native picker either inline or as a modal, exposing a thin, cross-platform prop surface. You get OS-native motion and accessibility with minimal abstraction.
  • react-native-modal-datetime-picker is a modal wrapper around the community native picker. It focuses on a polished confirm/cancel flow while delegating actual selection UI to the OS.
  • react-native-paper-dates implements a Material calendar/time UI in JS. It enables features like date-range selection and input patterns and integrates tightly with react-native-paper theming, at the cost of deviating from the platform-native look.
  • react-native-datepicker represents an older generation: string-based values, legacy props, and a custom UI approach that no longer aligns with modern RN patterns. It is deprecated.

State shape and data flow alter validation and interop

  • react-native-date-picker and react-native-modal-datetime-picker use Date objects end-to-end. This is ideal for schema validation (Zod/Valibot/TypeScript), timezone arithmetic, and serialization.
  • react-native-paper-dates returns Date objects for dates and { hours, minutes } payloads for times. Range selection returns { startDate, endDate }, enabling higher-level validation like non-overlapping intervals.
  • react-native-datepicker emits formatted strings. This forces parsing/formatting logic on your side and introduces mismatches with libraries expecting Date instances.

The hidden cost of locale, timezone, and constraints

  • Locale: native-based libraries (react-native-date-picker, react-native-modal-datetime-picker) rely on the device’s locale, with optional props to override (platform-dependent). react-native-paper-dates uses its own locale prop and integrates with react-native-paper for typography/density.
  • Timezones: all four essentially operate in device-local time; none provide built-in timezone conversion. Cross-timezone flows require external handling (e.g., converting from UTC to local on input, and back on submission).
  • Constraints: native pickers enforce minimumDate/maximumDate at the control level. react-native-paper-dates uses validRange and inline validation messaging. Range selection is first-class only in react-native-paper-dates.

Performance and accessibility trade-offs are predictable

  • Native pickers (react-native-date-picker, react-native-modal-datetime-picker) have minimal JS overhead and inherit platform accessibility affordances. Rendering and scrolling are GPU-optimized by the OS.
  • react-native-paper-dates incurs a JS-rendered calendar grid and animations but gains deep theming and layout control. Accessibility depends on the component’s ARIA-like semantics and react-native-paper primitives.
  • react-native-datepicker carries legacy UI assumptions and a string API that increases app-level parsing/validation work.

The same user flow, four APIs: pick a start/end datetime with 15-minute steps

Goal: capture a date range with start and end datetimes. Enforce end ≥ start and a 15-minute interval.

react-native-modal-datetime-picker

import React, { useState } from 'react';
import { Button, View, Text } from 'react-native';
import DateTimePickerModal from 'react-native-modal-datetime-picker';

export function RangePicker() {
  const [visible, setVisible] = useState(false);
  const [phase, setPhase] = useState<'start'|'end'|null>(null);
  const [start, setStart] = useState<Date | null>(null);
  const [end, setEnd] = useState<Date | null>(null);

  const openFor = (p: 'start'|'end') => { setPhase(p); setVisible(true); };
  const roundTo15 = (d: Date) => new Date(Math.round(d.getTime() / (15*60*1000)) * 15*60*1000);

  return (
    <View>
      <Button title="Pick start" onPress={() => openFor('start')} />
      <Button title="Pick end" onPress={() => openFor('end')} />
      <Text>{start?.toString() ?? '—'} → {end?.toString() ?? '—'}</Text>

      <DateTimePickerModal
        isVisible={visible}
        mode="datetime"
        date={(phase === 'end' && start) ? start : (start ?? new Date())}
        minimumDate={phase === 'end' ? start ?? undefined : undefined}
        minuteInterval={15}
        onConfirm={(d) => {
          const rounded = roundTo15(d);
          if (phase === 'start') setStart(rounded); else setEnd(rounded);
          setVisible(false); setPhase(null);
        }}
        onCancel={() => { setVisible(false); setPhase(null); }}
      />
    </View>
  );
}

react-native-date-picker

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

export function RangePicker() {
  const [open, setOpen] = useState<null | 'start' | 'end'>(null);
  const [start, setStart] = useState<Date | null>(null);
  const [end, setEnd] = useState<Date | null>(null);
  const roundTo15 = (d: Date) => new Date(Math.round(d.getTime() / (15*60*1000)) * 15*60*1000);

  return (
    <View>
      <Button title="Pick start" onPress={() => setOpen('start')} />
      <Button title="Pick end" onPress={() => setOpen('end')} />
      <Text>{start?.toString() ?? '—'} → {end?.toString() ?? '—'}</Text>

      <DatePicker
        modal
        open={open !== null}
        mode="datetime"
        date={(open === 'end' && start) ? start : (start ?? new Date())}
        minimumDate={open === 'end' ? start ?? undefined : undefined}
        minuteInterval={15}
        onConfirm={(d) => {
          const rounded = roundTo15(d);
          if (open === 'start') setStart(rounded); else setEnd(rounded);
          setOpen(null);
        }}
        onCancel={() => setOpen(null)}
      />
    </View>
  );
}

react-native-paper-dates

import React, { useState } from 'react';
import { View, Text, Button } from 'react-native';
import { DatePickerModal, TimePickerModal } from 'react-native-paper-dates';

export function RangePicker() {
  const [dateVisible, setDateVisible] = useState(false);
  const [timeFor, setTimeFor] = useState<null | 'start' | 'end'>(null);
  const [range, setRange] = useState<{ startDate: Date | undefined; endDate: Date | undefined}>({ startDate: undefined, endDate: undefined });
  const [times, setTimes] = useState<{ start?: {h:number;m:number}; end?: {h:number;m:number} }>({});

  const roundTo15 = (h:number, m:number) => ({ h, m: Math.round(m/15)*15 % 60 });

  return (
    <View>
      <Button title="Pick date range" onPress={() => setDateVisible(true)} />
      <Button title="Pick start time" onPress={() => setTimeFor('start')} />
      <Button title="Pick end time" onPress={() => setTimeFor('end')} />
      <Text>
        {range.startDate?.toDateString() ?? '—'} {times.start ? `${times.start.h}:${String(times.start.m).padStart(2,'0')}` : ''}
        →
        {range.endDate?.toDateString() ?? '—'} {times.end ? `${times.end.h}:${String(times.end.m).padStart(2,'0')}` : ''}
      </Text>

      <DatePickerModal
        locale="en"
        mode="range"
        visible={dateVisible}
        onDismiss={() => setDateVisible(false)}
        startDate={range.startDate}
        endDate={range.endDate}
        validRange={{ startDate: undefined, endDate: undefined }}
        onConfirm={({ startDate, endDate }) => { setRange({ startDate, endDate }); setDateVisible(false); }}
      />

      <TimePickerModal
        visible={timeFor !== null}
        onDismiss={() => setTimeFor(null)}
        onConfirm={({ hours, minutes }) => {
          const { h, m } = roundTo15(hours, minutes);
          if (timeFor === 'start') setTimes((t) => ({ ...t, start: { h, m } }));
          else setTimes((t) => ({ ...t, end: { h, m } }));
          setTimeFor(null);
        }}
      />
    </View>
  );
}

react-native-datepicker (deprecated; string-based API)

import React, { useState } from 'react';
import { View, Text } from 'react-native';
import DatePicker from 'react-native-datepicker';

// Note: values are strings formatted per the `format` prop.
export function RangePicker() {
  const [start, setStart] = useState<string>('');
  const [end, setEnd] = useState<string>('');
  const format = 'YYYY-MM-DD HH:mm';

  return (
    <View>
      <Text>Start</Text>
      <DatePicker
        date={start}
        mode="datetime"
        format={format}
        minuteInterval={15}
        onDateChange={(s) => setStart(s)}
      />
      <Text>End</Text>
      <DatePicker
        date={end}
        mode="datetime"
        format={format}
        minDate={start || undefined}
        minuteInterval={15}
        onDateChange={(s) => setEnd(s)}
      />
    </View>
  );
}

Limitations: here, "minDate" comparison is string-based, and you’ll need to parse/compare when validating end ≥ start. Interop with Date-centric code requires conversion.

When range selection is first-class, validation becomes declarative

Only react-native-paper-dates exposes range selection directly, enabling constraints via validRange and providing structured callback payloads. With native-based libraries, range validation is implemented at the application layer (e.g., choosing min/max dynamically for the second picker).

Theming and UI consistency versus platform fidelity

  • Native-based libraries inherit the OS typographic rhythm, dark mode, and accessibility without design-system coupling.
  • react-native-paper-dates delivers consistent Material theming across platforms and aligns with react-native-paper components (TextInput, Buttons), ensuring a coherent overall UI.

Dependency and packaging considerations

  • react-native-modal-datetime-picker depends on @react-native-community/datetimepicker, so you manage both packages and their platform configs.
  • react-native-paper-dates depends on react-native-paper and its theming/provider setup.
  • react-native-date-picker ships as a native module with no design-system peer deps.
  • react-native-datepicker is deprecated and aligned with older RN lifecycles.

Summary table

Dimensionreact-native-date-pickerreact-native-modal-datetime-pickerreact-native-paper-datesreact-native-datepicker
Primary approachNative inline/modal pickerNative picker in a modal wrapperJS Material calendar/time UILegacy custom UI
Value typeDateDateDate (+ hours/min payload for time)String
Range selectionApp-managed (two picks)App-managed (two picks)Built-in (mode="range")App-managed (two picks)
Min/Max constraintsminimumDate/maximumDateminimumDate/maximumDatevalidRangeminDate/maxDate (string-based)
LocaleInherits device; optional override (platform-dependent)Inherits device; optional override (forwarded)Prop-driven localeProp-driven formatting
ThemingSystem-nativeSystem-nativereact-native-paper themeLimited/legacy
Time intervalminuteIntervalminuteIntervalApp logic (rounding)minuteInterval (legacy)
AccessibilityNative controlNative control in modalJS control using react-native-paper a11yLegacy a11y
Peer depsNone@react-native-community/datetimepickerreact-native-paperNone (deprecated)
Bundle impactLow native + light JSLow native + wrapperHigher (JS UI + design system)Legacy footprint

The pattern reveals a split between native-control wrappers optimized for platform fidelity and lean state handling versus a design-system implementation optimized for theming, higher-level UX (like ranges), and cross-platform visual consistency.

How to Choose: react-native-modal-datetime-picker vs react-native-date-picker vs react-native-paper-dates vs react-native-datepicker
  • react-native-modal-datetime-picker:

    Pick react-native-modal-datetime-picker if your UX favors a modal confirm/cancel flow using the system’s native date/time UI. It wraps @react-native-community/datetimepicker and forwards most of its capabilities while giving you a clean imperative API for visibility and lifecycle events. It works well in screens where you want to avoid inline pickers and prefer predictable modal ergonomics. Expect to handle your own layout and theming around the modal rather than the control itself.

  • react-native-date-picker:

    Choose react-native-date-picker when you want a native-feeling control with minimal dependencies and the option to embed inline or open as a modal. It returns Date objects and exposes common native features (min/max, minute intervals) across platforms with a consistent prop model. Theming is limited to what the platform provides, but UX predictability and performance are strong. It’s well-suited for forms that need a stable, low-level date/time primitive without a design-system dependency.

  • react-native-paper-dates:

    Use react-native-paper-dates when your app already uses react-native-paper (MD2/MD3) and you want consistent cross-platform theming, built-in range selection, and input-field patterns. It’s a JS-driven calendar/time UI that provides powerful features like validRange, locale-aware formatting, and accessible keyboard navigation within the Material design system. The trade-off is a non-native picker experience and a heavier UI dependency, but you gain cohesive theming and higher-level components. It shines in apps that prioritize design-system fidelity over strict platform-native appearance.

  • react-native-datepicker:

    Do not use react-native-datepicker for new projects. It is deprecated and relies on older patterns (string-based values and legacy React Native APIs) that complicate interop with modern TypeScript/JS date handling and validation. Existing codebases may keep it running for continuity, but the maintenance and ecosystem risks outweigh its utility. Evaluate maintained alternatives that return Date objects and integrate with current platform APIs.

README for react-native-modal-datetime-picker

react-native-modal-datetime-picker

npm version Supports Android and iOS

A declarative cross-platform react-native date and time picker.

This library exposes a cross-platform interface for showing the native date-picker and time-picker inside a modal, providing a unified user and developer experience.

Under the hood, this library is using @react-native-community/datetimepicker.

Setup (for non-Expo projects)

If your project is not using Expo, install the library and the community date/time picker using npm or yarn:

# using npm
$ npm i react-native-modal-datetime-picker @react-native-community/datetimepicker

# using yarn
$ yarn add react-native-modal-datetime-picker @react-native-community/datetimepicker

Please notice that the @react-native-community/datetimepicker package is a native module so it might require manual linking.

Setup (for Expo projects)

If your project is using Expo, install the library and the community date/time picker using the Expo CLI:

npx expo install react-native-modal-datetime-picker @react-native-community/datetimepicker

To ensure the picker theme respects the device theme, you should also configure the appearance styles in your app.json this way:

{
  "expo": {
    "userInterfaceStyle": "automatic"
  }
}

Refer to the Appearance documentation on Expo for more info.

Usage

import React, { useState } from "react";
import { Button, View } from "react-native";
import DateTimePickerModal from "react-native-modal-datetime-picker";

const Example = () => {
  const [isDatePickerVisible, setDatePickerVisibility] = useState(false);

  const showDatePicker = () => {
    setDatePickerVisibility(true);
  };

  const hideDatePicker = () => {
    setDatePickerVisibility(false);
  };

  const handleConfirm = (date) => {
    console.warn("A date has been picked: ", date);
    hideDatePicker();
  };

  return (
    <View>
      <Button title="Show Date Picker" onPress={showDatePicker} />
      <DateTimePickerModal
        isVisible={isDatePickerVisible}
        mode="date"
        onConfirm={handleConfirm}
        onCancel={hideDatePicker}
      />
    </View>
  );
};

export default Example;

Available props

👉 Please notice that all the @react-native-community/react-native-datetimepicker props are supported as well!

NameTypeDefaultDescription
buttonTextColorIOSstringThe color of the confirm button texts (iOS)
backdropStyleIOSstyleThe style of the picker backdrop view style (iOS)
cancelButtonTestIDstringUsed to locate cancel button in end-to-end tests
cancelTextIOSstring"Cancel"The label of the cancel button (iOS)
confirmButtonTestIDstringUsed to locate confirm button in end-to-end tests
confirmTextIOSstring"Confirm"The label of the confirm button (iOS)
customCancelButtonIOScomponentOverrides the default cancel button component (iOS)
customConfirmButtonIOScomponentOverrides the default confirm button component (iOS)
customHeaderIOScomponentOverrides the default header component (iOS)
customPickerIOScomponentOverrides the default native picker component (iOS)
dateobjnew Date()Initial selected date/time
isVisibleboolfalseShow the datetime picker?
isDarkModeEnabledbool?undefinedForces the picker dark/light mode if set (otherwise fallbacks to the Appearance color scheme) (iOS)
modalPropsIOSobject{}Additional modal props for iOS
modalStyleIOSstyleStyle of the modal content (iOS)
modestring"date"Choose between "date", "time", and "datetime"
onCancelfuncREQUIREDFunction called on dismiss
onChangefunc() => nullFunction called when the date changes (with the new date as parameter).
onConfirmfuncREQUIREDFunction called on date or time picked. It returns the date or time as a JavaScript Date object
onHidefunc() => nullCalled after the hide animation
pickerContainerStyleIOSstyleThe style of the picker container (iOS)
pickerStyleIOSstyleThe style of the picker component wrapper (iOS)
pickerComponentStyleIOSstyleThe style applied to the actual picker component - this can be either a native iOS picker or a custom one if customPickerIOS was provided

Frequently Asked Questions

This repo is only maintained by me, and unfortunately I don't have enough time for dedicated support & question. If you're experiencing issues, please check the FAQs below.
For questions and support, please start try starting a discussion or try asking it on StackOverflow.
⚠️ Please use the GitHub issues only for well-described and reproducible bugs. Question/support issues will be closed.

The component is not working as expected, what should I do?

Under the hood react-native-modal-datetime-picker uses @react-native-community/datetimepicker. If you're experiencing issues, try swapping react-native-datetime-picker with @react-native-community/datetimepicker. If the issue persists, check if it has already been reported as a an issue or check the other FAQs.

How can I show the timepicker instead of the datepicker?

Set the mode prop to time. You can also display both the datepicker and the timepicker in one step by setting the mode prop to datetime.

Why is the initial date not working?

Please make sure you're using the date props (and not the value one).

Can I use the new iOS 14 style for the date/time picker?

Yes!
You can set the display prop (that we'll pass down to react-native-datetimepicker) to inline to use the new iOS 14 picker.

Please notice that you should probably avoid using this new style with a time-only picker (so with mode set to time) because it doesn't suit well this use case.

Why does the picker show up twice on Android?

This seems to be a known issue of the @react-native-community/datetimepicker. Please see this thread for a couple of workarounds. The solution, as described in this reply is hiding the modal, before doing anything else.

Example of solution using Input + DatePicker

The most common approach for solving this issue when using an Input is:

  • Wrap your Input with a "Pressable"/Button (TouchableWithoutFeedback/TouchableOpacity + activeOpacity={1} for example)
  • Prevent Input from being focused. You could set editable={false} too for preventing Keyboard opening
  • Triggering your hideModal() callback as a first thing inside onConfirm/onCancel callback props
const [isVisible, setVisible] = useState(false);
const [date, setDate] = useState('');

<TouchableOpacity
  activeOpacity={1}
  onPress={() => setVisible(true)}>
  <Input
    value={value}
    editable={false} // optional
  />
</TouchableOpacity>
<DatePicker
  isVisible={isVisible}
  onConfirm={(date) => {
    setVisible(false); // <- first thing
    setValue(parseDate(date));
  }}
  onCancel={() => setVisible(false)}
/>

How can I allow picking only specific dates?

You can't — @react-native-community/datetimepicker doesn't allow you to do so. That said, you can allow only "range" of dates by setting a minimum and maximum date. See below for more info.

How can I set a minimum and/or maximum date?

You can use the minimumDate and maximumDate props from @react-native-community/datetimepicker.

How do I change the color of the Android date and time pickers?

This is more a React-Native specific question than a react-native-modal-datetime-picker one.
See issue #29 and #106 for some solutions.

How to set a 24-hours format in iOS?

The is24Hour prop is only available on Android but you can use a small hack for enabling it on iOS by setting the picker timezone to en_GB:

<DatePicker
  mode="time"
  locale="en_GB" // Use "en_GB" here
  date={new Date()}
/>

How can I change the picker language/locale?

Under the hood this library is using @react-native-community/datetimepicker. You can't change the language/locale from react-native-modal-datetime-picker. Locale/language is set at the native level, on the device itself.

How can I set an automatic locale in iOS?

On iOS, you can set an automatic detection of the locale (fr_FR, en_GB, ...) depending on the user's device locale. To do so, edit your AppDelegate.m file and add the following to didFinishLaunchingWithOptions.

// Force DatePicker locale to current language (for: 24h or 12h format, full day names etc...)
NSString *currentLanguage = [[NSLocale preferredLanguages] firstObject];
[[UIDatePicker appearance] setLocale:[[NSLocale alloc]initWithLocaleIdentifier:currentLanguage]];

Why is the picker is not showing the right layout on iOS >= 14?

Please make sure you're on the latest version of react-native-modal-datetime-picker and of the @react-native-community/datetimepicker. We already closed several iOS 14 issues that were all caused by outdated/cached versions of the community datetimepicker.

Why is the picker not visible/transparent on iOS?

Please make sure you're on the latest version of react-native-modal-datetime-picker and of @react-native-community/datetimepicker. Also, double-check that the picker light/dark theme is aligned with the OS one (e.g., don't "force" a theme using isDarkModeEnabled).

Why can't I show an alert after the picker has been hidden (on iOS)?

Unfortunately this is a know issue with React-Native on iOS. Even by using the onHide callback exposed by react-native-modal-datetime-picker you might not be able to show the (native) alert successfully. The only workaround that seems to work consistently for now is to wrap showing the alter in a setTimeout 😔:

const handleHide = () => {
  setTimeout(() => Alert.alert("Hello"), 0);
};

See issue #512 for more info.

Why does the date of onConfirm not match the picked date (on iOS)?

On iOS, clicking the "Confirm" button while the spinner is still in motion — even just slightly in motion — will cause the onConfirm callback to return the initial date instead of the picked one. This is is a long standing iOS issue (that can happen even on native app like the iOS calendar) and there's no failproof way to fix it on the JavaScript side.
See this GitHub gist for an example of how it might be solved at the native level — but keep in mind it won't work on this component until it has been merged into the official React-Native repo.

Related issue in the React-Native repo here.

How do I make it work with snapshot testing?

See issue #216 for a possible workaround.

Contributing

Please see the contributing guide.

License

The library is released under the MIT license. For more details see LICENSE.