Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Nested Classes](https://developer.android.com/reference/android/app/usage/UsageEventsQuery#nestedclasses) \| [Inherited Constants](https://developer.android.com/reference/android/app/usage/UsageEventsQuery#inhconstants) \| [Fields](https://developer.android.com/reference/android/app/usage/UsageEventsQuery#lfields) \| [Methods](https://developer.android.com/reference/android/app/usage/UsageEventsQuery#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/app/usage/UsageEventsQuery#inhmethods)

# UsageEventsQuery

*** ** * ** ***

` public final class UsageEventsQuery `   
` extends https://developer.android.com/reference/java/lang/Object ` ` implements https://developer.android.com/reference/android/os/Parcelable `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.app.usage.UsageEventsQuery |

<br />

*** ** * ** ***

An Object-Oriented representation for a `https://developer.android.com/reference/android/app/usage/UsageEvents` query. Used by `https://developer.android.com/reference/android/app/usage/UsageStatsManager#queryEvents(android.app.usage.UsageEventsQuery)` call.

## Summary

| ### Nested classes ||
|---|---|
| ` class` | `https://developer.android.com/reference/android/app/usage/UsageEventsQuery.Builder` Builder for UsageEventsQuery. |

### Inherited constants

From interface `https://developer.android.com/reference/android/os/Parcelable` `int` `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR`

Descriptor bit used with `https://developer.android.com/reference/android/os/Parcelable#describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor.
`int` `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`

Flag for use with `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`".

| ### Fields ||
|---|---|
| ` public static final https://developer.android.com/reference/android/os/Parcelable.Creator<https://developer.android.com/reference/android/app/usage/UsageEventsQuery>` | `https://developer.android.com/reference/android/app/usage/UsageEventsQuery#CREATOR` <br /> |

| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/android/app/usage/UsageEventsQuery#describeContents()() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| ` long` | ` https://developer.android.com/reference/android/app/usage/UsageEventsQuery#getBeginTimeMillis()() ` Returns the inclusive timestamp to indicate the beginning of the range of events. |
| ` long` | ` https://developer.android.com/reference/android/app/usage/UsageEventsQuery#getEndTimeMillis()() ` Returns the exclusive timestamp to indicate the end of the range of events. |
| ` int[]` | ` https://developer.android.com/reference/android/app/usage/UsageEventsQuery#getEventTypes()() ` Retrieves the usage event types for the query. |
| ` https://developer.android.com/reference/java/util/Set<https://developer.android.com/reference/java/lang/String>` | ` https://developer.android.com/reference/android/app/usage/UsageEventsQuery#getPackageNames()() ` Retrieves a `Set` of package names for the query. |
| ` void` | ` https://developer.android.com/reference/android/app/usage/UsageEventsQuery#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) ` Flatten this object in to a Parcel. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
From interface ` https://developer.android.com/reference/android/os/Parcelable ` ` abstract int` ` https://developer.android.com/reference/android/os/Parcelable#describeContents()() `

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
` abstract void` ` https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) `

Flatten this object in to a Parcel.

## Fields

### CREATOR

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final Creator<UsageEventsQuery> CREATOR
```

<br />

<br />

## Public methods

### describeContents

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
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 `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`, the return value of this method must include the `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` bit.

<br />

| Returns ||
|---|---|
| `int` | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or - `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` |

### getBeginTimeMillis

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public long getBeginTimeMillis ()
```

Returns the inclusive timestamp to indicate the beginning of the range of events. Defined in terms of "Unix time", see `https://developer.android.com/reference/java/lang/System#currentTimeMillis()`.   

Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z.

<br />

| Returns ||
|---|---|
| `long` | Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z. <br /> |

### getEndTimeMillis

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public long getEndTimeMillis ()
```

Returns the exclusive timestamp to indicate the end of the range of events. Defined in terms of "Unix time", see `https://developer.android.com/reference/java/lang/System#currentTimeMillis()`.   

Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z.

<br />

| Returns ||
|---|---|
| `long` | Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z. <br /> |

### getEventTypes

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int[] getEventTypes ()
```

Retrieves the usage event types for the query.

Note that an empty array indicates querying all usage event types, and it may cause additional system overhead when calling `https://developer.android.com/reference/android/app/usage/UsageStatsManager#queryEvents(android.app.usage.UsageEventsQuery)`. Apps are encouraged to provide a list of event types via `https://developer.android.com/reference/android/app/usage/UsageEventsQuery.Builder#setEventTypes(int[])`

<br />

<br />

| Returns ||
|---|---|
| `int[]` | an array contains the usage event types that was previously set using `https://developer.android.com/reference/android/app/usage/UsageEventsQuery.Builder#setEventTypes(int[])` or an empty array if no value has been set. This value cannot be `null`. Value is one of the following: - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#NONE` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#ACTIVITY_RESUMED` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#ACTIVITY_PAUSED` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#CONFIGURATION_CHANGE` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#USER_INTERACTION` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#SHORTCUT_INVOCATION` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#STANDBY_BUCKET_CHANGED` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#SCREEN_INTERACTIVE` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#SCREEN_NON_INTERACTIVE` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#KEYGUARD_SHOWN` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#KEYGUARD_HIDDEN` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#FOREGROUND_SERVICE_START` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#FOREGROUND_SERVICE_STOP` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#ACTIVITY_STOPPED` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#DEVICE_SHUTDOWN` - `https://developer.android.com/reference/android/app/usage/UsageEvents.Event#DEVICE_STARTUP` |

### getPackageNames

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Set<String> getPackageNames ()
```

Retrieves a `Set` of package names for the query.

Note that an empty set indicates querying usage events for all packages, and it may cause additional system overhead when calling `https://developer.android.com/reference/android/app/usage/UsageStatsManager#queryEvents(android.app.usage.UsageEventsQuery)`. Apps are encouraged to provide a list of package names via `https://developer.android.com/reference/android/app/usage/UsageEventsQuery.Builder#setPackageNames(java.lang.String[])`

<br />

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/Set<https://developer.android.com/reference/java/lang/String>` | a `Set` contains the package names that was previously set through `https://developer.android.com/reference/android/app/usage/UsageEventsQuery.Builder#setPackageNames(java.lang.String[])` or an empty set if no value has been set. This value cannot be `null`. <br /> |

### writeToParcel

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void writeToParcel (Parcel dest, 
                int flags)
```

Flatten this object in to a Parcel.

<br />

| Parameters ||
|---|---|
| `dest` | `Parcel`: This value cannot be `null`. <br /> |
| `flags` | `int`: Additional flags about how the object should be written. May be 0 or `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE` |