返回从子微秒精度的任意基准时间以秒计时。这个函数对于比较两个事件发生在同一电脑上的时间有用，是最佳选择进行测试。

  与 `Library.os.time()` 或 `Datatype.DateTime.now()` 等函数不同，调整系统时钟 (例如通过用户或 [NTP](https://en.wikipedia.org/wiki/Network_Time_Protocol)) 不会导致时间向前或向后跳转。

  ```lua
  -- 记录初始时间：
  local startTime = os.clock()
  -- 做您想要测试性能的事情：
  local a, b = 0, 1
  for _ = 1, 5000000 do
      a, b = b, a
  end
  -- 测量这需要花的时间：
  local deltaTime = os.clock() - startTime
  print("Elapsed time: " .. deltaTime)
  -->  Elapsed time: 0.044425600033719 (actual number may vary)
  ```

os.clock

返回一个随机基准精度为子微秒级的时间，从秒开始。

使用指定的时间/时间信息对给定的 `formatString` 格式，或不提供时，返回 `Library.os.time()` 的值。

  在新工作中避免此函数。 相反，请使用 `Datatype.DateTime` API，这是本地化格式的支持。

  以下特殊符号（基于 C 函数 strrtime）已支持：

  <table>
    <thead>
      <tr>
        <th>指定器</th>
        <th>意义</th>
        <th>示例 <sup>^</sup></th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td>%a</td>
        <td>缩写的周一到周五名称\*</td>
        <td>月</td>
      </tr>

      <tr>
        <td>%A</td>
        <td>全周一至周五名称\*</td>
        <td>星期一</td>
      </tr>

      <tr>
        <td>%b</td>
        <td>缩写月名\*</td>
        <td>2月</td>
      </tr>

      <tr>
        <td>%B</td>
        <td>全月名称\*</td>
        <td>二月</td>
      </tr>

      <tr>
        <td>%c</td>
        <td>日期和时间\*</td>
        <td>周一 2月12日 14:14:35 2024</td>
      </tr>

      <tr>
        <td>%d</td>
        <td>月的第几天</td>
        <td>12</td>
      </tr>

      <tr>
        <td>%H</td>
        <td>使用 24 小时的时钟</td>
        <td>14</td>
      </tr>

      <tr>
        <td>%I</td>
        <td>使用 12 小时的时钟</td>
        <td>02</td>
      </tr>

      <tr>
        <td>%j</td>
        <td>年的第几天</td>
        <td>043</td>
      </tr>

      <tr>
        <td>%m</td>
        <td>月</td>
        <td>02</td>
      </tr>

      <tr>
        <td>%M</td>
        <td>分钟</td>
        <td>14</td>
      </tr>

      <tr>
        <td>%p</td>
        <td>“上午”或“下午”</td>
        <td>下午</td>
      </tr>

      <tr>
        <td>%S</td>
        <td>秒</td>
        <td>35</td>
      </tr>

      <tr>
        <td>%U</td>
        <td>第一周（第一个星期日为第一个星期一）</td>
        <td>06</td>
      </tr>

      <tr>
        <td>%w</td>
        <td>周一到周五</td>
        <td>1</td>
      </tr>

      <tr>
        <td>%W</td>
        <td>周号（第一个星期一为第一天）</td>
        <td>07</td>
      </tr>

      <tr>
        <td>%x</td>
        <td>日期\*</td>
        <td>02/12/24</td>
      </tr>

      <tr>
        <td>%X</td>
        <td>时间\*</td>
        <td>14:14:35</td>
      </tr>

      <tr>
        <td>%</td>
        <td>两位数年</td>
        <td>24</td>
      </tr>

      <tr>
        <td>%</td>
        <td>全年</td>
        <td>2024</td>
      </tr>

      <tr>
        <td>%z</td>
        <td>ISO 8601 从 UTC 在时区（1 分钟 = 1，1 小时 = 100）</td>
        <td>0800</td>
      </tr>

      <tr>
        <td>%Z</td>
        <td>时区名称或缩写 \*</td>
        <td>PST</td>
      </tr>

      <tr>
        <td>%</td>
        <td>% 字符</td>
        <td>%</td>
      </tr>
    </tbody>
  </table>

  \* 此值可以根据当前地区变化。

  ※ 提供的示例为 2024年2月12日（周一） 2:14:35（太平洋标准时间），请使用本地时间“en-us”在太平洋标准时间（PST）运行。

  如果提供的 `formatString` 正确地是 `"*t"` (当地时间) 或 `"!*t"` (UTC 时间)，这个函数将返回一个包含以下组件的字典，其通常可以在上面的特殊符号中找到。

  <table>
    <thead>
      <tr>
        <th>园</th>
        <th>类型</th>
        <th>描述</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td>年</td>
        <td>int</td>
        <td>描述当前时代的当前年度（例子 2017）</td>
      </tr>

      <tr>
        <td>月</td>
        <td>int</td>
        <td>一个数字，数值在 1 和 12 之间（从 1 月开始），描述当前月。</td>
      </tr>

      <tr>
        <td>wday</td>
        <td>int</td>
        <td>一个数字，数值在 1 和 7 之间（从周日开始），描述当前的周一到周六。</td>
      </tr>

      <tr>
        <td>yday</td>
        <td>int</td>
        <td>一个数字，数量 1 到 366 描述我们到达一年的时间。如果是跳年，可能有 366 天。</td>
      </tr>

      <tr>
        <td>天</td>
        <td>int</td>
        <td>一个数量在 1 和 31 之间，描述当前月的当天。</td>
      </tr>

      <tr>
        <td>小时</td>
        <td>int</td>
        <td>一个数字，数值在 1 和 24 之间。描述当前时间的当前时间。</td>
      </tr>

      <tr>
        <td>分</td>
        <td>int</td>
        <td>一个数量在 0 和 59 之间，描述当前时间的小时。</td>
      </tr>

      <tr>
        <td>秒</td>
        <td>int</td>
        <td>一个数量在 0 和 60 之间，描述当前时间的秒。(60 因为函数是描述跳跃秒, 但在实践中可能不会).</td>
      </tr>

      <tr>
        <td>isd</td>
        <td>boolean</td>
        <td>一个描述当前是否启用日光节省时间的Boolean。</td>
      </tr>
    </tbody>
  </table>

os.date

formatString

time

根据给定的时间对给定的字符串进行格式化。

返回从 `t1` 到 `t2` 的时间。 差异是按照假设计时 `t1` 和 1> t21> 正确投射到 4>时间\_t4> 格式。

os.difftime

返回从一个时间到另一个时间的秒数。

返回在 Unix 时代（1970年1月1日，00:00:00）之后，按当前 UTC 时间计算的秒数。如果提供表按照该返回的表格式同样返回，它将返回从那时起的秒数。

  注意，返回时间使用设备的本地时钟。大多数操作系统都会自动同步其本地时间与在线时间服务器，因此在几百毫秒内内容。但是，用户可以轻松禁用同步行为并将系统时间设置为任何他想要的时间; 对于客户端和服务器之间的同步时间，请使用 `Class.Workspace:GetServerTimeNow()` 。

  在新工作中避免此函数。 相反，请使用 `Datatype.DateTime` API，这是本地化格式的支持。

  当您需要精确测量时间中两点之间的时间，例如测试性能时，请使用 `Library.os.clock()` 。

os.time

一个用于描述特定时间的字典表，与 `Library.os.date()` 返回的时间类似。如果未提供，则使用当前 UTC 时间。

返回从 Unix 时代（1970 年 1 月 1 日，00:00:00）开始的时间到达现在的 UTC 时间。

此库提供与时间和日期相关的函数。

Luau

Dictionary

Data Type

RBXScriptSignal

number

字母、数字和符号等的字符串。

string

可以存储多个非零型值的数据类输入，包括 booleans、数字、字符串、函数和其他表。

table

概览

指南

教程

参考

资源

艺术

设计

引擎

虚拟形象

旧版本

云端

此方法是异步的，会返回一个`Operation`对象，该对象表示操作的当前状态。它包含一个端点路径，您可以轮询该路径以获取实际响应和相关的元数据。有关长时间运行操作的更多信息，请参阅[文档]({longRunningOperationsLink})。

以下部分描述了操作完成时提供的响应和元数据对象。

Beta 测试终点已准备好公开使用。可能出现导致功能无法正常运作的更改，但几率极低。

此字段可能在创建资源时被设置，但可能无法在后续请求中修改。

此字段可以在请求中提供，但永远不会包括在答复中。

每个 API 密钥：每个 IP 地址每 {periodInSeconds} 秒有 {maxInPeriod} 次请求

此字段可能被设置为响应，但在请求中将被忽略。

调用此端点需要以下 API 密钥权限。关于生成正确密钥的更多信息，请查看 【管理 API 密钥】({apiKeyReferenceDocLink})。

相对于基础 URL 的路径，下列端点是可用的。

此字符串格式为 [FieldMask](/cloud/reference/types#fieldmask)。

JSON 值可以是 “null”、“boolean”、“string”、“number”、“array” 或 “object”。

若要使用此端点，你的 OAuth 2.0 应用程序需要以下范围。关于如何注册 OAuth 2.0 应用程序的更多信息，请查看【应用程序注册及评价】({oauth2ReferenceDocLink})。

下列对象描述了接受或返回的有效载荷。请参阅每个单独的端点，以了解更多关于这些对象用途的信息。

这将允许查看关于你素材的信息。

这将允许在 Roblox 上传或更新素材。

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

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 manage community join requests and role updates for your account.

这将允许查看你的道具栏信息。

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow 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.

授予代替用户发布信息的权力。

This allows sending notifications from your experience to users.

这将允许列出与你的作品相关联的密钥。

这将允许创作和更新与你的作品相关联的密钥。

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

此操作将会允许发布作品的新版本至 Roblox。

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

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

This allows you to view a user's social accounts.

默认值：{defaultValueStart}{defaultValueEnd}

数组是一个有序的数值列表。数组有助于存储数据集。

一组键值对，键值可以是任意数字、字符串或对象。

正如{tuples}一样，是一系列的值。

此函数将在可能是立即返回，但在返回值之前可以暂停调用自己的线程。

Roblox 已不再支持或维护{nameStart}名称{nameEnd}。

Roblox 已不再支持或维护这项数学运算。

此成员未在对象浏览器中出现，不应广泛使用。

此成员只能通过命令行访问。从脚本尝试访问此成员将导致错误。

此函数无法暂停调用自己的 Lua 线程。

从脚本尝试访问此成员将导致错误。你可能可以从 Roblox Studio 的属性窗口访问。

此成员不在 Roblox Studio 的对象浏览器中。

你无法使用 Instance.new 构造器创建此类别的实例。

Roblox 不会在跨服务器与客户机界限而复制此成员。

Lua 编程码无法访问此成员。你可能可以从 Roblox Studio 的属性窗口更改其值。

此会员可以从 OpenCloud Luau 执行任务访问。

此对象的复制行为取决于拥有它的玩家。

此成员可以通过命令行和插件访问。从脚本尝试访问此成员将导致错误。

此成员为只读。尝试写入此成员将会导致错误。

此属性为只读，可以从未同步的线程读取。尝试写入可能会导致错误。

只有 Roblox CoreScript 可以访问此成员，Players 不可用。

你可以安全地从多线程对此属性进行读写。

此类别为顶级类单例。使用 GetService 函数获取此类别的实例。

多线程可以写入此属性，所以从未同步的线程读取将会有风险。

此函数在返回借过前将会暂停调用自己的的线程。此操作不会中断其他脚本。

在一处集中并方便地管理并分析你的全部体验。

使用为全部创作者设计的学习文档和资源

通过指南、教程和代码示例学习如何打造 Roblox 体验。

使用我们一体化的集成开发环境 Studio，打造你的专属体验并部署至多种设备。

Dependable ways to offer value over time to your audience

在 Roblox 上发行广告可以吸引全球观众，为你的内容带来更多流量的机会。

Chart your experience's growth and discover opportunities to improve

动画是将动作和动作应用于角色、对象和环境的过程，以创造一种吸引人的动态体验。

Roblox 上几乎所有内容都是以云为基础的素材，拥有独特的 ID。

创建虚拟形象道具并发布至商城

Sorted by highest revenue over the last 7 days

Learn about what you can make and sell on the marketplace

每个 Roblox 用户都由一个可自定义的角色来代表，这个角色叫做虚拟形象。

Learn basic modeling techniques in blender

Find models, scripts, and plugins made by other creators

角色模型需要一组特定的组件和配置标准，以确保所有虚拟形象功能都能正常运行。

角色通常是指与世界或其他用户互动的任何模型对象。

Make and sell your first basic clothing item on Roblox

要创造出高质量的游戏体验，你需要具备很多技能，例如建模、脚本编程、用户界面设计和音频制作。

Check out what's trending on the Creator Store

参加其他创作者举办的社区活动

Keep players engaged and monetized with content updates

Captivate your audience with an enjoyable gameplay cycle

Drive engagement and progress with fun, repetitive gameplay

Learn how to create a sliding door without writing any code

Alex shares first-hand experience behind creating the hit experience, JailBreak

Blake found a passion in making realistic, quirky carnival games

The Clemens are the family-owned studio behind hits like The Survival Game

Jasmine is the artist behind some of the most popular avatar items on Marketplace

Jessica is the designer behind imaginative environments like in Alo Yoga

Jenni is the UGC creator and artist behind many popular collaborations

Morphist’s unique style combines cutesy and emo aesthetics

The Riotfall creators travel to find inspiration for their immersive environments

Stephen shares their love of programming tools

Sam shares how they got started designing fashion items that they wish existed

所有用于创建 3D 世界的对象，例如零件和照明

Roblox Studio 提供了集成开发环境（IDE）中常见的许多调试工具。

开发者控制台是在 Studio 中测试或在生产环境中运行时调试经验的工具。

Adding subscriptions to your experience helps build long term relationships with your user base. Enable subscriptions before December 15, 2023, and enjoy 3 months of lower rates.

开始使用 Studio，Roblox 的创作引擎

Add a few lines of code to unlock new dashboards to understand your onboarding and other funnels and track your in-game economy.

EventSequencer 是一个强大的框架，可以让你在一系列有组织的动作和触发器上，实时生成跨服务器的事件和过场动画。

了解如何为你的体验打造时间型事件

Create time-based events for increased discoverability across Roblox. Announce your latest update, highlight an activity, or celebrate a milestone with your players!

了解如果通过体验准则来针对适合你创作的年龄群体。

Gain knowledge and expertise directly from Roblox

Learn how to implement a friend invite reward system

Learn how you can control how your data is used to train AI. {linkStart}Read More{linkEnd}

Easily create custom textures using our AI tools

Use our all-in-one creation engine to build anything you can imagine

PolarCub shares all the tips tricks to make UGC items

Join our incredible cast of creators for a Halloween game jam

支持面部动画的头部部分是一个专门带皮肤的头部网格部件。

Using metrics to understand where you can improve your gameplay

Figure out how to keep them coming back to your game

每个体验都需要以某种方式接收用户输入，以便用户进行交互并查看其环境。

Guide players through their first time playing your experience

“层叠服饰“是一种装扮配件，可以自然地伸展并贴合任何外形和现有的层叠道具。

在 Roblox ，我们相信实践是最好的学习方式。从我们的指南中选择一个，进一步了解平台提供的更多内容。

Get help writing code and answers to your creation questions

借助"照明与音响服务"容器服务，你可以控制和自定义环境效果。

Roblox 用户来自全世界的各种文化背景，说着不同的语言。

This walkthrough covers attachments, beams, and some basic scripting concepts that shows you how to set player health to 0 if they touch something

培养活跃的玩家基础是开发一款成功且经久不衰的游戏的重要部分。

Get started with the performance optimization and troubleshooting tool

MicroProfiler 是 Roblox Studio 和 Roblox Client 中的一种优化工具，可为任务计划程序进程提供详细的时间信息。

Dive deep into frame colors, flame graphs, and more

了解如何使用指标取得更大的成功

Improve the performance of computationally intensive Luau scripts

View your daily benchmarks, insights, and real-time metrics to take {boldStart}{experienceName}{boldEnd} to the next level.

NPC（非玩家角色）可以为体验增加很多深度。

@minty creates an obby live from scratch using suggestions from chat

我们的平台为你提供无以伦比的创作机会。现在就开始探索创作者中心、Roblox Studio 和我们充满活力的创作者社区吧！

我们的平台为你提供无以伦比的创作机会。

Our community of award-winning studios and self-taught creators all started here, just like you. 

A principal environment artist at Roblox covers how and why to use packages

Staff stream about gravity, material properties, and constraints

当用户加入体验时，Roblox 会在数据模型中将其表示为玩家。

插件是一种可以为 Studio 添加额外功能或特性的扩展。

Let's tour PolarCub's UGC Homestore! Also, Temprist shows up.

Roblox 上的促销活动可以吸引全球观众，为你的体验、虚拟形象道具和社交媒体带来客流量和体验感。

Catch up on all the highlights from this year's RDC

了解我们的创作引擎能实现的可能性

R15 人形角色模型（例如构成用户角色的角色）由 15 个单独的网格对象组成。

Make and sell your first basic rigid accessory on Roblox

预览 Roblox 上即将推出的全新功能和产品。

Roblox Studio 是一个一体化集成开发环境，让你创作在 Roblox 上运行的体验。

Studio 的脚本编辑器是 Roblox 编程的主要工具。

脚本可以让你在体验中添加自定义动态行为，为你的用户提供更具有吸引力和沉浸式的互动。

Studio 有许多默认的快捷方式和按键命令，可以让你更快、更轻松地进行开发。

社交功能为玩家提供了与朋友一起游戏以及与其他玩家互动的方式。

创建赞助广告，让你的创作触达更多创作者

Studio 是在 Roblox 上用来创作的全方位工具。立刻试试，发挥你的创意！

Learn how to offer players recurring benefits for a monthly fee

与其他创作者合作，共同发展你的创作体验

地形编辑器让你可以轻松地通过创建、区域和编辑工具来生成和改变地形。

Experiences like {boldStart}{experienceName}{boldEnd} saw an average +8.5% lift in qualified play through rate with personalization.

翻译可以帮助你的创作触达更多样的用户

Tour the new UGC Homestore template with Minty and SCHLEEMPH

Roblox 的用户群在人口统计数据和预期方面都与其他平台不同。

What are they and how you can use them to build

 请先观看一个在 Roblox 上创作的简介视频，并前往 Studio

一站式简便管理和发展你的作品

工作区是一个容器服务，容纳你想要 Roblox 引擎在三维世界渲染的物体。

Staff stream covering parts, meshes, terrain, and lighting

os

概要

职能

职能

clock

返回

date

参数

返回

difftime

参数

返回

time

参数

返回