DataStoreVersionInfo

概览

字段	值
Kind	Data · 数据 Data
Realm	server

DataStoreVersionInfo 是 DataStore:ListVersionsAsync 返回的历史版本条目，包含版本创建时间、版本号和删除状态。

适用场景

服务端列出某个 key 的历史版本时，读取 DataStoreVersionInfo 条目用于版本列表、审计或回滚前确认。

使用要点

先通过 DataStore:ListVersionsAsync 获得 DataStoreVersionInfoPages，再从 pages:GetCurrentPage() 返回的数组中读取 DataStoreVersionInfo 条目。

注意事项

该类型不可直接构造，禁止使用 DataStoreVersionInfo.New() 或 DataStoreVersionInfo()，只能由版本列表分页迭代产生。三个字段均为只读，读取版本内容或删除版本时都应以返回的 Version 字符串原样传入，不要自行拼装版本号。版本列表接口存在调用频率约束，建议一次取回后在本地缓存复用，避免反复请求。

代码示例

读取历史版本条目

-- @runtime server
local DataStoreService = game:GetService('DataStoreService')
local Task = game:GetService('Task')
local dataStore = DataStoreService:GetDataStore('PlayerData', 'global')

Task:Spawn(function()
    local pages = dataStore:ListVersionsAsync('player_1001', false, 0, 0, 10)
    for _, versionInfo in ipairs(pages:GetCurrentPage()) do
        print(versionInfo.Version, versionInfo.CreatedTime, versionInfo.IsDeleted)
    end
end)

属性 (3)

Name	类型	默认值	说明
CreatedTime	Int	0	CreatedTime 是 DataStoreVersionInfo 上的一个只读整型属性，用于表示该数据存储版本对应的创建时间（毫秒时间戳）。它属于版本信息的一部分，随版本信息实例一起从数据存储相关接口返回。
Version	String	""	Version 是 DataStoreVersionInfo 上的一个只读字符串属性，保存该数据存储版本的版本号。版本信息实例由数据存储相关接口返回，版本号随实例一并给出，用于唯一标识某个版本。
IsDeleted	Bool	false	IsDeleted 是 DataStoreVersionInfo 上的一个只读布尔属性，用于标记该数据存储版本是否处于已删除状态。版本信息实例由数据存储相关接口返回，IsDeleted 随实例一同给出。