DatePickerDialog (library 1.0.0 API)

java.lang.Object
- android.app.Fragment
- - android.app.DialogFragment
  - - com.kenmeidearu.materialdatetimepicker.date.DatePickerDialog

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2, android.content.DialogInterface.OnCancelListener, android.content.DialogInterface.OnDismissListener, android.view.View.OnClickListener, android.view.View.OnCreateContextMenuListener, DatePickerController
```
public class DatePickerDialog
extends android.app.DialogFragment
implements android.view.View.OnClickListener, DatePickerController
```
Dialog allowing users to select a date.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`DatePickerDialog.OnDateChangedListener` The callback used to notify other date picker components of a change in selected date.
`static interface`	`DatePickerDialog.OnDateSetListener` The callback used to indicate the user is done filling in the date.

Nested classes/interfaces inherited from class android.app.Fragment
android.app.Fragment.InstantiationException, android.app.Fragment.SavedState

Field Summary

Fields
Modifier and Type Field and Description

static int AM

static int HOUR_INDEX

static int MINUTE_INDEX

static int PM

static int SECOND_INDEX
- Fields inherited from class android.app.DialogFragment
  STYLE_NO_FRAME, STYLE_NO_INPUT, STYLE_NO_TITLE, STYLE_NORMAL
- Fields inherited from interface android.content.ComponentCallbacks2
  TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Fields
Modifier and Type	Field and Description
`static int`	`AM`
`static int`	`HOUR_INDEX`
`static int`	`MINUTE_INDEX`
`static int`	`PM`
`static int`	`SECOND_INDEX`

Constructor Summary

Constructors
Constructor and Description

DatePickerDialog()

Constructors
Constructor and Description
`DatePickerDialog()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`autoDismiss(boolean autoDismiss)` Set whether the picker should dismiss itself when a day is selected
`void`	`dateOnly(boolean dateonly)`
`void`	`dismissOnPause(boolean dismissOnPause)` Set whether the picker should dismiss itself when being paused or whether it should try to survive an orientation change
`void`	`enableMinutes(boolean enableMinutes)` Set whether the picker for minutes should be shown Will disable seconds if minutes are disbled
`void`	`enableSeconds(boolean enableSeconds)` Set whether an additional picker for seconds should be shown Will enable minutes picker as well if seconds picker should be shown
`int`	`getAccentColor()` Get the accent color of this dialog
`java.util.Calendar[]`	`getDisabledDays()`
`java.util.Calendar`	`getEndDate()`
`int`	`getFirstDayOfWeek()`
`java.util.Calendar[]`	`getHighlightedDays()`
`int`	`getIsCurrentlyAmOrPm()`
`java.util.Calendar`	`getMaxDate()`
`int`	`getMaxMonth()`
`int`	`getMaxYear()`
`java.util.Calendar`	`getMinDate()`
`int`	`getMinMonth()`
`int`	`getMinYear()`
`java.util.Calendar[]`	`getSelectableDays()`
`MonthAdapter.CalendarDay`	`getSelectedDay()`
`java.util.Calendar`	`getStartDate()`
`void`	`initialize(DatePickerDialog.OnDateSetListener callBack, int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minute, int second, boolean is24HourMode)`
`boolean`	`isOutOfRange(java.util.Calendar calendar)`
`boolean`	`isOutOfRange(int year, int month, int day)`
`boolean`	`isThemeDark()` Returns true when the dark theme should be used
`static DatePickerDialog`	`newInstance(DatePickerDialog.OnDateSetListener callBack, int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minute, boolean is24HourMode)`
`void`	`notifyOnDateListener()`
`void`	`onCancel(android.content.DialogInterface dialog)`
`void`	`onClick(android.view.View v)`
`void`	`onConfigurationChanged(android.content.res.Configuration newConfig)`
`void`	`onCreate(android.os.Bundle savedInstanceState)`
`android.app.Dialog`	`onCreateDialog(android.os.Bundle savedInstanceState)`
`android.view.View`	`onCreateView(android.view.LayoutInflater inflater, android.view.ViewGroup container, android.os.Bundle savedInstanceState)`
`void`	`onDayOfMonthSelected(int year, int month, int day)`
`void`	`onDismiss(android.content.DialogInterface dialog)`
`void`	`onMonthSelected(int month)`
`void`	`onPause()`
`void`	`onResume()`
`void`	`onSaveInstanceState(android.os.Bundle outState)`
`void`	`onTimeSelected(int value, java.lang.String type)`
`void`	`onYearSelected(int year)`
`void`	`registerOnDateChangedListener(DatePickerDialog.OnDateChangedListener listener)`
`void`	`setAccentColor(int color)` Set the accent color of this dialog
`void`	`setAccentColor(java.lang.String color)` Set the accent color of this dialog
`void`	`setAmOrPm(int amOrPm)`
`void`	`setCancelText(int cancelResid)` Set the label for the Cancel button (max 12 characters)
`void`	`setCancelText(java.lang.String cancelString)` Set the label for the Cancel button (max 12 characters)
`void`	`setDisabledDays(java.util.Calendar[] disabledDays)` Sets a list of days that are not selectable in the picker Setting this value will take precedence over using setMinDate() and setMaxDate(), but stacks with setSelectableDays()
`void`	`setFirstDayOfWeek(int startOfWeek)`
`void`	`setHighlightedDays(java.util.Calendar[] highlightedDays)` Sets an array of dates which should be highlighted when the picker is drawn
`void`	`setMaxDate(java.util.Calendar calendar)` Sets the minimal date supported by this DatePicker.
`void`	`setMinDate(java.util.Calendar calendar)` Sets the minimal date supported by this DatePicker.
`void`	`setOkText(int okResid)` Set the label for the Ok button (max 12 characters)
`void`	`setOkText(java.lang.String okString)` Set the label for the Ok button (max 12 characters)
`void`	`setOnCancelListener(android.content.DialogInterface.OnCancelListener onCancelListener)`
`void`	`setOnDateSetListener(DatePickerDialog.OnDateSetListener listener)`
`void`	`setOnDismissListener(android.content.DialogInterface.OnDismissListener onDismissListener)`
`void`	`setSelectableDays(java.util.Calendar[] selectableDays)` Sets a list of days which are the only valid selections.
`void`	`setThemeDark(boolean themeDark)` Set whether the dark theme should be used
`void`	`setTitle(java.lang.String title)` Set a title to be displayed instead of the weekday
`void`	`setYearRange(int startYear, int endYear)`
`void`	`showMonthPickerFirst(boolean monthPicker)`
`void`	`showYearPickerFirst(boolean yearPicker)` Set whether the year picker of the month and day picker is shown first
`void`	`tryVibrate()`
`void`	`unregisterOnDateChangedListener(DatePickerDialog.OnDateChangedListener listener)`
`void`	`vibrate(boolean vibrate)` Set whether the device should vibrate when touching fields

Methods inherited from class android.app.DialogFragment
dismiss, dismissAllowingStateLoss, dump, getDialog, getShowsDialog, getTheme, isCancelable, onActivityCreated, onAttach, onDestroyView, onDetach, onStart, onStop, setCancelable, setShowsDialog, setStyle, show, show

Methods inherited from class android.app.Fragment
equals, getActivity, getAllowEnterTransitionOverlap, getAllowReturnTransitionOverlap, getArguments, getChildFragmentManager, getContext, getEnterTransition, getExitTransition, getFragmentManager, getHost, getId, getLoaderManager, getParentFragment, getReenterTransition, getResources, getRetainInstance, getReturnTransition, getSharedElementEnterTransition, getSharedElementReturnTransition, getString, getString, getTag, getTargetFragment, getTargetRequestCode, getText, getUserVisibleHint, getView, hashCode, instantiate, instantiate, isAdded, isDetached, isHidden, isInLayout, isRemoving, isResumed, isVisible, onActivityResult, onAttach, onContextItemSelected, onCreateAnimator, onCreateContextMenu, onCreateOptionsMenu, onDestroy, onDestroyOptionsMenu, onHiddenChanged, onInflate, onInflate, onInflate, onLowMemory, onOptionsItemSelected, onOptionsMenuClosed, onPrepareOptionsMenu, onRequestPermissionsResult, onTrimMemory, onViewCreated, onViewStateRestored, registerForContextMenu, requestPermissions, setAllowEnterTransitionOverlap, setAllowReturnTransitionOverlap, setArguments, setEnterSharedElementCallback, setEnterTransition, setExitSharedElementCallback, setExitTransition, setHasOptionsMenu, setInitialSavedState, setMenuVisibility, setReenterTransition, setRetainInstance, setReturnTransition, setSharedElementEnterTransition, setSharedElementReturnTransition, setTargetFragment, setUserVisibleHint, shouldShowRequestPermissionRationale, startActivity, startActivity, startActivityForResult, startActivityForResult, toString, unregisterForContextMenu

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - HOUR_INDEX
```
public static final int HOUR_INDEX
```
    See Also:
    
    Constant Field Values
  - MINUTE_INDEX
```
public static final int MINUTE_INDEX
```
    See Also:
    
    Constant Field Values
  - SECOND_INDEX
```
public static final int SECOND_INDEX
```
    See Also:
    
    Constant Field Values
  - AM
```
public static final int AM
```
    See Also:
    
    Constant Field Values
  - PM
```
public static final int PM
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DatePickerDialog
```
public DatePickerDialog()
```
- Method Detail
  - newInstance
```
public static DatePickerDialog newInstance(DatePickerDialog.OnDateSetListener callBack,
                                           int year,
                                           int monthOfYear,
                                           int dayOfMonth,
                                           int hourOfDay,
                                           int minute,
                                           boolean is24HourMode)
```
    Parameters:
    
    callBack - How the parent is notified that the date is set.
    
    year - The initial year of the dialog.
    
    monthOfYear - The initial month of the dialog.
    
    dayOfMonth - The initial day of the dialog.
  - initialize
```
public void initialize(DatePickerDialog.OnDateSetListener callBack,
                       int year,
                       int monthOfYear,
                       int dayOfMonth,
                       int hourOfDay,
                       int minute,
                       int second,
                       boolean is24HourMode)
```
  - onCreate
```
public void onCreate(android.os.Bundle savedInstanceState)
```
    Overrides:
    
    onCreate in class android.app.DialogFragment
  - onSaveInstanceState
```
public void onSaveInstanceState(android.os.Bundle outState)
```
    Overrides:
    
    onSaveInstanceState in class android.app.DialogFragment
  - onCreateView
```
public android.view.View onCreateView(android.view.LayoutInflater inflater,
                                      android.view.ViewGroup container,
                                      android.os.Bundle savedInstanceState)
```
    Overrides:
    
    onCreateView in class android.app.Fragment
  - onConfigurationChanged
```
public void onConfigurationChanged(android.content.res.Configuration newConfig)
```
    Specified by:
    
    onConfigurationChanged in interface android.content.ComponentCallbacks
    
    Overrides:
    
    onConfigurationChanged in class android.app.Fragment
  - onCreateDialog
```
public android.app.Dialog onCreateDialog(android.os.Bundle savedInstanceState)
```
    Overrides:
    
    onCreateDialog in class android.app.DialogFragment
  - onResume
```
public void onResume()
```
    Overrides:
    
    onResume in class android.app.Fragment
  - onPause
```
public void onPause()
```
    Overrides:
    
    onPause in class android.app.Fragment
  - onCancel
```
public void onCancel(android.content.DialogInterface dialog)
```
    Specified by:
    
    onCancel in interface android.content.DialogInterface.OnCancelListener
    
    Overrides:
    
    onCancel in class android.app.DialogFragment
  - onDismiss
```
public void onDismiss(android.content.DialogInterface dialog)
```
    Specified by:
    
    onDismiss in interface android.content.DialogInterface.OnDismissListener
    
    Overrides:
    
    onDismiss in class android.app.DialogFragment
  - vibrate
```
public void vibrate(boolean vibrate)
```
    Set whether the device should vibrate when touching fields
    
    Parameters:
    
    vibrate - true if the device should vibrate when touching a field
  - dismissOnPause
```
public void dismissOnPause(boolean dismissOnPause)
```
    Set whether the picker should dismiss itself when being paused or whether it should try to survive an orientation change
    
    Parameters:
    
    dismissOnPause - true if the dialog should dismiss itself when it's pausing
  - autoDismiss
```
public void autoDismiss(boolean autoDismiss)
```
    Set whether the picker should dismiss itself when a day is selected
    
    Parameters:
    
    autoDismiss - true if the dialog should dismiss itself when a day is selected
  - setThemeDark
```
public void setThemeDark(boolean themeDark)
```
    Set whether the dark theme should be used
    
    Parameters:
    
    themeDark - true if the dark theme should be used, false if the default theme should be used
  - isThemeDark
```
public boolean isThemeDark()
```
    Returns true when the dark theme should be used
    
    Specified by:
    
    isThemeDark in interface DatePickerController
    
    Returns:
    
    true if the dark theme should be used, false if the default theme should be used
  - setAccentColor
```
public void setAccentColor(java.lang.String color)
```
    Set the accent color of this dialog
    
    Parameters:
    
    color - the accent color you want
  - setAccentColor
```
public void setAccentColor(int color)
```
    Set the accent color of this dialog
    
    Parameters:
    
    color - the accent color you want
  - getAccentColor
```
public int getAccentColor()
```
    Get the accent color of this dialog
    
    Specified by:
    
    getAccentColor in interface DatePickerController
    
    Returns:
    
    accent color
  - showYearPickerFirst
```
public void showYearPickerFirst(boolean yearPicker)
```
    Set whether the year picker of the month and day picker is shown first
    
    Parameters:
    
    yearPicker - boolean
  - showMonthPickerFirst
```
public void showMonthPickerFirst(boolean monthPicker)
```
  - dateOnly
```
public void dateOnly(boolean dateonly)
```
  - setFirstDayOfWeek
```
public void setFirstDayOfWeek(int startOfWeek)
```
  - setYearRange
```
public void setYearRange(int startYear,
                         int endYear)
```
  - setMinDate
```
public void setMinDate(java.util.Calendar calendar)
```
    Sets the minimal date supported by this DatePicker. Dates before (but not including) the specified date will be disallowed from being selected.
    
    Parameters:
    
    calendar - a Calendar object set to the year, month, day desired as the mindate.
  - getMinDate
```
public java.util.Calendar getMinDate()
```
    Returns:
    
    The minimal date supported by this DatePicker. Null if it has not been set.
  - setMaxDate
```
public void setMaxDate(java.util.Calendar calendar)
```
    Sets the minimal date supported by this DatePicker. Dates after (but not including) the specified date will be disallowed from being selected.
    
    Parameters:
    
    calendar - a Calendar object set to the year, month, day desired as the maxdate.
  - getMaxDate
```
public java.util.Calendar getMaxDate()
```
    Returns:
    
    The maximal date supported by this DatePicker. Null if it has not been set.
  - setHighlightedDays
```
public void setHighlightedDays(java.util.Calendar[] highlightedDays)
```
    Sets an array of dates which should be highlighted when the picker is drawn
    
    Parameters:
    
    highlightedDays - an Array of Calendar objects containing the dates to be highlighted
  - getHighlightedDays
```
public java.util.Calendar[] getHighlightedDays()
```
    Specified by:
    
    getHighlightedDays in interface DatePickerController
    
    Returns:
    
    The list of dates, as Calendar Objects, which should be highlighted. null is no dates should be highlighted
  - setSelectableDays
```
public void setSelectableDays(java.util.Calendar[] selectableDays)
```
    Sets a list of days which are the only valid selections. Setting this value will take precedence over using setMinDate() and setMaxDate()
    
    Parameters:
    
    selectableDays - an Array of Calendar Objects containing the selectable dates
  - getSelectableDays
```
public java.util.Calendar[] getSelectableDays()
```
    Returns:
    
    an Array of Calendar objects containing the list with selectable items. null if no restriction is set
  - setDisabledDays
```
public void setDisabledDays(java.util.Calendar[] disabledDays)
```
    Sets a list of days that are not selectable in the picker Setting this value will take precedence over using setMinDate() and setMaxDate(), but stacks with setSelectableDays()
    
    Parameters:
    
    disabledDays - an Array of Calendar Objects containing the disabled dates
  - getDisabledDays
```
public java.util.Calendar[] getDisabledDays()
```
    Returns:
    
    an Array of Calendar objects containing the list of days that are not selectable. null if no restriction is set
  - setTitle
```
public void setTitle(java.lang.String title)
```
    Set a title to be displayed instead of the weekday
    
    Parameters:
    
    title - String - The title to be displayed
  - setOkText
```
public void setOkText(java.lang.String okString)
```
    Set the label for the Ok button (max 12 characters)
    
    Parameters:
    
    okString - A literal String to be used as the Ok button label
  - setOkText
```
public void setOkText(int okResid)
```
    Set the label for the Ok button (max 12 characters)
    
    Parameters:
    
    okResid - A resource ID to be used as the Ok button label
  - setCancelText
```
public void setCancelText(java.lang.String cancelString)
```
    Set the label for the Cancel button (max 12 characters)
    
    Parameters:
    
    cancelString - A literal String to be used as the Cancel button label
  - setCancelText
```
public void setCancelText(int cancelResid)
```
    Set the label for the Cancel button (max 12 characters)
    
    Parameters:
    
    cancelResid - A resource ID to be used as the Cancel button label
  - setOnDateSetListener
```
public void setOnDateSetListener(DatePickerDialog.OnDateSetListener listener)
```
  - setOnCancelListener
```
public void setOnCancelListener(android.content.DialogInterface.OnCancelListener onCancelListener)
```
  - setOnDismissListener
```
public void setOnDismissListener(android.content.DialogInterface.OnDismissListener onDismissListener)
```
  - onClick
```
public void onClick(android.view.View v)
```
    Specified by:
    
    onClick in interface android.view.View.OnClickListener
  - onYearSelected
```
public void onYearSelected(int year)
```
    Specified by:
    
    onYearSelected in interface DatePickerController
  - onTimeSelected
```
public void onTimeSelected(int value,
                           java.lang.String type)
```
    Specified by:
    
    onTimeSelected in interface DatePickerController
  - onMonthSelected
```
public void onMonthSelected(int month)
```
    Specified by:
    
    onMonthSelected in interface DatePickerController
  - onDayOfMonthSelected
```
public void onDayOfMonthSelected(int year,
                                 int month,
                                 int day)
```
    Specified by:
    
    onDayOfMonthSelected in interface DatePickerController
  - getSelectedDay
```
public MonthAdapter.CalendarDay getSelectedDay()
```
    Specified by:
    
    getSelectedDay in interface DatePickerController
  - getStartDate
```
public java.util.Calendar getStartDate()
```
    Specified by:
    
    getStartDate in interface DatePickerController
  - getEndDate
```
public java.util.Calendar getEndDate()
```
    Specified by:
    
    getEndDate in interface DatePickerController
  - getMinYear
```
public int getMinYear()
```
    Specified by:
    
    getMinYear in interface DatePickerController
  - getMaxYear
```
public int getMaxYear()
```
    Specified by:
    
    getMaxYear in interface DatePickerController
  - getMinMonth
```
public int getMinMonth()
```
    Specified by:
    
    getMinMonth in interface DatePickerController
  - getMaxMonth
```
public int getMaxMonth()
```
    Specified by:
    
    getMaxMonth in interface DatePickerController
  - isOutOfRange
```
public boolean isOutOfRange(int year,
                            int month,
                            int day)
```
    Specified by:
    
    isOutOfRange in interface DatePickerController
    
    Returns:
    
    true if the specified year/month/day are within the selectable days or the range set by minDate and maxDate. If one or either have not been set, they are considered as Integer.MIN_VALUE and Integer.MAX_VALUE.
  - isOutOfRange
```
public boolean isOutOfRange(java.util.Calendar calendar)
```
  - getFirstDayOfWeek
```
public int getFirstDayOfWeek()
```
    Specified by:
    
    getFirstDayOfWeek in interface DatePickerController
  - registerOnDateChangedListener
```
public void registerOnDateChangedListener(DatePickerDialog.OnDateChangedListener listener)
```
    Specified by:
    
    registerOnDateChangedListener in interface DatePickerController
  - unregisterOnDateChangedListener
```
public void unregisterOnDateChangedListener(DatePickerDialog.OnDateChangedListener listener)
```
    Specified by:
    
    unregisterOnDateChangedListener in interface DatePickerController
  - tryVibrate
```
public void tryVibrate()
```
    Specified by:
    
    tryVibrate in interface DatePickerController
  - notifyOnDateListener
```
public void notifyOnDateListener()
```
  - enableSeconds
```
public void enableSeconds(boolean enableSeconds)
```
    Set whether an additional picker for seconds should be shown Will enable minutes picker as well if seconds picker should be shown
    
    Parameters:
    
    enableSeconds - true if the seconds picker should be shown
  - enableMinutes
```
public void enableMinutes(boolean enableMinutes)
```
    Set whether the picker for minutes should be shown Will disable seconds if minutes are disbled
    
    Parameters:
    
    enableMinutes - true if minutes picker should be shown
  - getIsCurrentlyAmOrPm
```
public int getIsCurrentlyAmOrPm()
```
  - setAmOrPm
```
public void setAmOrPm(int amOrPm)
```

Class DatePickerDialog

Nested Class Summary

Nested classes/interfaces inherited from class android.app.Fragment

Field Summary

Fields inherited from class android.app.DialogFragment

Fields inherited from interface android.content.ComponentCallbacks2

Constructor Summary

Method Summary

Methods inherited from class android.app.DialogFragment

Methods inherited from class android.app.Fragment

Methods inherited from class java.lang.Object

Field Detail

HOUR_INDEX

MINUTE_INDEX

SECOND_INDEX

AM

PM

Constructor Detail

DatePickerDialog

Method Detail

newInstance

initialize

onCreate

onSaveInstanceState

onCreateView

onConfigurationChanged

onCreateDialog

onResume

onPause

onCancel

onDismiss

vibrate

dismissOnPause

autoDismiss

setThemeDark

isThemeDark

setAccentColor

setAccentColor

getAccentColor

showYearPickerFirst

showMonthPickerFirst

dateOnly

setFirstDayOfWeek

setYearRange

setMinDate

getMinDate

setMaxDate

getMaxDate

setHighlightedDays

getHighlightedDays

setSelectableDays

getSelectableDays

setDisabledDays

getDisabledDays

setTitle

setOkText

setOkText

setCancelText

setCancelText

setOnDateSetListener

setOnCancelListener

setOnDismissListener

onClick

onYearSelected

onTimeSelected

onMonthSelected

onDayOfMonthSelected

getSelectedDay

getStartDate

getEndDate

getMinYear

getMaxYear

getMinMonth

getMaxMonth

isOutOfRange

isOutOfRange

getFirstDayOfWeek

registerOnDateChangedListener

unregisterOnDateChangedListener

tryVibrate