DataStore

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

无法创建
未复制

请参见 数据存储

概要

方法

继承自GlobalDataStore的方法

方法

属性

方法

GetVersionAsync

暂停

参数

key: string
version: string

返回

GetVersionAtTimeAsync

暂停

参数

key: string
timestamp: number

返回

代码示例

按时间检索 DataStore 版本

local DataStoreService = game:GetService("DataStoreService")
local dataStore = DataStoreService:GetDataStore("DataStore")
local key = "key-123"
function setData(data)
local success, result = pcall(function()
dataStore:SetAsync(key, data)
end)
if not success then
warn(result)
end
end
function getVersionAtTime(timestamp)
local success, result, keyInfo = pcall(function()
return dataStore:GetVersionAtTimeAsync(key, timestamp.UnixTimestampMillis)
end)
if success then
if result == nil then
print("在此时间找不到版本")
else
print(result, keyInfo.Version)
end
else
warn(result)
end
end
-- 之前在 2024/12/02 6:00 UTC 运行
setData("version 1")
-- 之前在 2024/12/02 9:00 UTC 运行
setData("version 2")
-- 打印 "在此时间找不到版本"
local time1 = DateTime.fromUniversalTime(2024, 12, 02, 05, 00)
getVersionAtTime(time1)
-- 打印 "version 1 <version>"
local time2 = DateTime.fromUniversalTime(2024, 12, 02, 07, 00)
getVersionAtTime(time2)
-- 打印 "version 2 <version>"
local time3 = DateTime.fromUniversalTime(2024, 12, 02, 10, 00)
getVersionAtTime(time3)

ListKeysAsync

暂停

参数

prefix: string
pageSize: number
默认值:0
cursor: string
excludeDeleted: boolean
默认值:false

返回

ListVersionsAsync

暂停

参数

key: string
sortDirection: Enum.SortDirection
默认值:"Ascending"
minDate: number
默认值:0
maxDate: number
默认值:0
pageSize: number
默认值:0

返回

代码示例

使用日期过滤器检索数据存储版本

local DataStoreService = game:GetService("DataStoreService")
local experienceStore = DataStoreService:GetDataStore("PlayerExperience")
local time = DateTime.fromUniversalTime(2020, 10, 09, 01, 42)
local listSuccess, pages = pcall(function()
return experienceStore:ListVersionsAsync("User_1234", nil, time.UnixTimestampMillis)
end)
if listSuccess then
local items = pages:GetCurrentPage()
for key, info in pairs(items) do
print("键:", key, "; 版本:", info.Version, "; 创建时间:", info.CreatedTime, "; 已删除:", info.IsDeleted)
end
end

RemoveVersionAsync

()
暂停

参数

key: string
version: string

返回

()

活动