Range-Time-Picker-Dialog

Simple Android Library that provide you a custom dialog that allow you to set a start time and end time.

Screenshot
:-------------------------


Install

Add this to your project build.gradle

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
Gradle

Add this to your module build.gradle

   dependencies {
        compile 'com.github.PuffoCyano:Range-Time-Picker-Dialog:v1.4'
    }
Gradle

Usage

In your activity (Default method "newInstance()"):

    // Create an instance of the dialog fragment and show it
    RangeTimePickerDialog dialog = new RangeTimePickerDialog();
    dialog.newInstance();
    dialog.setRadiusDialog(20); // Set radius of dialog (default is 50)
    dialog.setIs24HourView(true); // Indicates if the format should be 24 hours
    dialog.setColorBackgroundHeader(R.color.colorPrimary); // Set Color of Background header dialog
    dialog.setColorTextButton(R.color.colorPrimaryDark); // Set Text color of button
    FragmentManager fragmentManager = getFragmentManager();
    dialog.show(fragmentManager, "");
Java

You can instantiate the dialog with more parameters:

     // Create an instance of the dialog fragment and show it
     RangeTimePickerDialog dialog = new RangeTimePickerDialog();
     dialog.newInstance(R.color.CyanWater, R.color.White, R.color.Yellow, R.color.colorPrimary, true);
     FragmentManager fragmentManager = getFragmentManager();
     dialog.show(fragmentManager, "");
Java

To read parameter from Dialog your activity have to implements the interface ISelectedTime:

public class MainActivity extends AppCompatActivity implements RangeTimePickerDialog.ISelectedTime
Java

Then you have to override the method "onSelectedTime":

@Override
public void onSelectedTime(int hourStart, int minuteStart, int hourEnd, int minuteEnd)
{
  // Use parameters provided by Dialog
  Toast.makeText(this, "Start: "+hourStart+":"+minuteStart+"\nEnd: "+hourEnd+":"+minuteEnd, Toast.LENGTH_SHORT).show();
}
Java

In your fragment:

   // Create an instance of the dialog fragment and show it
   RangeTimePickerDialog dialog = new RangeTimePickerDialog();
   dialog.newInstance(R.color.CyanWater, R.color.White, R.color.Yellow, R.color.colorPrimary, true);
   FragmentManager fragmentManager = getFragmentManager();
   dialog.setTargetFragment(this, MY_FRAGMENT_ID); // MY_FRAGMENT_ID is a personal identifier that allow you to get parameter from dialog into onActivityResult
   dialog.show(fragmentManager, "");
Java

When you have to read parameter provided by Dialog you have to override onResultActivity in your fragment:

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data)
{
   super.onActivityResult(requestCode, resultCode, data);
   if (requestCode == MY_FRAGMENT_ID)
   {
      if (resultCode == Activity.RESULT_OK)
      {
         if (data.getExtras().containsKey(RangeTimePickerDialog.HOUR_START))
         {
            int hourStart = data.getExtras().getInt(RangeTimePickerDialog.HOUR_START);
            int hourEnd = data.getExtras().getInt(RangeTimePickerDialog.HOUR_END);
            int minuteStart = data.getExtras().getInt(RangeTimePickerDialog.MINUTE_START);
            int minuteEnd = data.getExtras().getInt(RangeTimePickerDialog.MINUTE_END);
            // Use the returned value
            Toast.makeText(getActivity(), "Time start:"+hourStart+":"+minuteStart+"\nUntil: "+hourEnd+":"+minuteEnd, Toast.LENGTH_SHORT).show();
         }
      }
   }
}
Java

Methods

  • setColorTabUnselected(int colorTabUnselected): Set color of tab item when it is unselected
  • setColorTabSelected(int colorTabSelected): Set color of tab item when it is selected
  • setColorTextButton(int colorTextButton): Set button text color
  • setColorBackgroundHeader(int colorBackgroundHeader): Set background color of header dialog
  • setIs24HourView(boolean is24HourView): Set true if you want see time into 24 hour format
  • setMessageErrorRangeTime(String messageErrorRangeTime): Set message error that appears when you select a end time greater than start time (only if "validateRange" is true)
  • setTextBtnPositive(String textBtnPositive): Set positive button text
  • setTextBtnNegative(String textBtnNegative): Set negative button text
  • setRadiusDialog(int radiusDialog): Set dialog radius (default is 50)
  • setTextTabStart(String textTabStart): Set tab start text
  • setTextTabEnd(String textTabEnd): Set tab end text
  • setValidateRange(boolean validateRange):Set true if you want validate the range time (start time < end time). Set false if you want select any time
  • setColorBackgroundTimePickerHeader(int colorBackgroundTimePickerHeader): Set background color of header timePicker

GitHub