# TimeDependentText

Artifact: [androidx.wear:wear-ongoing](https://developer.android.com/jetpack/androidx/releases/wear) [View Source](https://cs.android.com/search?q=file:androidx/wear/ongoing/TimeDependentText.java+class:androidx.wear.ongoing.TimeDependentText) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear#1.0.0)

*** ** * ** ***


```
public interface TimeDependentText
```

<br />

Known direct subclasses [Status.Part](https://developer.android.com/reference/androidx/wear/ongoing/Status.Part), [Status](https://developer.android.com/reference/androidx/wear/ongoing/Status)

|---|---|
| `https://developer.android.com/reference/androidx/wear/ongoing/Status.Part` | Abstract class to represent An Ongoing activity status or part of it. |
| `https://developer.android.com/reference/androidx/wear/ongoing/Status` | Base class to represent the status of an Ongoing Activity and render it. |

Known indirect subclasses [Status.StopwatchPart](https://developer.android.com/reference/androidx/wear/ongoing/Status.StopwatchPart), [Status.TextPart](https://developer.android.com/reference/androidx/wear/ongoing/Status.TextPart), [Status.TimerOrStopwatchPart](https://developer.android.com/reference/androidx/wear/ongoing/Status.TimerOrStopwatchPart), [Status.TimerPart](https://developer.android.com/reference/androidx/wear/ongoing/Status.TimerPart)

|---|---|
| `https://developer.android.com/reference/androidx/wear/ongoing/Status.StopwatchPart` | An Ongoing activity status (or part of it) representing a stopwatch |
| `https://developer.android.com/reference/androidx/wear/ongoing/Status.TextPart` | An Ongoing activity status (or part of it) representing a plain, static text. |
| `https://developer.android.com/reference/androidx/wear/ongoing/Status.TimerOrStopwatchPart` | Base class for `https://developer.android.com/reference/androidx/wear/ongoing/Status.TimerPart` and `https://developer.android.com/reference/androidx/wear/ongoing/Status.StopwatchPart`, defines the getters but can't be created directly, create one of those instead. |
| `https://developer.android.com/reference/androidx/wear/ongoing/Status.TimerPart` | An Ongoing activity status (or part of it) representing a timer. |

*** ** * ** ***

Represents the status or a part of the status of an ongoing activity. Its content may change with time (for example, if the status contains a timer)

## Summary

| ### Public methods |
|---|---|
| `abstract long` | `https://developer.android.com/reference/androidx/wear/ongoing/TimeDependentText#getNextChangeTimeMillis(long)(long fromTimeMillis)` Returns the timestamp of the next time when the display may be different from the one at the specified time. |
| `abstract @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/CharSequence.html` | `https://developer.android.com/reference/androidx/wear/ongoing/TimeDependentText#getText(android.content.Context,long)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context, long timeNowMillis)` Returns a textual representation of the ongoing activity status or a part of it at the given time represented as milliseconds timestamp For forward compatibility, the best way to display this is on a `https://developer.android.com/reference/android/widget/TextView.html` |

## Public methods

### getNextChangeTimeMillis

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear#1.0.0)

```
abstract long getNextChangeTimeMillis(long fromTimeMillis)
```

Returns the timestamp of the next time when the display may be different from the one at the specified time.

| Parameters |
|---|---|
| `long fromTimeMillis` | current time, usually now as returned by `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()`. In most cases `getText` and `getNextChangeTimeMillis` should be called with the exact same timestamp, so changes are not missed. |

| Returns |
|---|---|
| `long` | the first point in time after `fromTimeMillis` when the displayed value of this status may change. returns Long.MAX_VALUE if the display will never change. |

### getText

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear#1.0.0)

```
abstract @NonNull CharSequence getText(@NonNull Context context, long timeNowMillis)
```

Returns a textual representation of the ongoing activity status or a part of it at the given time represented as milliseconds timestamp For forward compatibility, the best way to display this is on a `https://developer.android.com/reference/android/widget/TextView.html`

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context` | may be used for internationalization. Only used while this method executed. |
| `long timeNowMillis` | the timestamp of the time we want to display, usually now, as returned by `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()`. |