ChatiumFor developersPlaygroundPricing
Sign in

Calendar

Properties

  • value (Date | string | null):
    The date value that can be passed as a Date object or a string. If it's a string, it will be converted to a Date object. If null, the calendar displays the current date.
  • interval (null | {start: Date | null, end: Date | null}):
    The range of dates that can be highlighted in the calendar. The start and end fields indicate the beginning and end of the interval, respectively.
  • withTime (boolean):
    If true, the calendar will include a time input field (hours and minutes).
  • timePlaceholder (string):
    Placeholder text for the time input field, e.g., '00:00'. Used if the withTime option is enabled.
  • onInput *(function(date: Date)):
    A handler that is called when a date is selected. It passes a Date object with the selected date.

Events

  • prevHandler:
    Click handler for the "Previous Month" button. Decreases the current month by one.
  • nextHandler:
    Click handler for the "Next Month" button. Increases the current month by one.
  • monthHandler (InputEvent):
    Handler for changing the month via a dropdown list. Updates the displayed month in the calendar.
  • yearHandler (InputEvent):
    Handler for changing the year via a dropdown list. Updates the displayed year in the calendar.
  • selectHandler (Date):
    Handler for selecting a specific day in the calendar. Updates the selected date considering the current time and interval.
  • timeBlurHandler:
    Handler that is called when the time field loses focus. Converts the entered time into hours and minutes and updates the selected date.
  • timeFocusHandler:
    Handler for focusing on the time field. Automatically selects all content in the field when focused.
  • timeKeyDownHandler:
    Handler for key events in the time field.

Internal Functions

  • parseTime(time: string):
    Converts a time string (e.g., '1300' or '13:00') into an object with hours and minutes fields. Returns null if the entered time is invalid.
  • select(date: Date):
    Calls the provided onInput handler with the updated date.