Api “的参数命名”;这件事发生后的时间”;

Api “的参数命名”;这件事发生后的时间”;,api,naming-conventions,naming,api-design,iot,Api,Naming Conventions,Naming,Api Design,Iot,我正在构建一个简单的API来使用从小型网络连接传感器/设备(比如arduino、raspberry pi等)发送的数据。我想记录此远程设备上发生事件的合理准确时间戳。由于潜在的连接问题,事件可能不会总是立即发送回服务器。如果可以避免的话,我不想依赖于在设备上同步时钟,因此我将尝试发回一个参数,该参数仅包含事件发生后的秒数。因此,例如,在设备上检测到一个事件,但由于某种原因,它会在5秒钟后发送到服务器。数据将包括一个数字“5”,表示根据设备的内部时钟,这发生在5秒前。然后服务器将获取自己的时钟时间

我正在构建一个简单的API来使用从小型网络连接传感器/设备(比如arduino、raspberry pi等)发送的数据。我想记录此远程设备上发生事件的合理准确时间戳。由于潜在的连接问题,事件可能不会总是立即发送回服务器。如果可以避免的话,我不想依赖于在设备上同步时钟,因此我将尝试发回一个参数,该参数仅包含事件发生后的秒数。因此,例如,在设备上检测到一个事件,但由于某种原因,它会在5秒钟后发送到服务器。数据将包括一个数字“5”,表示根据设备的内部时钟,这发生在5秒前。然后服务器将获取自己的时钟时间,并减去5秒以生成时间戳

我想用一个参数名来描述这个有意义的时间跨度。一些选择可能包括:

  • 时间间隔
  • 很久以前
  • 持续时间自
但是,由于这是一个简单的数字字段,为了更加清晰,我希望名称中包含度量单位,例如:

  • 次级
  • 西米
  • 时间秒
有没有人遇到过这种事情的常见和/或合理的命名约定?事件发生后的时间,以及在何处以及如何在参数名称中指示单位?我的命名想法中没有一个感觉是“正确的”,但这里的一些讨论可能有助于确定一种方法优于另一种方法


谢谢。

我的感觉是,
过了几秒钟
听起来很合理

现在,您正在缓冲这些事件吗?如果它们“每n秒”发生一次,您如何处理丢失的值?我的意思是,你可以为
n
事件缓冲,如果它们没有被传输,你可能会覆盖第一个
n
。当您传输所有缓冲区时,您如何解释丢失的缓冲区?根据具体的应用情况,您可能有兴趣填写当天活动的NaN


这有意义吗?

这很聪明,因为它缓解了不可靠的arduino时钟的时间戳问题,而不是可以NTP同步的Raspberry PI。我会选择一个领域。时间偏移量(
),可以是正的,也可以是负的,记录下来以秒为单位。您的建议很好,可能SecondsPassed或SecondsElapsed会更清晰。我同意把单位包括在内是个好主意;我会把它放在一开始,但我不是以英语为母语的,可能对以英语为母语的人来说,相反的说法更有意义。我不允许负值,除非你预料到设备中可能有时间机器。事实上,如果你想让我注意到流行的干净代码有一个时间机器可以随时弹出,这可能是一个明智的工程实践。但我仍然认为我之前建议的那些更好,在这种情况下。这是另一个,第二个例子