# CountDownTimer

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Ctors](https://developer.android.com/reference/android/os/CountDownTimer#pubctors)\|[Methods](https://developer.android.com/reference/android/os/CountDownTimer#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/os/CountDownTimer#inhmethods)  

# CountDownTimer

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/os/CountDownTimer "View this page in Kotlin")\|Java

`
public


abstract
class
CountDownTimer
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|---------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.os.CountDownTimer |

<br />

*** ** * ** ***

Schedule a countdown until a time in the future, with regular notifications on intervals along the way. Example of showing a 30 second countdown in a text field:  

### Kotlin

```kotlin
 object : CountDownTimer(30000, 1000) {

     override fun onTick(millisUntilFinished: Long) {
         mTextField.setText("seconds remaining: " + millisUntilFinished / 1000)
     }

     override fun onFinish() {
         mTextField.setText("done!")
     }
 }.start()
 
```

### Java

```java
 new CountDownTimer(30000, 1000) {

     public void onTick(long millisUntilFinished) {
         mTextField.setText("seconds remaining: " + millisUntilFinished / 1000);
     }

     public void onFinish() {
         mTextField.setText("done!");
     }
 }.start();
 
```
The calls to[onTick(long)](https://developer.android.com/reference/android/os/CountDownTimer#onTick(long))are synchronized to this object so that one call to[onTick(long)](https://developer.android.com/reference/android/os/CountDownTimer#onTick(long))won't ever occur before the previous callback is complete. This is only relevant when the implementation of[onTick(long)](https://developer.android.com/reference/android/os/CountDownTimer#onTick(long))takes an amount of time to execute that is significant compared to the countdown interval.

<br />

## Summary

|                                                                        ### Public constructors                                                                         ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[CountDownTimer](https://developer.android.com/reference/android/os/CountDownTimer#CountDownTimer(long,%20long))`(long millisInFuture, long countDownInterval) ` |

|                                                                                                                     ### Public methods                                                                                                                     ||
|----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` final void`                                                                                | ` `[cancel](https://developer.android.com/reference/android/os/CountDownTimer#cancel())`() ` Cancel the countdown.                                           |
| ` abstract void`                                                                             | ` `[onFinish](https://developer.android.com/reference/android/os/CountDownTimer#onFinish())`() ` Callback fired when the time is up.                         |
| ` abstract void`                                                                             | ` `[onTick](https://developer.android.com/reference/android/os/CountDownTimer#onTick(long))`(long millisUntilFinished) ` Callback fired on regular interval. |
| ` final `[CountDownTimer](https://developer.android.com/reference/android/os/CountDownTimer) | ` `[start](https://developer.android.com/reference/android/os/CountDownTimer#start())`() ` Start the countdown.                                              |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed.                   | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public constructors

### CountDownTimer

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public CountDownTimer (long millisInFuture, 
                long countDownInterval)
```

<br />

<br />

|                                                                                                                                                   Parameters                                                                                                                                                   ||
|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `millisInFuture`    | `long`: The number of millis in the future from the call to[start()](https://developer.android.com/reference/android/os/CountDownTimer#start())until the countdown is done and[onFinish()](https://developer.android.com/reference/android/os/CountDownTimer#onFinish())is called. <br /> |
| `countDownInterval` | `long`: The interval along the way to receive[onTick(long)](https://developer.android.com/reference/android/os/CountDownTimer#onTick(long))callbacks. <br />                                                                                                                              |

## Public methods

### cancel

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public final void cancel ()
```

Cancel the countdown.

<br />

### onFinish

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public abstract void onFinish ()
```

Callback fired when the time is up.

<br />

### onTick

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public abstract void onTick (long millisUntilFinished)
```

Callback fired on regular interval.

<br />

|                                Parameters                                ||
|-----------------------|---------------------------------------------------|
| `millisUntilFinished` | `long`: The amount of time until finished. <br /> |

### start

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public final CountDownTimer start ()
```

Start the countdown.

<br />

|                                           Returns                                           ||
|-------------------------------------------------------------------------------------|--------|
| [CountDownTimer](https://developer.android.com/reference/android/os/CountDownTimer) | <br /> |