/Android-Countdown-Timer

Android library provide a simple to use Countdown Timer View.

Primary LanguageJava

Downloads Downloads

Android-Countdown-Timer

Android library provide a simple to use Countdown Timer View.

Android Countdown timer

Prerequisites

Android 5.0+ API 21+

Features

  • Customizable fonts (color, size, fonts resources).
  • Choose maximum time unit to show.
  • Built in fonts to choose, app:counter_font="DIGITAL|DIGITAL_BOLD|DIGITAL_ITALIC|DIGITAL_ITALIC_BOLD|REGULAR"

Usage

Java

        mCounter = findViewById(R.id.counter);
	Date date = format.parse("2019-07-22T18:33:00");
        mCounter.setDate(date);//countdown starts
	//or use: 
	mCounter.setDate("2019-07-19T18:33:00"); //countdown starts
	
	/*
         * Additional attributes:
         * */
        mCounter.setIsShowingTextDesc(true);
        mCounter.setTextColor(R.color.colorPrimary);
        mCounter.setMaxTimeUnit(TimeUnits.DAY);
        mCounter.setTextSize(30);
	mCounter.setTypeFace(ResourcesCompat.getFont(this, R.font.batmfa__));
	
	mCounter.setListener(new Counter.Listener() {
            @Override
            public void onTick(long millisUntilFinished) {
                Log.d(TAG, "onTick: Counter - " + millisUntilFinished);
            }

            @Override
            public void onTick(long days, long hours, long minutes, long seconds) {
                Log.d(TAG, "onTick: Counter - " + days + "d " +
                        hours + "h " +
                        minutes + "m " +
                        seconds + "s " );
            }
        });

XML

    <com.tsuryo.androidcountdown.Counter
        android:id="@+id/counter"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
	
	<!--Additional attributes-->
        app:max_time_unit="HOUR"
        app:text_color="@color/colorPrimary"
        app:text_size="36dp"
        app:custom_font="@font/batmfa__" />

    <com.tsuryo.androidcountdown.Counter
        android:id="@+id/counte1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
	
	<!--Additional attributes-->
        app:max_time_unit="DAY"
        app:text_color="#2196F3"
        app:text_size="36dp"
        app:textual_description="true"
        app:counter_font="DIGITAL_BOLD" />

Installing

Add the JitPack repository to your build file. Add it in your root build.gradle at the end of repositories:

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

Add the dependency

dependencies {
	implementation 'com.github.tsuryo:Android-Countdown-Timer:1.2'
}