Most visited

Recently visited

Added in API level 21

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

From interface android.os.Parcelable

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

From class java.lang.Object
From interface android.os.Parcelable

Fields

CREATOR

Added in API level 21
Creator<UsageStats> CREATOR

Public constructors

UsageStats

Added in API level 21
UsageStats (UsageStats stats)

Parameters
stats UsageStats

Public methods

add

Added in API level 21
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
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
long getFirstTimeStamp ()

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

See currentTimeMillis().

Returns
long

getLastTimeStamp

Added in API level 21
long getLastTimeStamp ()

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

See currentTimeMillis().

Returns
long

getLastTimeUsed

Added in API level 21
long getLastTimeUsed ()

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

See currentTimeMillis().

Returns
long

getPackageName

Added in API level 21
String getPackageName ()

Returns
String

getTotalTimeInForeground

Added in API level 21
long getTotalTimeInForeground ()

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

Returns
long

writeToParcel

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

Hooray!