This library currently serves the purpose of providing information about the
system time under the UTC format. It has been heavily sandboxed from the
standard Lua `Library.os` library and does not allow you to perform any
system-altering operations.


Returns elapsed time in seconds since an arbitrary baseline with
sub-microsecond precision. This function is useful for comparing durations
between two events that occur on the same computer, and is the best option
for benchmarking.

Unlike with functions such as `Library.os.time()` or
`Datatype.DateTime.now()`, adjustments to the system clock (such as by the
user or [NTP](https://en.wikipedia.org/wiki/Network_Time_Protocol)) do not
cause time to jump forwards or backwards.

```lua
-- Record the initial time:
local startTime = os.clock()
-- Do something you want to measure the performance of:
local a, b = 0, 1
for _ = 1, 5000000 do
    a, b = b, a
end
-- Measure amount of time this took:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
-->  Elapsed time: 0.044425600033719 (actual number may vary)
```


os.clock

Returns elapsed time in seconds since an arbitrary baseline with
sub-microsecond precision.


Formats the given `formatString` with date/time information based on the
given time, or if not provided, the value returned by `Library.os.time()`.

This function should be avoided in new work. Instead, use the
`Datatype.DateTime` API, which supports localized formatting.

The following specifiers (based on the C function strftime) are supported:

<table>
  <thead>
    <tr>
      <th>Specifier</th>
      <th>Meaning</th>
      <th>Example<sup>&dagger;</sup></th>
     </tr>
  </thead>
<tbody>
<tr>
  <td><code>%a</code></td>
  <td>Abbreviated weekday name *</td>
  <td>Mon</td>
</tr>
<tr>
  <td><code>%A</code></td>
  <td>Full weekday name *</td>
  <td>Monday</td>
</tr>
<tr>
  <td><code>%b</code></td>
  <td>Abbreviated month name *</td>
  <td>Feb</td>
</tr>
<tr>
  <td><code>%B</code></td>
  <td>Full month name *</td>
  <td>February</td>
</tr>
<tr>
  <td><code>%c</code></td>
  <td>Date and time *</td>
  <td>Mon Feb 12 14:14:35 2024</td>
</tr>
<tr>
  <td><code>%d</code></td>
  <td>Day of the month</td>
  <td>12</td>
</tr>
<tr>
  <td><code>%H</code></td>
  <td>Hour, using 24-hour clock</td>
  <td>14</td>
</tr>
<tr>
  <td><code>%I</code></td>
  <td>Hour, using 12-hour clock</td>
  <td>02</td>
</tr>
<tr>
  <td><code>%j</code></td>
  <td>Day of year</td>
  <td>043</td>
</tr>
<tr>
  <td><code>%m</code></td>
  <td>Month</td>
  <td>02</td>
</tr>
<tr>
  <td><code>%M</code></td>
  <td>Minute</td>
  <td>14</td>
</tr>
<tr>
  <td><code>%p</code></td>
  <td>Either "AM" or "PM"</td>
  <td>PM</td>
</tr>
<tr>
  <td><code>%S</code></td>
  <td>Second</td>
  <td>35</td>
</tr>
<tr>
  <td><code>%U</code></td>
  <td>Week number (first Sunday as the first day of week one)</td>
  <td>06</td>
</tr>
<tr>
  <td><code>%w</code></td>
  <td>Weekday</td>
  <td>1</td>
</tr>
<tr>
  <td><code>%W</code></td>
  <td>Week number (first Monday as the first day of week one)</td>
  <td>07</td>
</tr>
<tr>
  <td><code>%x</code></td>
  <td>Date *</td>
  <td>02/12/24</td>
</tr>
<tr>
  <td><code>%X</code></td>
  <td>Time *</td>
  <td>14:14:35</td>
</tr>
<tr>
  <td><code>%y</code></td>
  <td>Two-digit year</td>
  <td>24</td>
</tr>
<tr>
  <td><code>%Y</code></td>
  <td>Full year</td>
  <td>2024</td>
</tr>
<tr>
  <td><code>%z</code></td>
  <td>ISO 8601 offset from UTC in timezone (1 minute = 1, 1 hour = 100)</td>
  <td>-0800</td>
</tr>
<tr>
  <td><code>%Z</code></td>
  <td>Timezone name or abbreviation *</td>
  <td>PST</td>
</tr>
<tr>
  <td><code>%%</code></td>
  <td>The % character</td>
  <td>%</td>
</tr>
</tbody>
</table>

\* This value can vary depending on the current locale.

&dagger; The example provided is for February 12th, 2024 (Monday) at
2:14:35 PM (14:14:35), run using locale "en-us" in Pacific Standard Time
(PST).

If the provided `formatString` is exactly `"*t"` (local time) or `"!*t"`
(UTC time), this function instead returns a dictionary containing the
following components, which are normally available in the specifiers
above.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
<tbody>
  <tr>
    <td>year</td>
    <td>int</td>
    <td>An integer that describes the current year of the Current Era (ex. 2017)</td>
  </tr>
  <tr>
    <td>month</td>
    <td>int</td>
    <td>An integer between 1 and 12 (starting from January) that describes the current month.</td>
  </tr>
  <tr>
    <td>wday</td>
    <td>int</td>
    <td>An integer between 1 and 7 (starting from Sunday) that describes the current week day.</td>
  </tr>
  <tr>
    <td>yday</td>
    <td>int</td>
    <td>An integer between 1 and 366 describing how many days we are into the year.<br />There can be 366 days if it is a leap year.</td>
  </tr>
  <tr>
    <td>day</td>
    <td>int</td>
    <td>An integer between 1 and 31 describing the current day of the month.</td>
  </tr>
  <tr>
    <td>hour</td>
    <td>int</td>
    <td>An integer between 1 and 24 describing the current hour of the day.</td>
  </tr>
  <tr>
    <td>min</td>
    <td>int</td>
    <td>An integer between 0 and 59 describing the current minute of the hour.</td>
  </tr>
  <tr>
    <td>sec</td>
    <td>int</td>
    <td>An integer between 0 and 60 describing the current second of the hour.<br />(60 because the function is described to indicate leap seconds, but in practice it probably doesn't).</td>
  </tr>
  <tr>
    <td>isdst</td>
    <td>bool</td>
    <td>A boolean describing if daylight savings time is currently active.</td>
  </tr>
</tbody>
</table>


os.date

formatString

time

Formats the given string with date/time information based on the given
time.


Returns the number of seconds from `t1` to `t2`. The difference is
computed assuming that `t1` and `t2` are correctly casted to the
[time_t](http://en.cppreference.com/w/cpp/chrono/c/time_t) format.


os.difftime

Returns the number of seconds from one time to another.


Returns how many seconds have passed since the Unix epoch (1 January 1970,
00:00:00), under current UTC time. If provided a table formatted similarly
to that returned by `Library.os.date()`, it returns the number of seconds
from the Unix epoch to that time instead.

Note that the returned time uses the device's local clock. Most operating
systems automatically sync their local time against online time servers,
so this should be within a few hundred milliseconds. However, users can
easily disable sync behavior and set the system time to anything they
want; for synchronized time between client and server, use
`Class.Workspace:GetServerTimeNow()` instead.

This function should be avoided in new work. Instead, use the
`Datatype.DateTime` API, which supports localized formatting.

When you need to precisely measure the time elapsed between two points in
time, like when testing performance, use `Library.os.clock()` instead.


os.time

A dictionary table describing a specific time, similar to that
returned by `Library.os.date()`. If not provided, uses the current UTC
time.


Returns how many seconds have passed since the Unix epoch (1 January 1970,
00:00:00) under current UTC time.


This library provides functions related to time and date.


Luau

Dictionary

An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

A double-precision floating-point number.

number

A sequence of characters, such as letters, numbers, and symbols.

string

Data type which can store multiple values of any non-nil type, including booleans, numbers, strings, functions, and other tables.

table

Experiences

Avatar

Assets

Samples and projects

Engine API

Open Cloud API

Studio

Analytics

Platform

Tutorials

Creator programs

Education

Courses

Learn

This method is asynchronous and returns an `Operation`, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the [documentation]({longRunningOperationsLink}) on long-running operations for more information.
            
The following sections describe the response and metadata objects that are provided when an operation completes.

Beta endpoints are ready for public use. Breaking changes are possible but rare.

These Open Cloud documentation pages will be removed on March 31, 2026. You will be automatically redirected to the new Open Cloud documentation at that time. {linkStart}Learn more{linkEnd}

These old Open Cloud pages will be removed and redirected on March 31, 2026. {linkStart}Learn more{linkEnd}

Experimental endpoints are ready for public use, but may experience breaking changes occasionally as the API contract is finalized.

This endpoint can be called in-experience through {httpServiceLinkStart}HttpService{httpServiceLinkEnd} with an API key.

This field may be set when creating a resource, but may not be modified by subsequent requests.

These fields may be set when creating a resource, but may not be modified by subsequent requests.

This field may be provided in requests, but will never be included in responses.

Legacy authentication method. Always prefer using API Key or OAuth 2.0 when available.

Per API Key: {maxInPeriod} requests every {periodInSeconds} seconds per IP Address

Requires no authentication to call. Typically has significantly lowered rate limits. Always prefer using API Key or OAuth 2.0 when available.

For each grouping, only one of the following fields in the schema has to be provided, the remaining can be excluded.

You can opt back in at any time. {linkStart}Provide feedback.{linkEnd}

You are viewing the old docs. {linkStart}Provide feedback.{linkEnd}

You can opt out at any time and be redirected back to the old reference pages. {linkStart}Provide feedback.{linkEnd}

You are viewing the revamped docs. {linkStart}Provide feedback.{linkEnd}

This field may be set on responses, but will be ignored in requests.

Note: Rate limits can be lower during high-traffic periods. Certain endpoints have additional rate limits. [Learn more about rate limits]({link}).

{limit} requests per day across all API keys for a user or group

{limit} requests per hour across all API keys for a user or group

{limit} requests per minute across all API keys for a user or group

{limit} requests per second across all API keys for a user or group

{limit} requests per minute per API key owner

{limit} request(s) per second per API key owner

Scopes control what permissions your credentials have. Your credentials can only access the endpoints supported by the scopes you selected.

Stable endpoints are production-ready and will almost never experience breaking changes during their lifetime.

This target enables you to limit your key's access to selected {requiredParts}

This target enables you to limit your key's access to selected {requiredParts} and {optionalParts}

Target types are used to restrict the resources that your credentials have permissions on. Only the selected resources can be acted on even if your account has permissions on additional resources. Some scopes do not have target parts. In these cases, all of your relevant resources can be acted on.

The universe Top Level Part does not need to be selected for user-owned API Keys. In this case, your API Key will have access to all of your user-owned experiences and group-owned experiences that you have the right group permissions on.

Try It Out is not yet supported for endpoints requiring API key or OAuth 2.0 authentication

Cookie authentication is disabled for high risk operations for safety.

Critical risk endpoints are extremely sensitive and Try It Out is disabled for safety

Note: Authentication headers are not included in this code sample. You may need to add an authentication header for this command to work.

This is a high risk endpoint that can modify or delete critical data. Use extreme caution when testing.

This API endpoint has been classified as HIGH RISK and may affect live data or user accounts.

Authenticated requests to high-risk APIs can make changes that cannot be undone. Please review your request parameters carefully before proceeding.

Please login to use cookie authentication

This is a low risk endpoint that retrieves data. This is generally safe to test.

This is a medium risk endpoint that modifies data. Test carefully with non-critical accounts, as changes may be permanent.

To keep your account safe, never paste text here from other sources or send information from this page to others.

You are about to test live API endpoints using your actual account credentials.

Only proceed if you understand the implications of the API calls you're about to make. Review the API documentation carefully before testing.

API calls will be made using your authenticated session

These are real API calls that may affect your account or data

Rate limits and other API restrictions apply

Some operations may modify or delete data

This endpoint has been superseded by these recommended alternative endpoints:

The following scopes are required to call this endpoint. For more
information on generating proper keys, see [Manage API keys]({apiKeyReferenceDocLink}).

For more information on generating keys, see [Manage API keys]({apiKeyReferenceDocLink}).

The following endpoints are available at paths relative to the base URL.

This string is formatted as a [FieldMask](/cloud/reference/types#fieldmask).

A JSON value can be `null`, `boolean`, `string`, `number`, `array`, or `object`.

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App registration and review]({oauth2ReferenceDocLink}).

For more information on how to register an OAuth 2.0 application, see [App registration and review]({oauth2ReferenceDocLink}).

The following objects describe payloads that are accepted or returned. See each individual endpoint for more information on when these objects are used.

The following scopes are required to call this endpoint.

Resource Paths

This string is formatted as a [Timestamp](/cloud/reference/types#timestamp).

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App Registration and Review]({oauth2ReferenceDocLink}).

Not Recommended

You are viewing the revamped Open Cloud reference.

You've opted out of the new Open Cloud reference.

View your ad campaigns and their performance.

Create, update, and manage your ad campaigns.

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

This allows viewing asset permissions for subjects (including groups and experiences) and assets your account has access to.

This allows granting asset permissions to any subjects (including groups and experiences) and assets your account has access to.

This allows you to view the status and results of avatar auto-setup jobs on your behalf.

This allows you to create and manage avatar auto-setup jobs on your behalf.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows making changes to your synced commerce items.

This allows viewing information about your commerce merchant connections.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to view information about your Creator Store saves.

This allows you to modify information about your Creator Store saves.

Grants access to create data stores on your behalf.

Grants access to delete data stores on your behalf.

Grants access to read a list of data stores.

Grants access to take a snapshot of your data stores.

Grants access to create entries in your data stores.

Grants access to mark specified entries for deletion.

Grants access to list your data store's entries.

Grants access to read specified entries in your data stores.

Grants access to update the value, attributes, and users of an entry.

Grants access to delete revisions of your data store's entries.

Grants access to list revisions for your data store's entries.

Grants access to read revisions of your data store's entries.

Grants access to view configuration details for the authorized user's developer products.

Grants access to edit the authorized user's developer products.

This allows viewing information about your universe's environments.

This allows editing of your universe's environments.

Grants access to view configuration details for the authorized user's game passes.

Grants access to edit the authorized user's game passes.

Grants access to view community forums information for your account.

Grants access to manage community forums information for your account.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

Allows you to view an instance's property data.

Allows you to modify the property data of instances (currently only supports Scripts).

This allows viewing information about your inventory.

Grants access to manage your badges and spend Robux.

Grants access to update the authorized user's badges.

Grants access to manage your developer products.

Grants access to read information about the experiences you have notifications on for.

Grants access to turn on or off notifications for experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

Allows you to view the status, logs, and results of Luau execution tasks for the associated place.

Allows you to create new Luau execution tasks for the associated place.

Grants access to asynchronously flush all data structures in the universe.

Grants access to discard read items from the front of the queue.

Grants access to read items at the front of the queue.

Grants access to read your memory store items.

Grants access to create, update, and delete map items.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

(Deprecated) Grants access to read a list of entries in an ordered data store.

(Deprecated) Grants access to create a new entry in an ordered data store.

Grants access to list entries from an ordered data store.

Grants access to create entries in an ordered data store.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

This permission allows you to submit an evaluation job and view the job result.

Grants access to read about your subscription products.

This allows you to read thumbnail information on your behalf.

Grants the ability to read game analytics.

Grants the ability to read place information.

Grants the ability to edit place information.

Grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants access to edit the authorized user's experiences.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

This allows viewing notifications sent to your account.

Grants the ability to read the authorized user's premium and verified status.

This allows you to view the authorized user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.

This function returns immediately if possible, but can yield the thread that called it until it can return a value.

Learn more about {linkStart}capabilities{linkEnd}.

{nameStart}name{nameEnd} is no longer supported or maintained by Roblox.

This endpoint is no longer supported or maintained by Roblox.

This math operation is no longer supported or maintained by Roblox.

This member doesn’t appear in the object browser and is not intended for widespread use.

This member is only accessible only through the command bar. Attempting to access this member from scripts causes an error.

This function can’t pause the Lua thread that called it.

Attempting to access this member in scripts causes an error. You might be able to access this member from Roblox Studio's property window.

This member doesn’t appear in Roblox Studio’s Object Browser.

You can’t create an instance of this class with the Instance.new constructor.

Roblox does not replicate this member across its server-client boundary.

Lua code can’t access this member. You might be able to change its value from the property window in Roblox Studio.

This member is accessible from OpenCloud Luau execution tasks.

This object’s replication behavior is dependent on the player who owns it.

This member is accessible through the command bar and plugins. Attempting to access this member from scripts causes an error.

This member is read only. Attempting to write to this member causes an error.

This property is read-only and is safe to read in unsynchronized threads. Attempting to write to it causes an error.

There are alternative endpoints available that supersede this endpoint.

This member is accessible only in CoreScripts.

Only Roblox CoreScripts can access this member, and it isn’t usable by Players.

You can read and write to this property safely from multiple threads.

This class is a top-level singleton. Retrieve an instance of this class with the GetService function.

Can be accessed within callbacks bound via {link1Start}RunService:BindToSimulation(){link1End}. Participates in rollbacks. See {link2Start}server authority{link2End}.

Multiple threads can potentially write to this property, so it’s unsafe to read from unsynchronized threads.

This function pauses the Lua thread that called it until it returns a result. This doesn’t interrupt other scripts.