<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSDatePicker",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSDatePicker"
  },
  "title" : "NSDatePicker"
}
-->

# NSDatePicker

A display of a calendar date with controls for editing the date value.

```
class NSDatePicker
```

## Overview

`NSDatePicker` uses an [`NSDatePickerCell`](/documentation/AppKit/NSDatePickerCell) to implement much of the control’s functionality. `NSDatePicker` provides cover methods for most of `NSDatePickerCell` methods, which invoke the corresponding cell method.

## Topics

### Configuring Date Pickers

[`bezeled`](/documentation/AppKit/NSDatePicker/isBezeled)

A Boolean value that indicates whether the date picker draws a bezeled border.

[`bordered`](/documentation/AppKit/NSDatePicker/isBordered)

A Boolean value that indicates whether the date picker has a plain border.

[`backgroundColor`](/documentation/AppKit/NSDatePicker/backgroundColor)

The date picker’s background color.

[`drawsBackground`](/documentation/AppKit/NSDatePicker/drawsBackground)

A Boolean value that indicates whether the date picker draws the background.

[`textColor`](/documentation/AppKit/NSDatePicker/textColor)

The date picker’s text color.

[`datePickerStyle`](/documentation/AppKit/NSDatePicker/datePickerStyle)

The date picker’s style.

[`presentsCalendarOverlay`](/documentation/AppKit/NSDatePicker/presentsCalendarOverlay)

A Boolean value that indicates whether to present a graphical calendar overlay when editing a calendar element within a text-field style date picker.

[`delegate`](/documentation/AppKit/NSDatePicker/delegate)

A delegate for the date picker’s cell

[`datePickerElements`](/documentation/AppKit/NSDatePicker/datePickerElements)

A bitmask that indicates which visual elements of the date picker are currently shown, and which won’t be usable because they are hidden.

[`ElementFlags`](/documentation/AppKit/NSDatePicker/ElementFlags)

Constants that specify the date and time elements displayed by the picker.

[`Style`](/documentation/AppKit/NSDatePicker/Style)

Constants that define the visual appearance of the date picker cell.

### Controlling Date Picker Range and Mode

[`calendar`](/documentation/AppKit/NSDatePicker/calendar)

The calendar used by the date picker.

[`locale`](/documentation/AppKit/NSDatePicker/locale)

The date picker’s locale.

[`datePickerMode`](/documentation/AppKit/NSDatePicker/datePickerMode)

The date picker’s mode.

[`timeZone`](/documentation/AppKit/NSDatePicker/timeZone)

The time zone for the date picker.

[`Mode`](/documentation/AppKit/NSDatePicker/Mode)

Constants that define whether the picker provides a single date, or a range of dates.

### Accessing Object Values

[`dateValue`](/documentation/AppKit/NSDatePicker/dateValue)

The date selected by the date picker.

[`timeInterval`](/documentation/AppKit/NSDatePicker/timeInterval)

The time interval selected by the date picker.

### Constraining the Displayable/Selectable Range

[`minDate`](/documentation/AppKit/NSDatePicker/minDate)

The date picker’s minimum date value.

[`maxDate`](/documentation/AppKit/NSDatePicker/maxDate)

The date picker’s maximum date value.

## Relationships

### Conforms To

[`NSAccessibilityProtocol`](/documentation/AppKit/NSAccessibilityProtocol)

[`NSTouchBarProvider`](/documentation/AppKit/NSTouchBarProvider)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`NSStandardKeyBindingResponding`](/documentation/AppKit/NSStandardKeyBindingResponding)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSDraggingDestination`](/documentation/AppKit/NSDraggingDestination)

[`NSAnimatablePropertyContainer`](/documentation/AppKit/NSAnimatablePropertyContainer)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`NSUserInterfaceItemIdentification`](/documentation/AppKit/NSUserInterfaceItemIdentification)

[`NSAppearanceCustomization`](/documentation/AppKit/NSAppearanceCustomization)

[`NSAccessibilityElementProtocol`](/documentation/AppKit/NSAccessibilityElementProtocol)

[`Sendable`](/documentation/Swift/Sendable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSUserActivityRestoring`](/documentation/AppKit/NSUserActivityRestoring)

[`Equatable`](/documentation/Swift/Equatable)

[`NSCoding`](/documentation/Foundation/NSCoding)

### Inherits From

[`NSControl`](/documentation/AppKit/NSControl)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)