lightbulb_outline Please take our October 2018 developer survey. Start survey

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 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 was used, measured in milliseconds since the epoch.

String getPackageName()
long getTotalTimeInForeground()

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

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Fields

CREATOR

added in API level 21
public static final Creator<UsageStats> CREATOR

Public constructors

UsageStats

added in API level 21
public UsageStats (UsageStats stats)

Parameters
stats UsageStats

Public methods

add

added in API level 21
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

added in API level 21
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(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.

getFirstTimeStamp

added in API level 21
public long getFirstTimeStamp ()

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

See System.currentTimeMillis().

Returns
long

getLastTimeStamp

added in API level 21
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

added in API level 21
public long getLastTimeUsed ()

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

See System.currentTimeMillis().

Returns
long

getPackageName

added in API level 21
public String getPackageName ()

Returns
String

getTotalTimeInForeground

added in API level 21
public long getTotalTimeInForeground ()

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

Returns
long

writeToParcel

added in API level 21
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.