关于Meria API字段含义及时间格式转换的技术问询

示例API返回数据 #

{
    "success": true,
    "data": {
        "currencyCode": "KAVA",
        "amount": 75,
        "reward": 0.01027898,
        "lockedReward": 0,
        "startDate": 1590582716,
        "variations": [
            {
                "amount": 75,
                "date": 1590582716,
                "effectiveDate": 1590669116,
                "applied": 1
            }
        ],
        "credits": [
            {
                "amount": 0.00432936,
                "date": 1590710400,
                "releaseDate": false,
                "released": 1
            },
            {
                "amount": 0.00594962,
                "date": 1590624000,
                "releaseDate": false,
                "released": 1
            }
        ]
    }
}

问题与解答 #

1. 顶层信息中的lockedReward字段代表什么含义？ #

• lockedReward指尚未解锁、暂时无法提取或使用的奖励额度，这类奖励通常附带有解锁条件（如锁定期届满、完成指定任务等）。示例中该值为0，说明当前无锁定状态的奖励。

2. 猜测variations数组中的date字段为起始日期，effectiveDate字段为实际生效日期（至少是API调用时的日期），该猜测是否正确？ #

• 该猜测基本准确。date一般是变更操作的发起日期（比如提交质押、调整额度的时间），effectiveDate是该变更实际生效并开始影响账户收益或状态的日期。示例中两个时间戳间隔约1天，符合常见的生效延迟规则。

3. credits数组中的releaseDate字段代表什么含义？ #

• releaseDate是该笔奖励的解锁日期时间戳，值为false时，说明该笔奖励无锁定期或已直接解锁发放；若为具体时间戳，则表示奖励需到该时间后才能提取。

4. 同数组中的布尔类型字段released代表什么含义？ #

• released用于标记该笔奖励是否已发放至可用账户：值为1（等价于true）表示奖励已发放完成，可正常使用；值为0则表示奖励仍处于待发放或锁定状态。

5. 如何将数据中的时间格式转换为Excel中的字符串格式？ #

• 这些时间戳是秒级Unix时间戳，而非分钟数，Excel有直接转换的简便方法：
  1. 假设时间戳在单元格A1，在空白单元格输入公式：=A1/86400+DATE(1970,1,1)
  2. 按下回车后，将单元格格式设置为目标日期/时间类型（如「yyyy-mm-dd hh:mm:ss」），即可得到可读的日期字符串。
     无需手动指定起始日期计算天数，上述公式直接基于Unix时间戳的标准起始点（1970年1月1日）完成转换。

内容的提问来源于stack exchange，提问作者Pagalom