---
title: "system.user.getScheduledUsers"
description: "Returns a list of users that are scheduled."
---

# system.user.getScheduledUsers

> Returns a list of users that are scheduled.

This function is used in **Python Scripting**.

## Description
Returns a list of users that are scheduled. If no users are scheduled, it will return an empty list.

## Client Permission Restrictions
This scripting function has no [Client Permission](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.user.getScheduledUsers(userSource, [date])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `userSource` | The name of the user source to check for scheduled users.
Date| `date` | The date to check schedules for. May be a Java Date or Unix Time in ms. If omitted, the current date and time will be used. [optional]

### Returns
**List** - List of all users (as [User](https://sdk.inductiveautomation.com/javadoc/ignition83/latest/com/inductiveautomation/ignition/common/user/User.html) objects) scheduled for the given date, taking schedule adjustments into account. Refer also to the [PyUser](https://sdk.inductiveautomation.com/javadoc/ignition83/latest/com/inductiveautomation/ignition/common/user/PyUser.html) class.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Example #1"
# Get all users scheduled for the date specified in a popup calendar and print their names.
 
date = event.source.parent.getComponent('Popup Calendar').date
users = system.user.getScheduledUsers("default", date)
 
if users == None:
    print "No users scheduled"
else:
    print "Scheduled users:"
    for user in users:
        print user.get(user.Username)
```