Structure

DatePicker

A control for selecting an absolute date. 絶対日付を選択するためのコントロール。

Declaration 宣言

struct DatePicker<Label> where Label : View

Overview 概要

Use a DatePicker when you want to provide a view that allows the user to select a calendar date, and optionally a time. The view binds to a Date instance.

The following example creates a basic DatePicker, which appears on iOS as text representing the date. This example limits the display to only the calendar date, not the time. When the user taps or clicks the text, a calendar view animates in, from which the user can select a date. When the user dismisses the calendar view, the view updates the bound Date.


@State private var date = Date()


var body: some View {
    DatePicker(
        "Start Date",
        selection: $date,
        displayedComponents: [.date]
    )
}

An iOS date picker, consisting of a label that says Start Date, and a

You can limit the DatePicker to specific ranges of dates, allowing selections only before or after a certain date, or between two dates. The following example shows a date-and-time picker that only permits selections within the year 2021 (in the UTC time zone).


@State private var date = Date()
let dateRange: ClosedRange<Date> = {
    let calendar = Calendar.current
    let startComponents = DateComponents(year: 2021, month: 1, day: 1)
    let endComponents = DateComponents(year: 2021, month: 12, day: 31, hour: 23, minute: 59, second: 59)
    return calendar.date(from:startComponents)!
        ...
        calendar.date(from:endComponents)!
}()


var body: some View {
    DatePicker(
        "Start Date",
         selection: $date,
         in: dateRange,
         displayedComponents: [.date, .hourAndMinute]
    )
}

A SwiftUI standard date picker on iOS, with the label Start Date, and

Styling Date Pickers 日付ピッカーのスタイルを決める

To use a different style of date picker, use the datePickerStyle(_:) view modifier. The following example shows the graphical date picker style.


@State private var date = Date()


var body: some View {
    DatePicker(
        "Start Date",
        selection: $date,
        displayedComponents: [.date]
    )
    .datePickerStyle(.graphical)
}

A SwiftUI date picker using the graphical style, with the label Start Date

Topics 話題

Creating a Date Picker for Any Date

Creating a Date Picker for a Range

Creating a Date Picker with a Start Date

Creating a Date Picker with an End Date

Setting Date Picker Components

Styling Date Pickers 日付ピッカーのスタイルを決める

Supporting Types 支援を行う型

Default Implementations 省略時実装

Relationships 関係

Conforms To 次に準拠

See Also 参照

Pickers