DurationSpan

public final class DurationSpan
extends CarSpan

java.lang.Object
   ↳ android.text.style.CharacterStyle
     ↳ androidx.car.app.model.CarSpan
       ↳ androidx.car.app.model.DurationSpan


A span that replaces the text it is attached to with a localized duration string.

For example, the following code creates a string that shows the duration as the first text in the string before the interpunct:

String interpunct = "\\u00b7";
 SpannableString string = new SpannableString("  " + interpunct + " Point-of-Interest 1");
 string.setSpan(DurationSpan.create(300), 0, 1, SPAN_INCLUSIVE_INCLUSIVE);
 

The span flags (e.g. SPAN_EXCLUSIVE_EXCLUSIVE) will be ignored.

This span will be ignored if it overlaps with any span that replaces text, such as another DistanceSpan, DurationSpan, or CarIconSpan. However, it is possible to * apply styling to the text, such as changing colors:

String interpunct = "\\u00b7";
 SpannableString string = new SpannableString("  " + interpunct + " Point-of-Interest 1");
 string.setSpan(DurationSpan.create(300), 0, 1, SPAN_INCLUSIVE_INCLUSIVE);
 string.setSpan(ForegroundCarColorSpan.create(CarColor.BLUE), 0, 1, SPAN_EXCLUSIVE_EXCLUSIVE);
 

Summary

Public methods

static DurationSpan create(Duration duration)

Creates a DurationSpan with the given duration.

static DurationSpan create(long durationSeconds)

Creates a DurationSpan with the given duration.

boolean equals(Object other)
long getDurationSeconds()

Returns the time duration associated with this span, in seconds.

int hashCode()
String toString()

Inherited methods

Public methods

create

public static DurationSpan create (Duration duration)

Creates a DurationSpan with the given duration.

Parameters
duration Duration

Returns
DurationSpan

create

public static DurationSpan create (long durationSeconds)

Creates a DurationSpan with the given duration.

Parameters
durationSeconds long

Returns
DurationSpan

equals

public boolean equals (Object other)

Parameters
other Object

Returns
boolean

getDurationSeconds

public long getDurationSeconds ()

Returns the time duration associated with this span, in seconds.

Returns
long

hashCode

public int hashCode ()

Returns
int

toString

public String toString ()

Returns
String