This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

一个 DateTimePicker 组件，其 API 与 @react-native-community/datetimepicker 兼容。它在 Android 上使用 Jetpack Compose，在 iOS 上使用 SwiftUI，默认提供现代的 Material 3 和 SwiftUI 外观（社区模块在 Android 上默认使用较旧的外观）。

🌐 A DateTimePicker component with an API compatible with @react-native-community/datetimepicker. It uses Jetpack Compose on Android and SwiftUI on iOS, providing a modern Material 3 and SwiftUI appearance by default (the community module defaults to the older look on Android).

DateTimePicker 组件是完全声明式的。使用 presentation 属性可以直接在视图层次中渲染选择器 'inline'，或在 Android 上作为 'dialog' 渲染。Android 上没有命令式 API (DateTimePickerAndroid.open())。

在内部，这个组件封装了平台特定的 @expo/ui 原语：

🌐 Under the hood this component wraps the platform-specific @expo/ui primitives:

• Android： Jetpack Compose 日期时间选择器（内联），日期选择器对话框/时间选择器对话框（对话框）
• iOS: SwiftUI 日期选择器

如果你需要更底层的控制（自定义修改器、样式或布局），请直接使用这些基本元素。

🌐 If you need lower-level control (custom modifiers, styles, or layouts), use those primitives directly.

安装

🌐 Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

从 @react-native-community/datetimepicker 迁移

🌐 Migrating from @react-native-community/datetimepicker

• 将导入从 import DateTimePicker from '@react-native-community/datetimepicker' 更新为 import DateTimePicker from '@expo/ui/community/datetime-picker'。
• 没有强制性的 DateTimePickerAndroid.open() API。渲染组件并改用 presentation="dialog"。
• minuteInterval、textColor、firstDayOfWeek、neutralButton、onNeutralButtonPress、fullscreen、title 和 startOnYearSelection 属性不受支持。
• 使用 timeZoneName（IANA 名称）代替 timeZoneOffsetInMinutes。
• countdown 模式不被支持。
• onError 属性不需要。

基本用法

🌐 Basic usage

import { useState } from 'react';
import DateTimePicker from '@expo/ui/community/datetime-picker';

export default function DateTimePickerExample() {
  const [date, setDate] = useState(new Date());

  return (
    <DateTimePicker
      value={date}
      onValueChange={(event, selectedDate) => {
        setDate(selectedDate);
      }}
      mode="date"
    />
  );
}

时间选择器

🌐 Time picker

import { useState } from 'react';
import DateTimePicker from '@expo/ui/community/datetime-picker';

export default function TimePickerExample() {
  const [date, setDate] = useState(new Date());

  return (
    <DateTimePicker
      value={date}
      onValueChange={(event, selectedDate) => {
        setDate(selectedDate);
      }}
      mode="time"
    />
  );
}

有日期限制

🌐 With date constraints

import { useState } from 'react';
import DateTimePicker from '@expo/ui/community/datetime-picker';

const today = new Date();
const thirtyDaysFromNow = new Date(today.getTime() + 30 * 24 * 60 * 60 * 1000);

export default function ConstrainedDatePickerExample() {
  const [date, setDate] = useState(new Date());

  return (
    <DateTimePicker
      value={date}
      onValueChange={(event, selectedDate) => {
        setDate(selectedDate);
      }}
      mode="date"
      minimumDate={today}
      maximumDate={thirtyDaysFromNow}
    />
  );
}

对话展示

🌐 Dialog presentation

在 Android 上，你可以使用 presentation="dialog" 将选择器显示为模态对话框。组件挂载时对话框会打开。在响应 onValueChange 或 onDismiss 时卸载它。在 iOS 上，此属性会被忽略，选择器始终以内联方式呈现。

🌐 On Android, you can use presentation="dialog" to show the picker as a modal dialog. The dialog opens when the component mounts. Unmount it in response to onValueChange or onDismiss. On iOS, this prop is ignored and the picker always renders inline.

import { useState } from 'react';
import { Button, View } from 'react-native';
import DateTimePicker from '@expo/ui/community/datetime-picker';

export default function AndroidDialogExample() {
  const [date, setDate] = useState(new Date());
  const [show, setShow] = useState(false);

  return (
    <View>
      <Button title="选择一个日期" onPress={() => setShow(true)} />
      {show && (
        <DateTimePicker
          value={date}
          onValueChange={(event, selectedDate) => {
            setShow(false);
            setDate(selectedDate);
          }}
          onDismiss={() => {
            setShow(false);
          }}
          mode="date"
          presentation="dialog"
        />
      )}
    </View>
  );
}

应用接口

🌐 API

import DateTimePicker from '@expo/ui/community/datetime-picker';

Component

Types