Time Picker – Multipurpose Responsive Time Picker

Introduction to the Time Picker - Multipurpose Responsive Time Picker

Are you building a website or a mobile app that requires users to input their availability or schedules? Do you want to simplify the process and provide an intuitive way for your users to select their desired times? Look no further than the Time Picker - Multipurpose Responsive Time Picker. This highly customizable and user-friendly plugin allows your users to effortlessly select their desired time by simply clicking and dragging their mouse or finger over a calendar-like interface.

Getting Started with the Time Picker - Multipurpose Responsive Time Picker Tutorial

Step 1: Include the Time Picker JavaScript and CSS Files

To start using the Time Picker - Multipurpose Responsive Time Picker, you'll need to include the necessary JavaScript and CSS files in your project. You can do this by linking to the Time Picker CDN or by uploading the files to your server and referencing them locally.

For CDN:

<script src="https://cdnjs.cloudflare.com/ajax/libs/timPicker/2.0.5/timPicker.min.js"></script>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/timPicker/2.0.5/timPicker.min.css" />

For Local:

<script src="path/to/timPicker.js"></script>
<link rel="stylesheet" href="path/to/timPicker.css" />

Step 2: Initialize the Time Picker

Once the JavaScript and CSS files are included, you need to initialize the Time Picker using JavaScript. This will render the Time Picker UI component on your webpage. Here's an example of how to initialize the Time Picker:

setTimeout(function() {
    window.timPickerOptions = {
        container: 'container-id', // or DOM element
        layout: 'horizontal', // 'horizontal' or 'vertical'
        clock12hour: true,
        range: true, // Select a range of dates and times
        language: 'en'
    };

    window.timPicker();
}, 1);

In the example above, we set up an object called window.timPickerOptions and passed it to the window.timPicker() function to initialize the Time Picker.

Step 3: Configure the Time Picker

The Time Picker is highly customizable, so let's explore some common options:

• layout: 'horizontal' (default) or 'vertical', allowing you to control the direction of the time display.
• clock12hour: Set to true to use the 12-hour clock or false to use the 24-hour clock.
• range: Enable or disable the ability to select a range of dates and times by setting true or false.
• language: Set the language for the Time Picker using an IETF language tag (e.g., 'en', 'fr', 'de').

Step 4: Use the Time Picker

Now that you have initialized and configured the Time Picker, it's time to use it in your application. Here are some common use cases:

1. Get Selected Date and Time:

In your JavaScript code, access the selected date and time using the following properties:

// Assuming you have the 'select' event bound
$timPicker.on('select', function(selected, isValid) {
  const datetime = selected.getDatetime(); // Get selected datetime (Date and Time)
});

1. Disable/Enable the Time Picker:

// Enable or disable the Time Picker using `enable()` method:
const timPickerInstance = $timPicker.timPicker();

if (yourCondition) {
  timPickerInstance.enable();
} else {
  timPickerInstance.disable();
}

1. Get and Set Current Selected Date and Time:

// Assuming you have the 'change' event bound
$timPicker.on('change', function(selected, isValid) {
  // Access selected datetime (Date and Time)
  const selectedTime = selected.getDatetime(); // Get the newly selected datetime
  $timeInput.val(selectedTime.getTime()); // Use as necessary
});

In the last two use cases above, we interacted with the Time Picker instances via JavaScript. Always check documentation for the event-based examples and the proper functions as per your development preferences.