DateRangePicker

KO | EN

gitlite — search

#react #typescript #go #android #machine-learning #deep-learning #docker #macos #nodejs #windows #cli #awesome-list #pytorch #mcp

DateRangePicker

(★ 131)

The best (?) date range picker control for OS X.

File Explorer

Download Latest Version (.zip)

- - contents.xcworkspacedata
- project.pbxproj
- - Main.storyboard
- AppDelegate.swift
- Info.plist
- ViewController.swift
- ControlVariants.png
- Menu.png
- Popover.png
- - DateErrorLogger.swift
  - DateRange.swift
  - DateRangeButton.swift
  - DateRangePickerView.swift
  - DoubleClickDateRangePicker.swift
  - ExpandedDateRangePickerController.swift
  - LocalizationHelper.swift
  - NSDate_DateRangePicker.swift
- - AssetTests.swift
  - DateRangeTest.swift
  - NSDate_DateRangePickerTest.swift
- - DateRangePicker.h
  - Info.plist
- - Info.plist
.gitignore
DateRangePicker.podspec
LICENSE
localize.sh
Package.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DateRangePicker - the best (?) date range picker control for OS X

Developed for and used in [Timing, the automatic time/productivity tracking app for Mac](https://timingapp.com).

![The popover for customized date ranges](https://raw.githubusercontent.com/Timing-GmbH/DateRangePicker/master/Screenshots/Popover.png)
![Some possible looks for the control](https://raw.githubusercontent.com/Timing-GmbH/DateRangePicker/master/Screenshots/ControlVariants.png)
![The menu for preset date ranges](https://raw.githubusercontent.com/Timing-GmbH/DateRangePicker/master/Screenshots/Menu.png)

## Usage

Just drag the date range picker onto your Storyboard or Nib. It looks particularly good in the toolbar with segmentStyle = .Separated. If you wish to center the picker in the toolbar, I can recommend using [TAAdaptiveSpaceItem](https://github.com/timothyarmes/TAAdaptiveSpaceItem).

You can observe changes in the date range by key-value-observing startDate and endDate and/or setting a target and action on the DateRangePickerView control.

## Features

- Perfect for use in a toolbar, but can also be used anywhere else
- Date range presets: "Last 7/15/30/90/365 days", "Today/Yesterday/This week/month/quarter/year"
- Pretty display of these presets as well as previous/future months (as e.g. "October 2015")
- "Back" and "Forward" buttons let you shift the date range by its current duration, e.g. 7 days earlier/later, previous/next month/week/quarter/year
  - I.e. "real" month-by-month stepping through the data, not in simple 30-day intervals
- Completely custom date ranges selectable in a popover (which can be used without the control as well)
- Lets you specify minimum and maximum dates that can not be exceeded
  - These are reflected in the interface - the "Back"/"Forward" buttons get disabled when the date range reaches the minimum/maximum
- Provides a sophisticated, serializable (so you can persist it between launches of your app) date range structure (implemented as a Swift enum)
- Provides some useful date computation functions as an extension to NSDate
- Usable from Objective-C
  - Exposes KVO/KVC-compatible startDate and endDate properties
  - Date range changes are also sent via NSControl's target-action pattern
  - Exposes -dateRangeAsData and -loadDateRangeFromData: methods that let you persist the date range in Objective-C as well
  - The NSDate extensions are also available from NSDate
- Customizable segmented control styles
- Localizations: English, German (feel free to add others!)
- High code quality
  - Adheres to Cocoa "Best Practices" (if you find any antipatterns, let me know)
  - Full test coverage for the date range structure and date computations
- Interface Builder-compatible (@IBDesignable)
- Small and self-contained

## What's missing

- The date presets can currently not be customized (but you can easily replace them in ExpandedDateRangePickerController)
- Date presets for "Last month/week/quarter/year" and "Next month/week/quarter/year" are currently not available (but could be added easily, and you can still reach them by selecting "This week/month/quarter/year" and then pressing "Back"/"Forward")
- Found something else? Submit a pull request or contact me :-)

## Compatibility

Requires (and tested on) OS X 10.9 or later. Looks a lot better in the toolbar with OS X 10.10 ;-)

### Usage in toolbars on macOS 26

To ensure that the date range picker is rendered as a toolbar item with a "Liquid Glass" effect on macOS 26, make sure
to set the containing toolbar item's `isBordered` property to `true`.

### Notes for legacy Nibs

If your Nib uses the old initWithFrame: initialization or is deflated on OS X 10.9, there is a bug with custom views in NSToolbar. This results in the date range picker's frame not being initialized correctly. In order to avoid this, I recommend the following procedure:

- Create a dummy NSToolbarItem with an empty Custom View of the desired size and add an IBOutlet for the NSToolbarItem
- Add the picker as a standalone view to the Nib and add an IBOutlet for it as well
- In -awakeFromNib, programmatically set the toolbar item's view to be the picker

## License

This library is available under the [ISC license](http://choosealicense.com/licenses/isc/), which is a simplified variant of the two-clause BSD license.

If you use this library, I appreciate if you let me know [@daniel\_a\_a](https://twitter.com/daniel_a_a) on Twitter. I also have a [blog](https://danielalm.de).

DateRangePicker

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

DateRangePicker

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README