# Print output for @column tags ?> UsageStats - Android SDK | Android Developers

Most visited

Recently visited

UsageStats

public final class UsageStats
extends Object implements Parcelable

java.lang.Object
   ↳ android.app.usage.UsageStats


Contains usage statistics for an app package for a specific time range.

Summary

Inherited constants

Fields

public static final Creator<UsageStats> CREATOR

Public constructors

UsageStats(UsageStats stats)

Public methods

void add(UsageStats right)

Add the statistics from the right UsageStats to the left.

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

long getFirstTimeStamp()

Get the beginning of the time range this UsageStats represents, measured in milliseconds since the epoch.

long getLastTimeForegroundServiceUsed()

Get the last time this package's foreground service was used, measured in milliseconds since the epoch.

long getLastTimeStamp()

Get the end of the time range this UsageStats represents, measured in milliseconds since the epoch.

long getLastTimeUsed()

Get the last time this package's activity was used, measured in milliseconds since the epoch.

long getLastTimeVisible()

Get the last time this package's activity is visible in the UI, measured in milliseconds since the epoch.

String getPackageName()
long getTotalTimeForegroundServiceUsed()

Get the total time this package's foreground services are started, measured in milliseconds.

long getTotalTimeInForeground()

Get the total time this package spent in the foreground, measured in milliseconds.

long getTotalTimeVisible()

Get the total time this package's activity is visible in the UI, measured in milliseconds.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Fields

CREATOR

public static final Creator<UsageStats> CREATOR

Public constructors

UsageStats

public UsageStats (UsageStats stats)

Parameters
stats UsageStats

Public methods

add

public void add (UsageStats right)

Add the statistics from the right UsageStats to the left. The package name for both UsageStats objects must be the same.

Parameters
right UsageStats: The UsageStats object to merge into this one.

Throws
IllegalArgumentException if the package names of the two UsageStats objects are different.

describeContents

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

getFirstTimeStamp

public long getFirstTimeStamp ()

Get the beginning of the time range this UsageStats represents, measured in milliseconds since the epoch.

See System#currentTimeMillis().

Returns
long

getLastTimeForegroundServiceUsed

public long getLastTimeForegroundServiceUsed ()

Get the last time this package's foreground service was used, measured in milliseconds since the epoch.

See System#currentTimeMillis().

Returns
long

getLastTimeStamp

public long getLastTimeStamp ()

Get the end of the time range this UsageStats represents, measured in milliseconds since the epoch.

See System#currentTimeMillis().

Returns
long

getLastTimeUsed

public long getLastTimeUsed ()

Get the last time this package's activity was used, measured in milliseconds since the epoch.

See System#currentTimeMillis().

Returns
long

getLastTimeVisible

public long getLastTimeVisible ()

Get the last time this package's activity is visible in the UI, measured in milliseconds since the epoch.

Returns
long

getPackageName

public String getPackageName ()

Returns
String

getTotalTimeForegroundServiceUsed

public long getTotalTimeForegroundServiceUsed ()

Get the total time this package's foreground services are started, measured in milliseconds.

Returns
long

getTotalTimeInForeground

public long getTotalTimeInForeground ()

Get the total time this package spent in the foreground, measured in milliseconds.

Returns
long

getTotalTimeVisible

public long getTotalTimeVisible ()

Get the total time this package's activity is visible in the UI, measured in milliseconds.

Returns
long

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: The Parcel in which the object should be written.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES