Learn R Programming

shiny (version 0.10.1)

dateRangeInput: Create date range input

Description

Creates a pair of text inputs which, when clicked on, bring up calendars that the user can click on to select dates.

Usage

dateRangeInput(inputId, label, start = NULL, end = NULL, min = NULL,
  max = NULL, format = "yyyy-mm-dd", startview = "month", weekstart = 0,
  language = "en", separator = " to ")

Arguments

start
The initial start date. Either a Date object, or a string in yyyy-mm-dd format. If NULL (the default), will use the current date in the client's time zone.
end
The initial end date. Either a Date object, or a string in yyyy-mm-dd format. If NULL (the default), will use the current date in the client's time zone.
separator
String to display between the start and end input boxes.
inputId
Input variable to assign the control's value to.
label
Display label for the control, or NULL.
min
The minimum allowed date. Either a Date object, or a string in yyyy-mm-dd format.
max
The maximum allowed date. Either a Date object, or a string in yyyy-mm-dd format.
format
The format of the date to display in the browser. Defaults to "yyyy-mm-dd".
startview
The date range shown when the input object is first clicked. Can be "month" (the default), "year", or "decade".
weekstart
Which day is the start of the week. Should be an integer from 0 (Sunday) to 6 (Saturday).
language
The language used for month and day names. Default is "en". Other valid values include "bg", "ca", "cs", "da", "de", "el", "es", "fi", "fr", "he", "hr", "hu", "id", "is", "it", "ja", "kr", "lt", "lv", "ms", "nb", "nl", "pl", "pt", "pt-BR", "ro", "rs

Details

The date format string specifies how the date will be displayed in the browser. It allows the following values:

  • yyYear without century (12)
  • yyyyYear with century (2012)
  • mmMonth number, with leading zero (01-12)
  • mMonth number, without leading zero (01-12)
  • MAbbreviated month name
  • MMFull month name
  • ddDay of month with leading zero
  • dDay of month without leading zero
  • DAbbreviated weekday name
  • DDFull weekday name

See Also

dateInput, updateDateRangeInput

Other input.elements: actionButton, actionLink; animationOptions, sliderInput; checkboxGroupInput; checkboxInput; dateInput; fileInput; numericInput; radioButtons; selectInput, selectizeInput; submitButton; textInput

Examples

Run this code
dateRangeInput("daterange", "Date range:",
               start = "2001-01-01",
               end   = "2010-12-31")

# Default start and end is the current date in the client's time zone
dateRangeInput("daterange", "Date range:")

# start and end are always specified in yyyy-mm-dd, even if the display
# format is different
dateRangeInput("daterange", "Date range:",
               start  = "2001-01-01",
               end    = "2010-12-31",
               min    = "2001-01-01",
               max    = "2012-12-21",
               format = "mm/dd/yy",
               separator = "- ")

# Pass in Date objects
dateRangeInput("daterange", "Date range:",
               start = Sys.Date()-10,
               end = Sys.Date()+10)

# Use different language and different first day of week
dateRangeInput("daterange", "Date range:",
               language = "de",
               weekstart = 1)

# Start with decade view instead of default month view
dateRangeInput("daterange", "Date range:",
               startview = "decade")

Run the code above in your browser using DataLab